Rename menu context methods from ShowAsContextMenu to Open

Refactored all menu context menu methods and related documentation to use 'Open' and 'OpenAt' instead of 'ShowAsContextMenu' for clarity and consistency. Updated C/C++ APIs, platform-specific implementations, and example usages to reflect the new naming convention.

Author: lijy91

examples/menu_c_example/main.c

@@ -172,14 +172,14 @@ int main() {
     printf("Triggering checkbox item after removing click listener...\n");
     native_menu_item_trigger(checkbox_item);
 
-    // Show menu as context menu (this may not work in console applications)
-    printf("\n=== Attempting to Show Context Menu ===\n");
+    // Open menu as context menu (this may not work in console applications)
+    printf("\n=== Attempting to Open Context Menu ===\n");
     printf("Note: Context menu display may not work in console applications\n");
 
-    if (native_menu_show_as_context_menu(menu, 100, 100)) {
-        printf("Context menu shown successfully\n");
+    if (native_menu_open_at(menu, 100, 100)) {
+        printf("Context menu opened successfully\n");
     } else {
-        printf("Failed to show context menu (expected in console app)\n");
+        printf("Failed to open context menu (expected in console app)\n");
     }
 
     // Test additional functionality

examples/menu_example/main.cpp

@@ -101,15 +101,15 @@ int main() {
         std::cout << "Triggering exit item..." << std::endl;
         exitItem->Trigger();
 
-        // Show menu as context menu (this may not work in console applications)
-        std::cout << "\n=== Attempting to Show Context Menu ===" << std::endl;
+        // Open menu as context menu (this may not work in console applications)
+        std::cout << "\n=== Attempting to Open Context Menu ===" << std::endl;
         std::cout << "Note: Context menu display may not work in console applications" << std::endl;
 
         // Try to show at screen coordinates (100, 100)
-        if (menu->ShowAsContextMenu(100, 100)) {
-            std::cout << "Context menu shown successfully" << std::endl;
+        if (menu->Open(100, 100)) {
+            std::cout << "Context menu opened successfully" << std::endl;
         } else {
-            std::cout << "Failed to show context menu (expected in console app)" << std::endl;
+            std::cout << "Failed to open context menu (expected in console app)" << std::endl;
         }
 
         // Demonstrate submenu

examples/tray_icon_example/main.cpp

@@ -131,7 +131,7 @@ int main() {
     std::cout << "Tray icon example is now running!" << std::endl;
     std::cout << "Try clicking on the tray icon:" << std::endl;
     std::cout << "- Left click: Single click" << std::endl;
-    std::cout << "- Right click: Shows context menu" << std::endl;
+    std::cout << "- Right click: Opens context menu" << std::endl;
     std::cout << "- Double click: Quick double click" << std::endl;
     std::cout << "- Context menu: Right-click to see options including Exit" << std::endl;
     std::cout << "The application will run for 60 seconds, or until you click Exit." << std::endl;

src/capi/menu_c.cpp

@@ -884,25 +884,25 @@ native_menu_item_t native_menu_find_item_by_text(native_menu_t menu,
   }
 }
 
-bool native_menu_show_as_context_menu(native_menu_t menu, double x, double y) {
+bool native_menu_open_at(native_menu_t menu, double x, double y) {
   if (!menu)
     return false;
 
   try {
     auto menu_ptr = static_cast<Menu*>(menu);
-    return menu_ptr->ShowAsContextMenu(x, y);
+    return menu_ptr->Open(x, y);
   } catch (...) {
     return false;
   }
 }
 
-bool native_menu_show_as_context_menu_default(native_menu_t menu) {
+bool native_menu_open(native_menu_t menu) {
   if (!menu)
     return false;
 
   try {
     auto menu_ptr = static_cast<Menu*>(menu);
-    return menu_ptr->ShowAsContextMenu();
+    return menu_ptr->Open();
   } catch (...) {
     return false;
   }

src/capi/menu_c.h

@@ -503,22 +503,22 @@ FFI_PLUGIN_EXPORT
 native_menu_item_t native_menu_find_item_by_text(native_menu_t menu, const char* text);
 
 /**
- * Show the menu as a context menu at specified coordinates
+ * Open the menu as a context menu at specified coordinates
  * @param menu The menu
  * @param x The x-coordinate in screen coordinates
  * @param y The y-coordinate in screen coordinates
- * @return true if menu was shown successfully, false otherwise
+ * @return true if menu was opened successfully, false otherwise
  */
 FFI_PLUGIN_EXPORT
-bool native_menu_show_as_context_menu(native_menu_t menu, double x, double y);
+bool native_menu_open_at(native_menu_t menu, double x, double y);
 
 /**
- * Show the menu as a context menu at default location
+ * Open the menu as a context menu at default location
  * @param menu The menu
- * @return true if menu was shown successfully, false otherwise
+ * @return true if menu was opened successfully, false otherwise
  */
 FFI_PLUGIN_EXPORT
-bool native_menu_show_as_context_menu_default(native_menu_t menu);
+bool native_menu_open(native_menu_t menu);
 
 /**
  * Close the menu if it's currently showing

src/menu.h

@@ -544,8 +544,8 @@ class MenuItem : public EventEmitter, public NativeObjectProvider {
  *     std::cout << "Menu opened" << std::endl;
  * });
  *
- * // Show as context menu
- * fileMenu->ShowAsContextMenu(100, 100);
+ * // Open as context menu
+ * fileMenu->Open(100, 100);
  * ```
  */
 class Menu : public EventEmitter, public NativeObjectProvider {
@@ -721,26 +721,26 @@ class Menu : public EventEmitter, public NativeObjectProvider {
    * Shows the menu at the given position and waits for user interaction.
    * The menu will close when the user clicks outside of it or selects an item.
    *
-   * @param x The x-coordinate in screen coordinates where to show the menu
-   * @param y The y-coordinate in screen coordinates where to show the menu
-   * @return true if the menu was successfully shown, false otherwise
+   * @param x The x-coordinate in screen coordinates where to open the menu
+   * @param y The y-coordinate in screen coordinates where to open the menu
+   * @return true if the menu was successfully opened, false otherwise
    *
    * @example
    * ```cpp
-   * // Show context menu at cursor position
-   * menu->ShowAsContextMenu(mouse_x, mouse_y);
+   * // Open context menu at cursor position
+   * menu->Open(mouse_x, mouse_y);
    * ```
    */
-  bool ShowAsContextMenu(double x, double y);
+  bool Open(double x, double y);
 
   /**
    * @brief Display the menu as a context menu at the current cursor position.
    *
    * Shows the menu at the current mouse cursor location.
    *
-   * @return true if the menu was successfully shown, false otherwise
+   * @return true if the menu was successfully opened, false otherwise
    */
-  bool ShowAsContextMenu();
+  bool Open();
 
   /**
    * @brief Programmatically close the menu if it's currently showing.

src/platform/linux/menu_linux.cpp

@@ -373,7 +373,7 @@ std::shared_ptr<MenuItem> Menu::FindItemByText(const std::string& text, bool cas
   return nullptr;
 }
 
-bool Menu::ShowAsContextMenu(double x, double y) {
+bool Menu::Open(double x, double y) {
   if (pimpl_->gtk_menu_) {
     pimpl_->visible_ = true;
     gtk_menu_popup_at_pointer(GTK_MENU(pimpl_->gtk_menu_), nullptr);
@@ -382,8 +382,8 @@ bool Menu::ShowAsContextMenu(double x, double y) {
   return false;
 }
 
-bool Menu::ShowAsContextMenu() {
-  return ShowAsContextMenu(0, 0); // GTK will position at pointer
+bool Menu::Open() {
+  return Open(0, 0); // GTK will position at pointer
 }
 
 bool Menu::Close() {

src/platform/macos/menu_macos.mm

@@ -579,7 +579,7 @@ - (void)menuDidClose:(NSMenu *)menu {
     return nullptr;
 }
 
-bool Menu::ShowAsContextMenu(double x, double y) {
+bool Menu::Open(double x, double y) {
     NSPoint point = NSMakePoint(x, y);
 
     // Convert screen coordinates to window coordinates if needed
@@ -606,9 +606,9 @@ - (void)menuDidClose:(NSMenu *)menu {
     return true;
 }
 
-bool Menu::ShowAsContextMenu() {
+bool Menu::Open() {
     NSPoint mouseLocation = [NSEvent mouseLocation];
-    return ShowAsContextMenu(mouseLocation.x, mouseLocation.y);
+    return Open(mouseLocation.x, mouseLocation.y);
 }
 
 bool Menu::Close() {

src/platform/macos/tray_icon_macos.mm

@@ -255,7 +255,7 @@ @interface TrayIconMenuDelegate : NSObject <NSMenuDelegate>
   }
 
   // Open the context menu at the specified coordinates
-  return pimpl_->context_menu_->ShowAsContextMenu(x, y);
+  return pimpl_->context_menu_->Open(x, y);
 }
 
 bool TrayIcon::OpenContextMenu() {

src/platform/windows/menu_windows.cpp

@@ -529,7 +529,7 @@ std::shared_ptr<MenuItem> Menu::FindItemByText(const std::string& text,
   return nullptr;
 }
 
-bool Menu::ShowAsContextMenu(double x, double y) {
+bool Menu::Open(double x, double y) {
   pimpl_->visible_ = true;
 
   POINT pt = {static_cast<int>(x), static_cast<int>(y)};
@@ -545,10 +545,10 @@ bool Menu::ShowAsContextMenu(double x, double y) {
   return true;
 }
 
-bool Menu::ShowAsContextMenu() {
+bool Menu::Open() {
   POINT pt;
   GetCursorPos(&pt);
-  return ShowAsContextMenu(pt.x, pt.y);
+  return Open(pt.x, pt.y);
 }
 
 bool Menu::Close() {