|
@@ -21,6 +21,38 @@ Description
|
|
|
|
|
|
**NativeMenu** handles low-level access to the OS native global menu bar and popup menus.
|
|
**NativeMenu** handles low-level access to the OS native global menu bar and popup menus.
|
|
|
|
|
|
|
|
+\ **Note:** This is low-level API, consider using :ref:`MenuBar<class_MenuBar>` with :ref:`MenuBar.prefer_global_menu<class_MenuBar_property_prefer_global_menu>` set to ``true``, and :ref:`PopupMenu<class_PopupMenu>` with :ref:`PopupMenu.prefer_native_menu<class_PopupMenu_property_prefer_native_menu>` set to ``true``.
|
|
|
|
+
|
|
|
|
+To create a menu, use :ref:`create_menu<class_NativeMenu_method_create_menu>`, add menu items using ``add_*_item`` methods. To remove a menu, use :ref:`free_menu<class_NativeMenu_method_free_menu>`.
|
|
|
|
+
|
|
|
|
+::
|
|
|
|
+
|
|
|
|
+ var menu
|
|
|
|
+
|
|
|
|
+ func _menu_callback(item_id):
|
|
|
|
+ if item_id == "ITEM_CUT":
|
|
|
|
+ cut()
|
|
|
|
+ elif item_id == "ITEM_COPY":
|
|
|
|
+ copy()
|
|
|
|
+ elif item_id == "ITEM_PASTE":
|
|
|
|
+ paste()
|
|
|
|
+
|
|
|
|
+ func _enter_tree():
|
|
|
|
+ # Create new menu and add items:
|
|
|
|
+ menu = NativeMenu.create_menu()
|
|
|
|
+ NativeMenu.add_item(menu, "Cut", _menu_callback, Callable(), "ITEM_CUT")
|
|
|
|
+ NativeMenu.add_item(menu, "Copy", _menu_callback, Callable(), "ITEM_COPY")
|
|
|
|
+ NativeMenu.add_separator(menu)
|
|
|
|
+ NativeMenu.add_item(menu, "Paste", _menu_callback, Callable(), "ITEM_PASTE")
|
|
|
|
+
|
|
|
|
+ func _on_button_pressed():
|
|
|
|
+ # Show popup menu at mouse position:
|
|
|
|
+ NativeMenu.popup(menu, DisplayServer.mouse_get_position())
|
|
|
|
+
|
|
|
|
+ func _exit_tree():
|
|
|
|
+ # Remove menu when it's no longer needed:
|
|
|
|
+ NativeMenu.free_menu(menu)
|
|
|
|
+
|
|
.. rst-class:: classref-reftable-group
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
|
|
Methods
|
|
Methods
|
|
@@ -116,6 +148,8 @@ Methods
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`remove_item<class_NativeMenu_method_remove_item>`\ (\ rid\: :ref:`RID<class_RID>`, idx\: :ref:`int<class_int>`\ ) |
|
|
| |void| | :ref:`remove_item<class_NativeMenu_method_remove_item>`\ (\ rid\: :ref:`RID<class_RID>`, idx\: :ref:`int<class_int>`\ ) |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
+ | |void| | :ref:`set_interface_direction<class_NativeMenu_method_set_interface_direction>`\ (\ rid\: :ref:`RID<class_RID>`, is_rtl\: :ref:`bool<class_bool>`\ ) |
|
|
|
|
+ +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`set_item_accelerator<class_NativeMenu_method_set_item_accelerator>`\ (\ rid\: :ref:`RID<class_RID>`, idx\: :ref:`int<class_int>`, keycode\: :ref:`Key<enum_@GlobalScope_Key>`\ ) |
|
|
| |void| | :ref:`set_item_accelerator<class_NativeMenu_method_set_item_accelerator>`\ (\ rid\: :ref:`RID<class_RID>`, idx\: :ref:`int<class_int>`, keycode\: :ref:`Key<enum_@GlobalScope_Key>`\ ) |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`set_item_callback<class_NativeMenu_method_set_item_callback>`\ (\ rid\: :ref:`RID<class_RID>`, idx\: :ref:`int<class_int>`, callback\: :ref:`Callable<class_Callable>`\ ) |
|
|
| |void| | :ref:`set_item_callback<class_NativeMenu_method_set_item_callback>`\ (\ rid\: :ref:`RID<class_RID>`, idx\: :ref:`int<class_int>`, callback\: :ref:`Callable<class_Callable>`\ ) |
|
|
@@ -188,6 +222,30 @@ enum **Feature**:
|
|
|
|
|
|
**NativeMenu** supports native popup menus.
|
|
**NativeMenu** supports native popup menus.
|
|
|
|
|
|
|
|
+.. _class_NativeMenu_constant_FEATURE_OPEN_CLOSE_CALLBACK:
|
|
|
|
+
|
|
|
|
+.. rst-class:: classref-enumeration-constant
|
|
|
|
+
|
|
|
|
+:ref:`Feature<enum_NativeMenu_Feature>` **FEATURE_OPEN_CLOSE_CALLBACK** = ``2``
|
|
|
|
+
|
|
|
|
+**NativeMenu** supports menu open and close callbacks.
|
|
|
|
+
|
|
|
|
+.. _class_NativeMenu_constant_FEATURE_HOVER_CALLBACK:
|
|
|
|
+
|
|
|
|
+.. rst-class:: classref-enumeration-constant
|
|
|
|
+
|
|
|
|
+:ref:`Feature<enum_NativeMenu_Feature>` **FEATURE_HOVER_CALLBACK** = ``3``
|
|
|
|
+
|
|
|
|
+**NativeMenu** supports menu item hover callback.
|
|
|
|
+
|
|
|
|
+.. _class_NativeMenu_constant_FEATURE_KEY_CALLBACK:
|
|
|
|
+
|
|
|
|
+.. rst-class:: classref-enumeration-constant
|
|
|
|
+
|
|
|
|
+:ref:`Feature<enum_NativeMenu_Feature>` **FEATURE_KEY_CALLBACK** = ``4``
|
|
|
|
+
|
|
|
|
+**NativeMenu** supports menu item accelerator/key callback.
|
|
|
|
+
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
----
|
|
----
|
|
@@ -269,7 +327,9 @@ An ``accelerator`` can optionally be defined, which is a keyboard shortcut that
|
|
|
|
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+\ **Note:** ``accelerator`` and ``key_callback`` are ignored on Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -289,7 +349,9 @@ An ``accelerator`` can optionally be defined, which is a keyboard shortcut that
|
|
|
|
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+\ **Note:** ``accelerator`` and ``key_callback`` are ignored on Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -309,7 +371,9 @@ An ``accelerator`` can optionally be defined, which is a keyboard shortcut that
|
|
|
|
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+\ **Note:** ``accelerator`` and ``key_callback`` are ignored on Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -331,7 +395,9 @@ An ``accelerator`` can optionally be defined, which is a keyboard shortcut that
|
|
|
|
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+\ **Note:** ``accelerator`` and ``key_callback`` are ignored on Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -351,7 +417,9 @@ An ``accelerator`` can optionally be defined, which is a keyboard shortcut that
|
|
|
|
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+\ **Note:** ``accelerator`` and ``key_callback`` are ignored on Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -375,7 +443,9 @@ An ``accelerator`` can optionally be defined, which is a keyboard shortcut that
|
|
|
|
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+\ **Note:** ``accelerator`` and ``key_callback`` are ignored on Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -397,7 +467,9 @@ An ``accelerator`` can optionally be defined, which is a keyboard shortcut that
|
|
|
|
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
\ **Note:** The ``callback`` and ``key_callback`` Callables need to accept exactly one Variant parameter, the parameter passed to the Callables will be the value passed to ``tag``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+\ **Note:** ``accelerator`` and ``key_callback`` are ignored on Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -413,7 +485,7 @@ Adds a separator between items to the global menu ``rid``. Separators also occup
|
|
|
|
|
|
Returns index of the inserted item, it's not guaranteed to be the same as ``index`` value.
|
|
Returns index of the inserted item, it's not guaranteed to be the same as ``index`` value.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -429,7 +501,7 @@ Adds an item that will act as a submenu of the global menu ``rid``. The ``submen
|
|
|
|
|
|
Returns index of the inserted item, it's not guaranteed to be the same as ``index`` value.
|
|
Returns index of the inserted item, it's not guaranteed to be the same as ``index`` value.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -443,7 +515,7 @@ Returns index of the inserted item, it's not guaranteed to be the same as ``inde
|
|
|
|
|
|
Removes all items from the global menu ``rid``.
|
|
Removes all items from the global menu ``rid``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -457,7 +529,7 @@ Removes all items from the global menu ``rid``.
|
|
|
|
|
|
Creates a new global menu object.
|
|
Creates a new global menu object.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -471,7 +543,7 @@ Creates a new global menu object.
|
|
|
|
|
|
Returns the index of the item with the specified ``tag``. Index is automatically assigned to each item by the engine. Index can not be set manually.
|
|
Returns the index of the item with the specified ``tag``. Index is automatically assigned to each item by the engine. Index can not be set manually.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -485,7 +557,7 @@ Returns the index of the item with the specified ``tag``. Index is automatically
|
|
|
|
|
|
Returns the index of the item with the specified ``text``. Index is automatically assigned to each item by the engine. Index can not be set manually.
|
|
Returns the index of the item with the specified ``text``. Index is automatically assigned to each item by the engine. Index can not be set manually.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -499,7 +571,7 @@ Returns the index of the item with the specified ``text``. Index is automaticall
|
|
|
|
|
|
Frees a global menu object created by this **NativeMenu**.
|
|
Frees a global menu object created by this **NativeMenu**.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -527,7 +599,7 @@ Returns the accelerator of the item at index ``idx``. Accelerators are special c
|
|
|
|
|
|
Returns the callback of the item at index ``idx``.
|
|
Returns the callback of the item at index ``idx``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -541,7 +613,7 @@ Returns the callback of the item at index ``idx``.
|
|
|
|
|
|
Returns number of items in the global menu ``rid``.
|
|
Returns number of items in the global menu ``rid``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -555,7 +627,7 @@ Returns number of items in the global menu ``rid``.
|
|
|
|
|
|
Returns the icon of the item at index ``idx``.
|
|
Returns the icon of the item at index ``idx``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -597,7 +669,7 @@ Returns the callback of the item accelerator at index ``idx``.
|
|
|
|
|
|
Returns number of states of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
Returns number of states of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -611,7 +683,7 @@ Returns number of states of a multistate item. See :ref:`add_multistate_item<cla
|
|
|
|
|
|
Returns the state of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
Returns the state of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -625,7 +697,7 @@ Returns the state of a multistate item. See :ref:`add_multistate_item<class_Nati
|
|
|
|
|
|
Returns the submenu ID of the item at index ``idx``. See :ref:`add_submenu_item<class_NativeMenu_method_add_submenu_item>` for more info on how to add a submenu.
|
|
Returns the submenu ID of the item at index ``idx``. See :ref:`add_submenu_item<class_NativeMenu_method_add_submenu_item>` for more info on how to add a submenu.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -639,7 +711,7 @@ Returns the submenu ID of the item at index ``idx``. See :ref:`add_submenu_item<
|
|
|
|
|
|
Returns the metadata of the specified item, which might be of any type. You can set it with :ref:`set_item_tag<class_NativeMenu_method_set_item_tag>`, which provides a simple way of assigning context data to items.
|
|
Returns the metadata of the specified item, which might be of any type. You can set it with :ref:`set_item_tag<class_NativeMenu_method_set_item_tag>`, which provides a simple way of assigning context data to items.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -653,7 +725,7 @@ Returns the metadata of the specified item, which might be of any type. You can
|
|
|
|
|
|
Returns the text of the item at index ``idx``.
|
|
Returns the text of the item at index ``idx``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -723,7 +795,7 @@ b]Note:** This method is implemented only on macOS.
|
|
|
|
|
|
Returns global menu size.
|
|
Returns global menu size.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -765,7 +837,7 @@ Returns readable name of a special system menu.
|
|
|
|
|
|
Returns ``true`` if the specified ``feature`` is supported by the current **NativeMenu**, ``false`` otherwise.
|
|
Returns ``true`` if the specified ``feature`` is supported by the current **NativeMenu**, ``false`` otherwise.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -779,7 +851,7 @@ Returns ``true`` if the specified ``feature`` is supported by the current **Nati
|
|
|
|
|
|
Returns ``true`` if ``rid`` is valid global menu.
|
|
Returns ``true`` if ``rid`` is valid global menu.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -807,7 +879,7 @@ Returns ``true`` if a special system menu is supported.
|
|
|
|
|
|
Returns ``true`` if the item at index ``idx`` is checkable in some way, i.e. if it has a checkbox or radio button.
|
|
Returns ``true`` if the item at index ``idx`` is checkable in some way, i.e. if it has a checkbox or radio button.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -821,7 +893,7 @@ Returns ``true`` if the item at index ``idx`` is checkable in some way, i.e. if
|
|
|
|
|
|
Returns ``true`` if the item at index ``idx`` is checked.
|
|
Returns ``true`` if the item at index ``idx`` is checked.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -837,7 +909,7 @@ Returns ``true`` if the item at index ``idx`` is disabled. When it is disabled i
|
|
|
|
|
|
See :ref:`set_item_disabled<class_NativeMenu_method_set_item_disabled>` for more info on how to disable an item.
|
|
See :ref:`set_item_disabled<class_NativeMenu_method_set_item_disabled>` for more info on how to disable an item.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -869,7 +941,7 @@ Returns ``true`` if the item at index ``idx`` has radio button-style checkabilit
|
|
|
|
|
|
\ **Note:** This is purely cosmetic; you must add the logic for checking/unchecking items in radio groups.
|
|
\ **Note:** This is purely cosmetic; you must add the logic for checking/unchecking items in radio groups.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -897,7 +969,7 @@ Return ``true`` is global menu is a special system menu.
|
|
|
|
|
|
Shows the global menu at ``position`` in the screen coordinates.
|
|
Shows the global menu at ``position`` in the screen coordinates.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -913,7 +985,21 @@ Removes the item at index ``idx`` from the global menu ``rid``.
|
|
|
|
|
|
\ **Note:** The indices of items after the removed item will be shifted by one.
|
|
\ **Note:** The indices of items after the removed item will be shifted by one.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
+
|
|
|
|
+.. rst-class:: classref-item-separator
|
|
|
|
+
|
|
|
|
+----
|
|
|
|
+
|
|
|
|
+.. _class_NativeMenu_method_set_interface_direction:
|
|
|
|
+
|
|
|
|
+.. rst-class:: classref-method
|
|
|
|
+
|
|
|
|
+|void| **set_interface_direction**\ (\ rid\: :ref:`RID<class_RID>`, is_rtl\: :ref:`bool<class_bool>`\ )
|
|
|
|
+
|
|
|
|
+Sets the menu text layout directtion.
|
|
|
|
+
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -943,7 +1029,7 @@ Sets the callback of the item at index ``idx``. Callback is emitted when an item
|
|
|
|
|
|
\ **Note:** The ``callback`` Callable needs to accept exactly one Variant parameter, the parameter passed to the Callable will be the value passed to the ``tag`` parameter when the menu item was created.
|
|
\ **Note:** The ``callback`` Callable needs to accept exactly one Variant parameter, the parameter passed to the Callable will be the value passed to the ``tag`` parameter when the menu item was created.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -957,7 +1043,7 @@ Sets the callback of the item at index ``idx``. Callback is emitted when an item
|
|
|
|
|
|
Sets whether the item at index ``idx`` has a checkbox. If ``false``, sets the type of the item to plain text.
|
|
Sets whether the item at index ``idx`` has a checkbox. If ``false``, sets the type of the item to plain text.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -971,7 +1057,7 @@ Sets whether the item at index ``idx`` has a checkbox. If ``false``, sets the ty
|
|
|
|
|
|
Sets the checkstate status of the item at index ``idx``.
|
|
Sets the checkstate status of the item at index ``idx``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -985,7 +1071,7 @@ Sets the checkstate status of the item at index ``idx``.
|
|
|
|
|
|
Enables/disables the item at index ``idx``. When it is disabled, it can't be selected and its action can't be invoked.
|
|
Enables/disables the item at index ``idx``. When it is disabled, it can't be selected and its action can't be invoked.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1029,9 +1115,9 @@ Sets the callback of the item at index ``idx``. The callback is emitted when an
|
|
|
|
|
|
Replaces the :ref:`Texture2D<class_Texture2D>` icon of the specified ``idx``.
|
|
Replaces the :ref:`Texture2D<class_Texture2D>` icon of the specified ``idx``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
-\ **Note:** This method is not supported by macOS "_dock" menu items.
|
|
|
|
|
|
+\ **Note:** This method is not supported by macOS Dock menu items.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1075,7 +1161,7 @@ Sets the callback of the item at index ``idx``. Callback is emitted when its acc
|
|
|
|
|
|
Sets number of state of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
Sets number of state of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1091,7 +1177,7 @@ Sets the type of the item at the specified index ``idx`` to radio button. If ``f
|
|
|
|
|
|
\ **Note:** This is purely cosmetic; you must add the logic for checking/unchecking items in radio groups.
|
|
\ **Note:** This is purely cosmetic; you must add the logic for checking/unchecking items in radio groups.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1105,7 +1191,7 @@ Sets the type of the item at the specified index ``idx`` to radio button. If ``f
|
|
|
|
|
|
Sets the state of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
Sets the state of a multistate item. See :ref:`add_multistate_item<class_NativeMenu_method_add_multistate_item>` for details.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1119,7 +1205,7 @@ Sets the state of a multistate item. See :ref:`add_multistate_item<class_NativeM
|
|
|
|
|
|
Sets the submenu RID of the item at index ``idx``. The submenu is a global menu that would be shown when the item is clicked.
|
|
Sets the submenu RID of the item at index ``idx``. The submenu is a global menu that would be shown when the item is clicked.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1133,7 +1219,7 @@ Sets the submenu RID of the item at index ``idx``. The submenu is a global menu
|
|
|
|
|
|
Sets the metadata of an item, which may be of any type. You can later get it with :ref:`get_item_tag<class_NativeMenu_method_get_item_tag>`, which provides a simple way of assigning context data to items.
|
|
Sets the metadata of an item, which may be of any type. You can later get it with :ref:`get_item_tag<class_NativeMenu_method_get_item_tag>`, which provides a simple way of assigning context data to items.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1147,7 +1233,7 @@ Sets the metadata of an item, which may be of any type. You can later get it wit
|
|
|
|
|
|
Sets the text of the item at index ``idx``.
|
|
Sets the text of the item at index ``idx``.
|
|
|
|
|
|
-\ **Note:** This method is implemented only on macOS.
|
|
|
|
|
|
+\ **Note:** This method is implemented on macOS and Windows.
|
|
|
|
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
@@ -1189,6 +1275,8 @@ Sets the minimum width of the global menu.
|
|
|
|
|
|
Registers callable to emit when the menu is about to show.
|
|
Registers callable to emit when the menu is about to show.
|
|
|
|
|
|
|
|
+\ **Note:** This method is implemented only on macOS.
|
|
|
|
+
|
|
.. rst-class:: classref-item-separator
|
|
.. rst-class:: classref-item-separator
|
|
|
|
|
|
----
|
|
----
|
|
@@ -1201,6 +1289,8 @@ Registers callable to emit when the menu is about to show.
|
|
|
|
|
|
Registers callable to emit when the menu is about to closed.
|
|
Registers callable to emit when the menu is about to closed.
|
|
|
|
|
|
|
|
+\ **Note:** This method is implemented only on macOS.
|
|
|
|
+
|
|
.. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
|
|
.. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
|
|
.. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
|
|
.. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
|
|
.. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
|
|
.. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
|