Add title bar style API to window abstraction

Introduces TitleBarStyle enum and related methods to set and get window title bar style across platforms. Updates C API to expose title bar style control, adds implementation for Linux, macOS, and Windows, and stubs for Android, iOS, and OHOS. Refactors window creation in C API and updates examples to demonstrate title bar toggling via context menu.

Author: lijy91

examples/application_c_example/main.c

@@ -48,7 +48,7 @@ int main() {
   }
 
   // Create a simple window with default settings
-  native_window_t window = native_window_manager_create();
+  native_window_t window = native_window_create();
   if (!window) {
     fprintf(stderr, "Failed to create window\n");
     return 1;

examples/window_c_example/main.c

@@ -58,6 +58,19 @@ void on_hide_window_clicked(const void* event, void* user_data) {
   }
 }
 
+void on_toggle_title_bar_clicked(const void* event, void* user_data) {
+  printf("Toggle Title Bar clicked from context menu\n");
+  if (g_window) {
+    native_title_bar_style_t current_style = native_window_get_title_bar_style(g_window);
+    native_title_bar_style_t new_style = (current_style == NATIVE_TITLE_BAR_STYLE_HIDDEN)
+                                             ? NATIVE_TITLE_BAR_STYLE_NORMAL
+                                             : NATIVE_TITLE_BAR_STYLE_HIDDEN;
+    native_window_set_title_bar_style(g_window, new_style);
+    printf("Title bar style changed to: %s\n",
+           (new_style == NATIVE_TITLE_BAR_STYLE_HIDDEN) ? "Hidden" : "Normal");
+  }
+}
+
 void on_about_clicked(const void* event, void* user_data) {
   printf("About clicked from context menu\n");
   printf("Window Example v1.0 - Native API Demo\n");
@@ -187,6 +200,13 @@ native_menu_t create_context_menu(void) {
                                 on_hide_window_clicked, NULL);
   native_menu_add_item(context_menu, hide_window_item);
 
+  // Add Toggle Title Bar item
+  native_menu_item_t toggle_title_bar_item =
+      native_menu_item_create("Toggle Title Bar", NATIVE_MENU_ITEM_TYPE_NORMAL);
+  native_menu_item_add_listener(toggle_title_bar_item, NATIVE_MENU_ITEM_EVENT_CLICKED,
+                                on_toggle_title_bar_clicked, NULL);
+  native_menu_add_item(context_menu, toggle_title_bar_item);
+
   // Add separator
   native_menu_add_separator(context_menu);
 
@@ -309,7 +329,7 @@ native_menu_t create_context_menu(void) {
 
 int main() {
   // Create a new window with default settings
-  g_window = native_window_manager_create();
+  g_window = native_window_create();
 
   // Configure the window
   native_window_set_title(g_window, "Window Example");
@@ -381,6 +401,9 @@ int main() {
     // Set the context menu to the tray icon
     native_tray_icon_set_context_menu(g_tray_icon, g_context_menu);
 
+    // Set context menu to trigger on left click
+    native_tray_icon_set_context_menu_trigger(g_tray_icon, NATIVE_CONTEXT_MENU_TRIGGER_CLICKED);
+
     // Set up event listeners
     native_tray_icon_add_listener(g_tray_icon, NATIVE_TRAY_ICON_EVENT_CLICKED, on_tray_icon_clicked,
                                   NULL);

examples/window_example/main.cpp

@@ -281,14 +281,13 @@ int main() {
 
     // Add exit item
     auto exit_item = std::make_shared<MenuItem>("Exit", MenuItemType::Normal);
-    exit_item->AddListener<MenuItemClickedEvent>(
-        [window_ptr](const MenuItemClickedEvent& event) {
-          std::cout << "Exit clicked from context menu" << std::endl;
-          // Close the window to trigger app exit
-          if (window_ptr) {
-            window_ptr->Hide();
-          }
-        });
+    exit_item->AddListener<MenuItemClickedEvent>([window_ptr](const MenuItemClickedEvent& event) {
+      std::cout << "Exit clicked from context menu" << std::endl;
+      // Close the window to trigger app exit
+      if (window_ptr) {
+        window_ptr->Hide();
+      }
+    });
     context_menu->AddItem(exit_item);
 
     // Set the context menu to the tray icon

src/capi/positioning_strategy_c.h

@@ -73,7 +73,7 @@ native_positioning_strategy_t native_positioning_strategy_relative(const native_
  *
  * @example
  * ```c
- * native_window_t window = native_window_manager_create(&options);
+ * native_window_t window = native_window_create();
  * native_point_t offset = {0, 10};
  * native_positioning_strategy_t strategy = native_positioning_strategy_relative_to_window(window,
  * &offset); native_menu_open(menu, strategy); native_positioning_strategy_free(strategy);

src/capi/window_c.cpp

@@ -1,10 +1,81 @@
 #include "window_c.h"
 #include <cstring>
+#include <memory>
+#include <mutex>
+#include <unordered_map>
 #include "../window.h"
 #include "string_utils_c.h"
 
 using namespace nativeapi;
 
+// Internal registry to manage window lifetimes for C API
+// This keeps shared_ptr alive while C code holds the handle
+namespace {
+std::mutex g_windows_mutex;
+std::unordered_map<WindowId, std::shared_ptr<Window>> g_windows;
+}  // namespace
+
+// Window creation and destruction
+FFI_PLUGIN_EXPORT
+native_window_t native_window_create(void) {
+  try {
+    // Create window with default settings
+    auto window = std::make_shared<Window>();
+
+    // Store in internal registry to keep it alive
+    {
+      std::lock_guard<std::mutex> lock(g_windows_mutex);
+      g_windows[window->GetId()] = window;
+    }
+
+    // Return raw pointer (internal registry holds the shared_ptr)
+    return static_cast<void*>(window.get());
+  } catch (...) {
+    return nullptr;
+  }
+}
+
+FFI_PLUGIN_EXPORT
+native_window_t native_window_create_from_native(void* native_window) {
+  if (!native_window)
+    return nullptr;
+
+  try {
+    // Wrap existing native window
+    auto window = std::make_shared<Window>(native_window);
+
+    // Store in internal registry to keep it alive
+    {
+      std::lock_guard<std::mutex> lock(g_windows_mutex);
+      g_windows[window->GetId()] = window;
+    }
+
+    // Return raw pointer (internal registry holds the shared_ptr)
+    return static_cast<void*>(window.get());
+  } catch (...) {
+    return nullptr;
+  }
+}
+
+FFI_PLUGIN_EXPORT
+void native_window_destroy(native_window_t window) {
+  if (!window)
+    return;
+
+  try {
+    auto* win = static_cast<nativeapi::Window*>(window);
+    WindowId window_id = win->GetId();
+
+    // Remove from internal registry (this will destroy it if no other references exist)
+    {
+      std::lock_guard<std::mutex> lock(g_windows_mutex);
+      g_windows.erase(window_id);
+    }
+  } catch (...) {
+    // Silently fail
+  }
+}
+
 // Window basic operations
 FFI_PLUGIN_EXPORT
 native_window_id_t native_window_get_id(native_window_t window) {
@@ -443,6 +514,36 @@ char* native_window_get_title(native_window_t window) {
   }
 }
 
+FFI_PLUGIN_EXPORT
+void native_window_set_title_bar_style(native_window_t window, native_title_bar_style_t style) {
+  if (!window)
+    return;
+
+  try {
+    auto* win = static_cast<nativeapi::Window*>(window);
+    TitleBarStyle cpp_style =
+        (style == NATIVE_TITLE_BAR_STYLE_HIDDEN) ? TitleBarStyle::Hidden : TitleBarStyle::Normal;
+    win->SetTitleBarStyle(cpp_style);
+  } catch (...) {
+    // Silently fail
+  }
+}
+
+FFI_PLUGIN_EXPORT
+native_title_bar_style_t native_window_get_title_bar_style(native_window_t window) {
+  if (!window)
+    return NATIVE_TITLE_BAR_STYLE_NORMAL;
+
+  try {
+    auto* win = static_cast<nativeapi::Window*>(window);
+    TitleBarStyle cpp_style = win->GetTitleBarStyle();
+    return (cpp_style == TitleBarStyle::Hidden) ? NATIVE_TITLE_BAR_STYLE_HIDDEN
+                                                : NATIVE_TITLE_BAR_STYLE_NORMAL;
+  } catch (...) {
+    return NATIVE_TITLE_BAR_STYLE_NORMAL;
+  }
+}
+
 FFI_PLUGIN_EXPORT
 void native_window_set_has_shadow(native_window_t window, bool has_shadow) {
   if (!window)

src/capi/window_c.h

@@ -33,6 +33,24 @@ typedef struct {
   long count;
 } native_window_list_t;
 
+/**
+ * Title bar style enumeration
+ */
+typedef enum {
+  NATIVE_TITLE_BAR_STYLE_NORMAL = 0,
+  NATIVE_TITLE_BAR_STYLE_HIDDEN = 1
+} native_title_bar_style_t;
+
+// Window creation and destruction
+FFI_PLUGIN_EXPORT
+native_window_t native_window_create(void);
+
+FFI_PLUGIN_EXPORT
+native_window_t native_window_create_from_native(void* native_window);
+
+FFI_PLUGIN_EXPORT
+void native_window_destroy(native_window_t window);
+
 // Window basic operations
 FFI_PLUGIN_EXPORT
 native_window_id_t native_window_get_id(native_window_t window);
@@ -178,6 +196,12 @@ bool native_window_set_title(native_window_t window, const char* title);
 FFI_PLUGIN_EXPORT
 char* native_window_get_title(native_window_t window);
 
+FFI_PLUGIN_EXPORT
+void native_window_set_title_bar_style(native_window_t window, native_title_bar_style_t style);
+
+FFI_PLUGIN_EXPORT
+native_title_bar_style_t native_window_get_title_bar_style(native_window_t window);
+
 FFI_PLUGIN_EXPORT
 void native_window_set_has_shadow(native_window_t window, bool has_shadow);
 

src/capi/window_manager_c.cpp

@@ -113,17 +113,6 @@ static native_window_will_hide_callback_t g_will_hide_cb = nullptr;
 static void* g_will_hide_ud = nullptr;
 
 // Window manager operations
-FFI_PLUGIN_EXPORT
-native_window_t native_window_manager_create(void) {
-  try {
-    // Create window with default settings (automatically registered)
-    auto window = std::make_shared<Window>();
-    return CreateNativeWindowHandle(window);
-  } catch (...) {
-    return nullptr;
-  }
-}
-
 FFI_PLUGIN_EXPORT
 native_window_t native_window_manager_get(native_window_id_t window_id) {
   try {

src/capi/window_manager_c.h

@@ -53,13 +53,6 @@ typedef void (*native_window_event_callback_t)(const native_window_event_t* even
  * Window manager singleton operations
  */
 
-/**
- * Create a new window with default settings
- * @return Window handle, or NULL if creation failed
- */
-FFI_PLUGIN_EXPORT
-native_window_t native_window_manager_create(void);
-
 /**
  * Get a window by its ID
  * @param window_id The window ID

src/platform/android/window_android.cpp

@@ -292,6 +292,14 @@ std::string Window::GetTitle() const {
   return "";
 }
 
+void Window::SetTitleBarStyle(TitleBarStyle style) {
+  ALOGW("SetTitleBarStyle not supported on Android (use system UI visibility flags)");
+}
+
+TitleBarStyle Window::GetTitleBarStyle() const {
+  return TitleBarStyle::Normal;
+}
+
 void Window::SetHasShadow(bool has_shadow) {
   ALOGW("SetHasShadow not supported on Android");
 }

src/platform/ios/window_ios.mm

@@ -331,6 +331,16 @@
   return "";
 }
 
+void Window::SetTitleBarStyle(TitleBarStyle style) {
+  // iOS doesn't have traditional title bars
+  // Use UIViewController.prefersStatusBarHidden or navigation bar appearance instead
+  NSLog(@"SetTitleBarStyle not applicable on iOS (use status bar or navigation bar APIs)");
+}
+
+TitleBarStyle Window::GetTitleBarStyle() const {
+  return TitleBarStyle::Normal;
+}
+
 void Window::SetHasShadow(bool has_shadow) {
   // iOS manages shadow automatically
 }