godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2025-12-31 09:49:22 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
4.x
godot-docs-l10n/classes/it/class_popupmenu.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch 
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

1906 lines
130 KiB
ReStructuredText
Raw Permalink Blame History

:github_url: hide
.. _class_PopupMenu:
PopupMenu
=========
**Eredita:** :ref:`Popup<class_Popup>` **<** :ref:`Window<class_Window>` **<** :ref:`Viewport<class_Viewport>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Una finestra modale utilizzata per visualizzare un elenco di opzioni.
.. rst-class:: classref-introduction-group
Descrizione
----------------------
**PopupMenu** is a modal window used to display a list of options. Useful for toolbars and context menus.
The size of a **PopupMenu** can be limited by using :ref:`Window.max_size<class_Window_property_max_size>`. If the height of the list of items is larger than the maximum height of the **PopupMenu**, a :ref:`ScrollContainer<class_ScrollContainer>` within the popup will allow the user to scroll the contents. If no maximum size is set, or if it is set to ``0``, the **PopupMenu** height will be limited by its parent rect.
All ``set_*`` methods allow negative item indices, i.e. ``-1`` to access the last item, ``-2`` to select the second-to-last item, and so on.
\ **Incremental search:** Like :ref:`ItemList<class_ItemList>` and :ref:`Tree<class_Tree>`, **PopupMenu** supports searching within the list while the control is focused. Press a key that matches the first letter of an item's name to select the first item starting with the given letter. After that point, there are two ways to perform incremental search: 1) Press the same key again before the timeout duration to select the next item starting with the same letter. 2) Press letter keys that match the rest of the word before the timeout duration to match to select the item in question directly. Both of these actions will be reset to the beginning of the list if the timeout duration has passed since the last keystroke was registered. You can adjust the timeout duration by changing :ref:`ProjectSettings.gui/timers/incremental_search_max_interval_msec<class_ProjectSettings_property_gui/timers/incremental_search_max_interval_msec>`.
\ **Note:** **PopupMenu** is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window<class_Window>` on the node, such as :ref:`Window.popup_centered_clamped()<class_Window_method_popup_centered_clamped>`.
\ **Note:** The ID values used for items are limited to 32 bits, not full 64 bits of :ref:`int<class_int>`. This has a range of ``-2^32`` to ``2^32 - 1``, i.e. ``-2147483648`` to ``2147483647``.
.. rst-class:: classref-reftable-group
Proprietà
------------------
.. table::
:widths: auto
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`allow_search<class_PopupMenu_property_allow_search>` | ``true`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`hide_on_checkable_item_selection<class_PopupMenu_property_hide_on_checkable_item_selection>` | ``true`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`hide_on_item_selection<class_PopupMenu_property_hide_on_item_selection>` | ``true`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`hide_on_state_item_selection<class_PopupMenu_property_hide_on_state_item_selection>` | ``false`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`item_count<class_PopupMenu_property_item_count>` | ``0`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`prefer_native_menu<class_PopupMenu_property_prefer_native_menu>` | ``false`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`submenu_popup_delay<class_PopupMenu_property_submenu_popup_delay>` | ``0.2`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`SystemMenus<enum_NativeMenu_SystemMenus>` | :ref:`system_menu_id<class_PopupMenu_property_system_menu_id>` | ``0`` |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | transparent | ``true`` (overrides :ref:`Window<class_Window_property_transparent>`) |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | transparent_bg | ``true`` (overrides :ref:`Viewport<class_Viewport_property_transparent_bg>`) |
+-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Metodi
------------
.. table::
:widths: auto
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`activate_item_by_event<class_PopupMenu_method_activate_item_by_event>`\ (\ event\: :ref:`InputEvent<class_InputEvent>`, for_global_only\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_check_item<class_PopupMenu_method_add_check_item>`\ (\ label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_check_shortcut<class_PopupMenu_method_add_check_shortcut>`\ (\ shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_icon_check_item<class_PopupMenu_method_add_icon_check_item>`\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_icon_check_shortcut<class_PopupMenu_method_add_icon_check_shortcut>`\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_icon_item<class_PopupMenu_method_add_icon_item>`\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_icon_radio_check_item<class_PopupMenu_method_add_icon_radio_check_item>`\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_icon_radio_check_shortcut<class_PopupMenu_method_add_icon_radio_check_shortcut>`\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_icon_shortcut<class_PopupMenu_method_add_icon_shortcut>`\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false, allow_echo\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_item<class_PopupMenu_method_add_item>`\ (\ label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_multistate_item<class_PopupMenu_method_add_multistate_item>`\ (\ label\: :ref:`String<class_String>`, max_states\: :ref:`int<class_int>`, default_state\: :ref:`int<class_int>` = 0, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_radio_check_item<class_PopupMenu_method_add_radio_check_item>`\ (\ label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_radio_check_shortcut<class_PopupMenu_method_add_radio_check_shortcut>`\ (\ shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_separator<class_PopupMenu_method_add_separator>`\ (\ label\: :ref:`String<class_String>` = "", id\: :ref:`int<class_int>` = -1\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_shortcut<class_PopupMenu_method_add_shortcut>`\ (\ shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false, allow_echo\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_submenu_item<class_PopupMenu_method_add_submenu_item>`\ (\ label\: :ref:`String<class_String>`, submenu\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_submenu_node_item<class_PopupMenu_method_add_submenu_node_item>`\ (\ label\: :ref:`String<class_String>`, submenu\: :ref:`PopupMenu<class_PopupMenu>`, id\: :ref:`int<class_int>` = -1\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`clear<class_PopupMenu_method_clear>`\ (\ free_submenus\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_focused_item<class_PopupMenu_method_get_focused_item>`\ (\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Key<enum_@GlobalScope_Key>` | :ref:`get_item_accelerator<class_PopupMenu_method_get_item_accelerator>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`AutoTranslateMode<enum_Node_AutoTranslateMode>` | :ref:`get_item_auto_translate_mode<class_PopupMenu_method_get_item_auto_translate_mode>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`get_item_icon<class_PopupMenu_method_get_item_icon>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_item_icon_max_width<class_PopupMenu_method_get_item_icon_max_width>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Color<class_Color>` | :ref:`get_item_icon_modulate<class_PopupMenu_method_get_item_icon_modulate>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_item_id<class_PopupMenu_method_get_item_id>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_item_indent<class_PopupMenu_method_get_item_indent>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_item_index<class_PopupMenu_method_get_item_index>`\ (\ id\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_item_language<class_PopupMenu_method_get_item_language>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`get_item_metadata<class_PopupMenu_method_get_item_metadata>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_item_multistate<class_PopupMenu_method_get_item_multistate>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_item_multistate_max<class_PopupMenu_method_get_item_multistate_max>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Shortcut<class_Shortcut>` | :ref:`get_item_shortcut<class_PopupMenu_method_get_item_shortcut>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_item_submenu<class_PopupMenu_method_get_item_submenu>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_item_submenu_node<class_PopupMenu_method_get_item_submenu_node>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_item_text<class_PopupMenu_method_get_item_text>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`get_item_text_direction<class_PopupMenu_method_get_item_text_direction>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_item_tooltip<class_PopupMenu_method_get_item_tooltip>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_item_checkable<class_PopupMenu_method_is_item_checkable>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_item_checked<class_PopupMenu_method_is_item_checked>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_item_disabled<class_PopupMenu_method_is_item_disabled>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_item_radio_checkable<class_PopupMenu_method_is_item_radio_checkable>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_item_separator<class_PopupMenu_method_is_item_separator>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_item_shortcut_disabled<class_PopupMenu_method_is_item_shortcut_disabled>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_native_menu<class_PopupMenu_method_is_native_menu>`\ (\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_system_menu<class_PopupMenu_method_is_system_menu>`\ (\ ) |const| |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_item<class_PopupMenu_method_remove_item>`\ (\ index\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`scroll_to_item<class_PopupMenu_method_scroll_to_item>`\ (\ index\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_focused_item<class_PopupMenu_method_set_focused_item>`\ (\ index\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_accelerator<class_PopupMenu_method_set_item_accelerator>`\ (\ index\: :ref:`int<class_int>`, accel\: :ref:`Key<enum_@GlobalScope_Key>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_as_checkable<class_PopupMenu_method_set_item_as_checkable>`\ (\ index\: :ref:`int<class_int>`, enable\: :ref:`bool<class_bool>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_as_radio_checkable<class_PopupMenu_method_set_item_as_radio_checkable>`\ (\ index\: :ref:`int<class_int>`, enable\: :ref:`bool<class_bool>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_as_separator<class_PopupMenu_method_set_item_as_separator>`\ (\ index\: :ref:`int<class_int>`, enable\: :ref:`bool<class_bool>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_auto_translate_mode<class_PopupMenu_method_set_item_auto_translate_mode>`\ (\ index\: :ref:`int<class_int>`, mode\: :ref:`AutoTranslateMode<enum_Node_AutoTranslateMode>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_checked<class_PopupMenu_method_set_item_checked>`\ (\ index\: :ref:`int<class_int>`, checked\: :ref:`bool<class_bool>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_disabled<class_PopupMenu_method_set_item_disabled>`\ (\ index\: :ref:`int<class_int>`, disabled\: :ref:`bool<class_bool>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_icon<class_PopupMenu_method_set_item_icon>`\ (\ index\: :ref:`int<class_int>`, icon\: :ref:`Texture2D<class_Texture2D>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_icon_max_width<class_PopupMenu_method_set_item_icon_max_width>`\ (\ index\: :ref:`int<class_int>`, width\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_icon_modulate<class_PopupMenu_method_set_item_icon_modulate>`\ (\ index\: :ref:`int<class_int>`, modulate\: :ref:`Color<class_Color>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_id<class_PopupMenu_method_set_item_id>`\ (\ index\: :ref:`int<class_int>`, id\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_indent<class_PopupMenu_method_set_item_indent>`\ (\ index\: :ref:`int<class_int>`, indent\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_language<class_PopupMenu_method_set_item_language>`\ (\ index\: :ref:`int<class_int>`, language\: :ref:`String<class_String>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_metadata<class_PopupMenu_method_set_item_metadata>`\ (\ index\: :ref:`int<class_int>`, metadata\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_multistate<class_PopupMenu_method_set_item_multistate>`\ (\ index\: :ref:`int<class_int>`, state\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_multistate_max<class_PopupMenu_method_set_item_multistate_max>`\ (\ index\: :ref:`int<class_int>`, max_states\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_shortcut<class_PopupMenu_method_set_item_shortcut>`\ (\ index\: :ref:`int<class_int>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, global\: :ref:`bool<class_bool>` = false\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_shortcut_disabled<class_PopupMenu_method_set_item_shortcut_disabled>`\ (\ index\: :ref:`int<class_int>`, disabled\: :ref:`bool<class_bool>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_submenu<class_PopupMenu_method_set_item_submenu>`\ (\ index\: :ref:`int<class_int>`, submenu\: :ref:`String<class_String>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_submenu_node<class_PopupMenu_method_set_item_submenu_node>`\ (\ index\: :ref:`int<class_int>`, submenu\: :ref:`PopupMenu<class_PopupMenu>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_text<class_PopupMenu_method_set_item_text>`\ (\ index\: :ref:`int<class_int>`, text\: :ref:`String<class_String>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_text_direction<class_PopupMenu_method_set_item_text_direction>`\ (\ index\: :ref:`int<class_int>`, direction\: :ref:`TextDirection<enum_Control_TextDirection>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_item_tooltip<class_PopupMenu_method_set_item_tooltip>`\ (\ index\: :ref:`int<class_int>`, tooltip\: :ref:`String<class_String>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`toggle_item_checked<class_PopupMenu_method_toggle_item_checked>`\ (\ index\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`toggle_item_multistate<class_PopupMenu_method_toggle_item_multistate>`\ (\ index\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Proprietà del tema
------------------------------------
.. table::
:widths: auto
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_accelerator_color<class_PopupMenu_theme_color_font_accelerator_color>` | ``Color(0.7, 0.7, 0.7, 0.8)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_color<class_PopupMenu_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_disabled_color<class_PopupMenu_theme_color_font_disabled_color>` | ``Color(0.4, 0.4, 0.4, 0.8)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_hover_color<class_PopupMenu_theme_color_font_hover_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_outline_color<class_PopupMenu_theme_color_font_outline_color>` | ``Color(0, 0, 0, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_separator_color<class_PopupMenu_theme_color_font_separator_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_separator_outline_color<class_PopupMenu_theme_color_font_separator_outline_color>` | ``Color(0, 0, 0, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`gutter_compact<class_PopupMenu_theme_constant_gutter_compact>` | ``1`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`h_separation<class_PopupMenu_theme_constant_h_separation>` | ``4`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`icon_max_width<class_PopupMenu_theme_constant_icon_max_width>` | ``0`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`indent<class_PopupMenu_theme_constant_indent>` | ``10`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`item_end_padding<class_PopupMenu_theme_constant_item_end_padding>` | ``2`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`item_start_padding<class_PopupMenu_theme_constant_item_start_padding>` | ``2`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`outline_size<class_PopupMenu_theme_constant_outline_size>` | ``0`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`separator_outline_size<class_PopupMenu_theme_constant_separator_outline_size>` | ``0`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`v_separation<class_PopupMenu_theme_constant_v_separation>` | ``4`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Font<class_Font>` | :ref:`font<class_PopupMenu_theme_font_font>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Font<class_Font>` | :ref:`font_separator<class_PopupMenu_theme_font_font_separator>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`font_separator_size<class_PopupMenu_theme_font_size_font_separator_size>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`font_size<class_PopupMenu_theme_font_size_font_size>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`checked<class_PopupMenu_theme_icon_checked>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`checked_disabled<class_PopupMenu_theme_icon_checked_disabled>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`radio_checked<class_PopupMenu_theme_icon_radio_checked>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`radio_checked_disabled<class_PopupMenu_theme_icon_radio_checked_disabled>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`radio_unchecked<class_PopupMenu_theme_icon_radio_unchecked>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`radio_unchecked_disabled<class_PopupMenu_theme_icon_radio_unchecked_disabled>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`submenu<class_PopupMenu_theme_icon_submenu>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`submenu_mirrored<class_PopupMenu_theme_icon_submenu_mirrored>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`unchecked<class_PopupMenu_theme_icon_unchecked>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`unchecked_disabled<class_PopupMenu_theme_icon_unchecked_disabled>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`hover<class_PopupMenu_theme_style_hover>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`labeled_separator_left<class_PopupMenu_theme_style_labeled_separator_left>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`labeled_separator_right<class_PopupMenu_theme_style_labeled_separator_right>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`panel<class_PopupMenu_theme_style_panel>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`separator<class_PopupMenu_theme_style_separator>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Segnali
--------------
.. _class_PopupMenu_signal_id_focused:
.. rst-class:: classref-signal
**id_focused**\ (\ id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_signal_id_focused>`
Emesso quando l'utente naviga verso un elemento con un certo ``id`` utilizzando l'azione di input :ref:`ProjectSettings.input/ui_up<class_ProjectSettings_property_input/ui_up>` o :ref:`ProjectSettings.input/ui_down<class_ProjectSettings_property_input/ui_down>`.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_signal_id_pressed:
.. rst-class:: classref-signal
**id_pressed**\ (\ id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_signal_id_pressed>`
Emitted when an item of some ``id`` is pressed. Also emitted when its accelerator is activated on macOS.
\ **Note:** If ``id`` is negative (either explicitly or due to overflow), this will return the corresponding index instead.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_signal_index_pressed:
.. rst-class:: classref-signal
**index_pressed**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_signal_index_pressed>`
Emitted when an item of some ``index`` is pressed. Also emitted when its accelerator is activated on macOS.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_signal_menu_changed:
.. rst-class:: classref-signal
**menu_changed**\ (\ ) :ref:`🔗<class_PopupMenu_signal_menu_changed>`
Emesso quando un elemento viene aggiunto, modificato o rimosso.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà
------------------------------------------------------
.. _class_PopupMenu_property_allow_search:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **allow_search** = ``true`` :ref:`🔗<class_PopupMenu_property_allow_search>`
.. rst-class:: classref-property-setget
- |void| **set_allow_search**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_allow_search**\ (\ )
Se ``true``, consente di navigare il **PopupMenu** con i tasti delle lettere.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_property_hide_on_checkable_item_selection:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **hide_on_checkable_item_selection** = ``true`` :ref:`🔗<class_PopupMenu_property_hide_on_checkable_item_selection>`
.. rst-class:: classref-property-setget
- |void| **set_hide_on_checkable_item_selection**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_hide_on_checkable_item_selection**\ (\ )
Se ``true``, nasconde il **PopupMenu** quando viene selezionata una casella di spunta o un pulsante di scelta (radio).
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_property_hide_on_item_selection:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **hide_on_item_selection** = ``true`` :ref:`🔗<class_PopupMenu_property_hide_on_item_selection>`
.. rst-class:: classref-property-setget
- |void| **set_hide_on_item_selection**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_hide_on_item_selection**\ (\ )
Se ``true``, nasconde il **PopupMenu** quando viene selezionato un elemento.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_property_hide_on_state_item_selection:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **hide_on_state_item_selection** = ``false`` :ref:`🔗<class_PopupMenu_property_hide_on_state_item_selection>`
.. rst-class:: classref-property-setget
- |void| **set_hide_on_state_item_selection**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_hide_on_state_item_selection**\ (\ )
Se ``true``, nasconde il **PopupMenu** quando viene selezionato un elemento di stato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_property_item_count:
.. rst-class:: classref-property
:ref:`int<class_int>` **item_count** = ``0`` :ref:`🔗<class_PopupMenu_property_item_count>`
.. rst-class:: classref-property-setget
- |void| **set_item_count**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_item_count**\ (\ )
Il numero di elementi attualmente nell'elenco.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_property_prefer_native_menu:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **prefer_native_menu** = ``false`` :ref:`🔗<class_PopupMenu_property_prefer_native_menu>`
.. rst-class:: classref-property-setget
- |void| **set_prefer_native_menu**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_prefer_native_menu**\ (\ )
Se ``true``, il :ref:`MenuBar<class_MenuBar>` utilizzerà il menu nativo quando supportato.
\ **Nota:** Se il **PopupMenu** è collegato a uno :ref:`StatusIndicator<class_StatusIndicator>`, il :ref:`MenuBar<class_MenuBar>` o un altro elemento **PopupMenu** può utilizzare il menu nativo a prescindere da questa proprietà, usa :ref:`is_native_menu()<class_PopupMenu_method_is_native_menu>` per verificarlo.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_property_submenu_popup_delay:
.. rst-class:: classref-property
:ref:`float<class_float>` **submenu_popup_delay** = ``0.2`` :ref:`🔗<class_PopupMenu_property_submenu_popup_delay>`
.. rst-class:: classref-property-setget
- |void| **set_submenu_popup_delay**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_submenu_popup_delay**\ (\ )
Sets the delay time in seconds for the submenu item to popup on mouse hovering. If the popup menu is added as a child of another (acting as a submenu), it will inherit the delay time of the parent menu item.
\ **Note:** If the mouse is exiting a submenu item with an open submenu and enters a different submenu item, the submenu popup delay time is affected by the direction of the mouse movement toward the open submenu. If the mouse is moving toward the submenu, the open submenu will wait approximately ``0.5`` seconds before closing, which then allows the hovered submenu item to open. This additional delay allows the mouse time to move to the open submenu across other menu items without prematurely closing. If the mouse is not moving toward the open submenu, for example in a downward direction, the open submenu will close immediately.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_property_system_menu_id:
.. rst-class:: classref-property
:ref:`SystemMenus<enum_NativeMenu_SystemMenus>` **system_menu_id** = ``0`` :ref:`🔗<class_PopupMenu_property_system_menu_id>`
.. rst-class:: classref-property-setget
- |void| **set_system_menu**\ (\ value\: :ref:`SystemMenus<enum_NativeMenu_SystemMenus>`\ )
- :ref:`SystemMenus<enum_NativeMenu_SystemMenus>` **get_system_menu**\ (\ )
Se impostato su uno dei valori di :ref:`SystemMenus<enum_NativeMenu_SystemMenus>`, questo **PopupMenu** è associato al menu speciale di sistema. È possibile associare un solo **PopupMenu** alla volta a ciascun menu speciale.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni dei metodi
--------------------------------------------
.. _class_PopupMenu_method_activate_item_by_event:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **activate_item_by_event**\ (\ event\: :ref:`InputEvent<class_InputEvent>`, for_global_only\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_activate_item_by_event>`
Controlla l'evento ``event`` fornito rispetto alle scorciatoie e agli acceleratori del **PopupMenu** e attiva il primo elemento con gli eventi corrispondenti. Se ``for_global_only`` è ``true``, saranno chiamati solo le scorciatoie e gli acceleratori con ``global`` impostato su ``true``.
Restituisce ``true`` se un elemento è stato attivato correttamente.
\ **Nota:** Alcuni :ref:`Control<class_Control>`, come :ref:`MenuButton<class_MenuButton>`, chiameranno questo metodo automaticamente.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_check_item:
.. rst-class:: classref-method
|void| **add_check_item**\ (\ label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) :ref:`🔗<class_PopupMenu_method_add_check_item>`
Aggiunge un nuovo elemento spuntabile con il testo ``label``.
È possibile fornire un ``id`` facoltativamente, così come un acceleratore (``accel``). Se nessun ``id`` è fornito, ne sarà creato uno dall'indice. Se nessun ``accel`` è fornito, all'elemento sarà assegnato il valore predefinito 0 (corrispondente a :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`) (il che significa che non avrà alcun acceleratore). Consulta :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` per ulteriori informazioni sugli acceleratori.
\ **Nota:** Gli elementi spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionati e deselezionati manualmente. Consulta :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>` per ulteriori informazioni su come controllarli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_check_shortcut:
.. rst-class:: classref-method
|void| **add_check_shortcut**\ (\ shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_add_check_shortcut>`
Aggiunge un nuovo elemento spuntabile e gli assegna la scorciatoia (:ref:`Shortcut<class_Shortcut>`) specificata. Imposta l'etichetta della casella di spunta sul nome del :ref:`Shortcut<class_Shortcut>`.
È possibile fornire un ``id`` facoltativamente. Se nessun ``id`` è fornito, ne sarà creato uno dall'indice.
\ **Nota:** Gli elementi spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionati e deselezionati manualmente. Consulta :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>` per ulteriori informazioni su come controllarli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_icon_check_item:
.. rst-class:: classref-method
|void| **add_icon_check_item**\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) :ref:`🔗<class_PopupMenu_method_add_icon_check_item>`
Aggiunge un nuovo elemento spuntabile con il testo ``label`` e l'icona ``texture``.
È possibile fornire un ``id`` facoltativamente, così come un acceleratore (``accel``). Se nessun ``id`` è fornito, ne sarà creato uno dall'indice. Se nessun ``accel`` è fornito, all'elemento sarà assegnato il valore predefinito 0 (corrispondente a :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`) (il che significa che non avrà alcun acceleratore). Consulta :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` per ulteriori informazioni sugli acceleratori.
\ **Nota:** Gli elementi spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionati e deselezionati manualmente. Consulta :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>` per ulteriori informazioni su come controllarli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_icon_check_shortcut:
.. rst-class:: classref-method
|void| **add_icon_check_shortcut**\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_add_icon_check_shortcut>`
Aggiunge un nuovo elemento spuntabile e gli assegna la scorciatoia (:ref:`Shortcut<class_Shortcut>`) e l'icona ``texture`` specificate. Imposta l'etichetta della casella di spunta sul nome del :ref:`Shortcut<class_Shortcut>`.
È possibile fornire un ``id`` facoltativamente. Se nessun ``id`` è fornito, ne sarà creato uno dall'indice.
\ **Nota:** Gli elementi spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionati e deselezionati manualmente. Consulta :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>` per ulteriori informazioni su come controllarli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_icon_item:
.. rst-class:: classref-method
|void| **add_icon_item**\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) :ref:`🔗<class_PopupMenu_method_add_icon_item>`
Aggiunge un nuovo elemento con il testo ``label`` e l'icona ``texture``.
È possibile fornire un ``id`` facoltativamente, così come un acceleratore (``accel``). Se nessun ``id`` è fornito, ne sarà creato uno dall'indice. Se nessun ``accel`` è fornito, all'elemento sarà assegnato il valore predefinito 0 (corrispondente a :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`) (il che significa che non avrà alcun acceleratore). Consulta :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` per ulteriori informazioni sugli acceleratori.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_icon_radio_check_item:
.. rst-class:: classref-method
|void| **add_icon_radio_check_item**\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) :ref:`🔗<class_PopupMenu_method_add_icon_radio_check_item>`
Uguale a :ref:`add_icon_check_item()<class_PopupMenu_method_add_icon_check_item>`, ma utilizza un pulsante di controllo radio.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_icon_radio_check_shortcut:
.. rst-class:: classref-method
|void| **add_icon_radio_check_shortcut**\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_add_icon_radio_check_shortcut>`
Uguale a :ref:`add_icon_check_shortcut()<class_PopupMenu_method_add_icon_check_shortcut>`, ma utilizza un pulsante di controllo radio.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_icon_shortcut:
.. rst-class:: classref-method
|void| **add_icon_shortcut**\ (\ texture\: :ref:`Texture2D<class_Texture2D>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false, allow_echo\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_add_icon_shortcut>`
Aggiunge un nuovo elemento e gli assegna la scorciatoia (:ref:`Shortcut<class_Shortcut>`) e l'icona ``texture`` specificate. Imposta l'etichetta della casella di spunta sul nome del :ref:`Shortcut<class_Shortcut>`.
È possibile fornire un ``id`` facoltativamente. Se nessun ``id`` è fornito, ne sarà creato uno dall'indice.
Se ``allow_echo`` è ``true``, la scorciatoia può essere attivata con eventi eco.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_item:
.. rst-class:: classref-method
|void| **add_item**\ (\ label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) :ref:`🔗<class_PopupMenu_method_add_item>`
Aggiunge un nuovo elemento con il testo ``label``.
È possibile fornire un ``id`` facoltativamente, così come un acceleratore (``accel``). Se nessun ``id`` è fornito, ne sarà creato uno dall'indice. Se nessun ``accel`` è fornito, all'elemento sarà assegnato il valore predefinito 0 (corrispondente a :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`) (il che significa che non avrà alcun acceleratore). Consulta :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` per ulteriori informazioni sugli acceleratori.
\ **Nota:** Il ``id`` fornito è utilizzato solo nei segnali :ref:`id_pressed<class_PopupMenu_signal_id_pressed>` e :ref:`id_focused<class_PopupMenu_signal_id_focused>`. Non è correlato agli argomenti ``index`` ad esempio in :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>`.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_multistate_item:
.. rst-class:: classref-method
|void| **add_multistate_item**\ (\ label\: :ref:`String<class_String>`, max_states\: :ref:`int<class_int>`, default_state\: :ref:`int<class_int>` = 0, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) :ref:`🔗<class_PopupMenu_method_add_multistate_item>`
Aggiunge una nuova voce multistato con il testo ``label``.
Contrariamente alle voci binarie normali, le voci multistato possono avere più di due stati, come definito da ``max_states``. Il valore predefinito è definito da ``default_state``.
È possibile fornire un ``id`` facoltativamente, così come un acceleratore (``accel``). Se nessun ``id`` è fornito, ne sarà creato uno dall'indice. Se nessun ``accel`` è fornito, alla voce sarà assegnata il valore predefinito 0 (corrispondente a :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`) (il che significa che non avrà alcun acceleratore). Consulta :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` per ulteriori informazioni sugli acceleratori.
::
func _ready():
add_multistate_item("Item", 3, 0)
index_pressed.connect(func(index: int):
toggle_item_multistate(index)
match get_item_multistate(index):
0:
print("Primo stato")
1:
print("Secondo stato")
2:
print("Terzo stato")
)
\ **Nota:** Le voci multistato non aggiornano automaticamente il loro stato e bisogna farlo manualmente. Consulta :ref:`toggle_item_multistate()<class_PopupMenu_method_toggle_item_multistate>`, :ref:`set_item_multistate()<class_PopupMenu_method_set_item_multistate>` e :ref:`get_item_multistate()<class_PopupMenu_method_get_item_multistate>` per ulteriori informazioni su come controllarli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_radio_check_item:
.. rst-class:: classref-method
|void| **add_radio_check_item**\ (\ label\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1, accel\: :ref:`Key<enum_@GlobalScope_Key>` = 0\ ) :ref:`🔗<class_PopupMenu_method_add_radio_check_item>`
Aggiunge un nuovo pulsante di controllo radio con il testo ``label``.
È possibile fornire un ``id`` facoltativamente, così come un acceleratore (``accel``). Se nessun ``id`` è fornito, ne sarà creato uno dall'indice. Se nessun ``accel`` è fornito, all'elemento sarà assegnato il valore predefinito 0 (corrispondente a :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`) (il che significa che non avrà alcun acceleratore). Consulta :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` per ulteriori informazioni sugli acceleratori.
\ **Nota:** Gli elementi spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionati e deselezionati manualmente. Consulta :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>` per ulteriori informazioni su come controllarli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_radio_check_shortcut:
.. rst-class:: classref-method
|void| **add_radio_check_shortcut**\ (\ shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_add_radio_check_shortcut>`
Aggiunge un nuovo pulsante di controllo radio e gli assegna la scorciatoia (:ref:`Shortcut<class_Shortcut>`) specificata. Imposta l'etichetta della casella di spunta sul nome del :ref:`Shortcut<class_Shortcut>`.
È possibile fornire un ``id`` facoltativamente. Se nessun ``id`` è fornito, ne sarà creato uno dall'indice.
\ **Nota:** Gli elementi spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionati e deselezionati manualmente. Consulta :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>` per ulteriori informazioni su come controllarli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_separator:
.. rst-class:: classref-method
|void| **add_separator**\ (\ label\: :ref:`String<class_String>` = "", id\: :ref:`int<class_int>` = -1\ ) :ref:`🔗<class_PopupMenu_method_add_separator>`
Aggiunge un separatore tra gli elementi. Anche i separatori occupano un indice, che è possibile impostare usando il parametro ``id``.
È possibile fornire facoltativamente un ``label``, che apparirà al centro del separatore.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_shortcut:
.. rst-class:: classref-method
|void| **add_shortcut**\ (\ shortcut\: :ref:`Shortcut<class_Shortcut>`, id\: :ref:`int<class_int>` = -1, global\: :ref:`bool<class_bool>` = false, allow_echo\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_add_shortcut>`
Aggiunge una scorciatoia (:ref:`Shortcut<class_Shortcut>`).
È possibile fornire un ``id`` facoltativamente. Se nessun ``id`` è fornito, ne sarà creato uno dall'indice.
Se ``allow_echo`` è ``true``, la scorciatoia può essere attivata con eventi eco.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_submenu_item:
.. rst-class:: classref-method
|void| **add_submenu_item**\ (\ label\: :ref:`String<class_String>`, submenu\: :ref:`String<class_String>`, id\: :ref:`int<class_int>` = -1\ ) :ref:`🔗<class_PopupMenu_method_add_submenu_item>`
**Deprecato:** Prefer using :ref:`add_submenu_node_item()<class_PopupMenu_method_add_submenu_node_item>` instead.
Aggiunge un elemento che fungerà da sottomenu del nodo **PopupMenu** genitore quando cliccato. L'argomento ``submenu`` deve essere il nome di un **PopupMenu** esistente che è stato aggiunto come figlio a questo nodo. Questo sottomenu sarà mostrato quando l'elemento viene cliccato, ci si passa sopra con il mouse per un tempo lungo abbastanza o viene attivato usando le azioni di input ``ui_select`` o ``ui_right``.
È possibile fornire un ``id`` facoltativamente. Se nessun ``id`` è fornito, ne sarà creato uno dall'indice.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_add_submenu_node_item:
.. rst-class:: classref-method
|void| **add_submenu_node_item**\ (\ label\: :ref:`String<class_String>`, submenu\: :ref:`PopupMenu<class_PopupMenu>`, id\: :ref:`int<class_int>` = -1\ ) :ref:`🔗<class_PopupMenu_method_add_submenu_node_item>`
Aggiunge un elemento che fungerà da sottomenu del nodo **PopupMenu** genitore quando cliccato. Questo sottomenu sarà mostrato quando l'elemento viene cliccato, ci si passa sopra per un tempo lungo abbastanza o viene attivato usando le azioni di input ``ui_select`` o ``ui_right``.
\ ``submenu`` deve essere figlio di questo **PopupMenu** o non avere alcun nodo genitore (nel qual caso sarà aggiunto automaticamente come figlio). Se il popup ``submenu`` ha un altro genitore, questo metodo fallirà.
È possibile fornire un ``id`` facoltativamente. Se nessun ``id`` è fornito, ne sarà creato uno dall'indice.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_clear:
.. rst-class:: classref-method
|void| **clear**\ (\ free_submenus\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_clear>`
Rimuove tutti gli elementi dal **PopupMenu**. Se ``free_submenus`` è ``true``, i nodi del sottomenu sono liberati automaticamente.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_focused_item:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_focused_item**\ (\ ) |const| :ref:`🔗<class_PopupMenu_method_get_focused_item>`
Restituisce l'indice dell'elemento attualmente focalizzato. Restituisce ``-1`` se nessun elemento è focalizzato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_accelerator:
.. rst-class:: classref-method
:ref:`Key<enum_@GlobalScope_Key>` **get_item_accelerator**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_accelerator>`
Restituisce l'acceleratore dell'elemento all'indice ``index``. Un acceleratore è una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il valore restituito è un intero che generalmente è una combinazione delle costanti di :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` e di :ref:`Key<enum_@GlobalScope_Key>` utilizzando l'operatore OR bit a bit, come ``KEY_MASK_CTRL | KEY_A`` (:kbd:`Ctrl + A`). Se nessun acceleratore è definito per l'indice ``index``, :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` restituisce ``0`` (corrispondente a :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`).
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_auto_translate_mode:
.. rst-class:: classref-method
:ref:`AutoTranslateMode<enum_Node_AutoTranslateMode>` **get_item_auto_translate_mode**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_auto_translate_mode>`
Restituisce la modalità di traduzione automatica dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_icon:
.. rst-class:: classref-method
:ref:`Texture2D<class_Texture2D>` **get_item_icon**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_icon>`
Restituisce l'icona dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_icon_max_width:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_item_icon_max_width**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_icon_max_width>`
Restituisce la larghezza massima consentita dell'icona per l'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_icon_modulate:
.. rst-class:: classref-method
:ref:`Color<class_Color>` **get_item_icon_modulate**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_icon_modulate>`
Restituisce il colore che modula l'icona dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_id:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_item_id**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_id>`
Restituisce l'ID dell'elemento all'indice ``index``. ``id`` può essere assegnato manualmente, mentre l'indice no.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_indent:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_item_indent**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_indent>`
Restituisce l'offset orizzontale dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_index:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_item_index**\ (\ id\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_index>`
Restituisce l'indice dell'elemento contenente l'``id`` specificato. L'indice è assegnato automaticamente a ciascun elemento dal motore e non può essere impostato manualmente.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_language:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_item_language**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_language>`
Restituisce il codice di lingua di testo dell'elemento.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_metadata:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **get_item_metadata**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_metadata>`
Restituisce i metadati dell'elemento specificato, che potrebbero essere di qualsiasi tipo. È possibile impostarli con :ref:`set_item_metadata()<class_PopupMenu_method_set_item_metadata>`, il quale fornisce un modo semplice per assegnare dati di contesto agli elementi.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_multistate:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_item_multistate**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_multistate>`
Restituisce lo stato dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_multistate_max:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_item_multistate_max**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_multistate_max>`
Restituisce gli stati massimi dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_shortcut:
.. rst-class:: classref-method
:ref:`Shortcut<class_Shortcut>` **get_item_shortcut**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_shortcut>`
Restituisce la :ref:`Shortcut<class_Shortcut>` associata con l'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_submenu:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_item_submenu**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_submenu>`
**Deprecato:** Prefer using :ref:`get_item_submenu_node()<class_PopupMenu_method_get_item_submenu_node>` instead.
Restituisce il nome del sottomenu dell'elemento all'indice ``index``. Consulta :ref:`add_submenu_item()<class_PopupMenu_method_add_submenu_item>` Per ulteriori informazioni su come aggiungere un sottomenu.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_submenu_node:
.. rst-class:: classref-method
:ref:`PopupMenu<class_PopupMenu>` **get_item_submenu_node**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_submenu_node>`
Restituisce il sottomenù della voce all'indice ``index``, o ``null`` se non è stato aggiunto alcun sottomenù. Consulta :ref:`add_submenu_node_item()<class_PopupMenu_method_add_submenu_node_item>` per ulteriori informazioni su come aggiungere un sottomenu.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_text:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_item_text**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_text>`
Restituisce il testo dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_text_direction:
.. rst-class:: classref-method
:ref:`TextDirection<enum_Control_TextDirection>` **get_item_text_direction**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_text_direction>`
Restituisce la direzione di scrittura della base di testo dell'elemento.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_get_item_tooltip:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_item_tooltip**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_get_item_tooltip>`
Restituisce il tooltip associato all'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_item_checkable:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_item_checkable**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_is_item_checkable>`
Restituisce ``true`` se l'elemento all'indice ``index`` è spuntabile in qualche modo, ad esempio se ha una casella di spunta o un pulsante di scelta (radio).
\ **Nota:** Gli elementi spuntabili mostrano solo un segno di spunta o un pulsante di scelta, ma non hanno alcun comportamento di controllo incorporato e devono essere selezionati e deselezionati manualmente.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_item_checked:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_item_checked**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_is_item_checked>`
Restituisce ``true`` se l'elemento all'indice ``index`` è spuntato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_item_disabled:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_item_disabled**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_is_item_disabled>`
Restituisce ``true`` se l'elemento all'indice ``index`` è disabilitato. Quando è disabilitato non può essere selezionato, e la sua azione non può essere invocata.
Consulta :ref:`set_item_disabled()<class_PopupMenu_method_set_item_disabled>` per ulteriori informazioni su come disabilitare un elemento.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_item_radio_checkable:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_item_radio_checkable**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_is_item_radio_checkable>`
Restituisce ``true`` se l'elemento all'indice ``index`` ha può essere spuntato come un pulsante di scelta (radio).
\ **Nota:** Questo è puramente estetico; devi aggiungere la logica per selezionare e deselezionare gli elementi nei gruppi di opzioni radio.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_item_separator:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_item_separator**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_is_item_separator>`
Restituisce ``true`` se l'elemento è un separatore. In tal caso, sarà visualizzato come una linea. Consulta :ref:`add_separator()<class_PopupMenu_method_add_separator>` per ulteriori informazioni su come aggiungere un separatore.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_item_shortcut_disabled:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_item_shortcut_disabled**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PopupMenu_method_is_item_shortcut_disabled>`
Restituisce ``true`` se la scorciatoia dell'elemento specificato è disabilitata.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_native_menu:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_native_menu**\ (\ ) |const| :ref:`🔗<class_PopupMenu_method_is_native_menu>`
Restituisce ``true``, se il menu nativo del sistema è supportato e utilizzato da questo **PopupMenu**.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_is_system_menu:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_system_menu**\ (\ ) |const| :ref:`🔗<class_PopupMenu_method_is_system_menu>`
Restituisce ``true`` se il menu è legato al menu speciale del sistema.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_remove_item:
.. rst-class:: classref-method
|void| **remove_item**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_remove_item>`
Rimuove l'elemento all'indice ``index`` dal menu.
\ **Nota:** Gli indici degli elementi dopo l'elemento rimosso saranno spostati di uno.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_scroll_to_item:
.. rst-class:: classref-method
|void| **scroll_to_item**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_scroll_to_item>`
Sposta la vista scorrevole per rendere visibile l'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_focused_item:
.. rst-class:: classref-method
|void| **set_focused_item**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_set_focused_item>`
Imposta l'attuale elemento focalizzato come il dato ``index``.
Passando ``-1`` come indice fa in modo che nessun elemento venga focalizzato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_accelerator:
.. rst-class:: classref-method
|void| **set_item_accelerator**\ (\ index\: :ref:`int<class_int>`, accel\: :ref:`Key<enum_@GlobalScope_Key>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_accelerator>`
Imposta l'acceleratore dell'elemento all'indice ``index``. Un acceleratore è una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il valore restituito è un intero che generalmente è una combinazione delle costanti di :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` e di :ref:`Key<enum_@GlobalScope_Key>` utilizzando l'operatore OR bit a bit, come ``KEY_MASK_CTRL | KEY_A`` (:kbd:`Ctrl + A`).
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_as_checkable:
.. rst-class:: classref-method
|void| **set_item_as_checkable**\ (\ index\: :ref:`int<class_int>`, enable\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_as_checkable>`
Imposta se l'elemento all'indice ``index`` ha una casella di spunta. Se ``false``, imposta il tipo dell'elemento su testo semplice.
\ **Nota:** gli elementi spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di controllo incorporato e devono essere selezionati e deselezionati manualmente.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_as_radio_checkable:
.. rst-class:: classref-method
|void| **set_item_as_radio_checkable**\ (\ index\: :ref:`int<class_int>`, enable\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_as_radio_checkable>`
Imposta il tipo dell'elemento all'indice ``index`` su pulsante di scelta. Se ``false``, imposta il tipo dell'elemento su testo semplice.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_as_separator:
.. rst-class:: classref-method
|void| **set_item_as_separator**\ (\ index\: :ref:`int<class_int>`, enable\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_as_separator>`
Contrassegna l'elemento all'indice ``index`` come separatore, il che significa che sarà visualizzato come una linea. Se ``false``, imposta il tipo dell'elemento su testo semplice.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_auto_translate_mode:
.. rst-class:: classref-method
|void| **set_item_auto_translate_mode**\ (\ index\: :ref:`int<class_int>`, mode\: :ref:`AutoTranslateMode<enum_Node_AutoTranslateMode>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_auto_translate_mode>`
Imposta la modalità di traduzione automatica dell'elemento associato all'indice ``index``.
Gli elementi utilizzano :ref:`Node.AUTO_TRANSLATE_MODE_INHERIT<class_Node_constant_AUTO_TRANSLATE_MODE_INHERIT>` come predefinito, il quale utilizza la stessa modalità di traduzione automatica del **PopupMenu**.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_checked:
.. rst-class:: classref-method
|void| **set_item_checked**\ (\ index\: :ref:`int<class_int>`, checked\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_checked>`
Imposta lo stato di spunta dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_disabled:
.. rst-class:: classref-method
|void| **set_item_disabled**\ (\ index\: :ref:`int<class_int>`, disabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_disabled>`
Abilita o disabilita l'elemento all'indice ``index``. Quando è disabilitato, non può essere selezionato e la sua azione non può essere invocata.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_icon:
.. rst-class:: classref-method
|void| **set_item_icon**\ (\ index\: :ref:`int<class_int>`, icon\: :ref:`Texture2D<class_Texture2D>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_icon>`
Sostituisce l'icona :ref:`Texture2D<class_Texture2D>` dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_icon_max_width:
.. rst-class:: classref-method
|void| **set_item_icon_max_width**\ (\ index\: :ref:`int<class_int>`, width\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_icon_max_width>`
Imposta la larghezza massima consentita dell'icona per l'elemento all'indice ``index``. Questo limite viene applicato al di sopra della dimensione predefinita dell'icona e sopra a :ref:`icon_max_width<class_PopupMenu_theme_constant_icon_max_width>`. L'altezza è regolata in base al rapporto dell'icona.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_icon_modulate:
.. rst-class:: classref-method
|void| **set_item_icon_modulate**\ (\ index\: :ref:`int<class_int>`, modulate\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_icon_modulate>`
Imposta una modulazione di colore dell'icona dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_id:
.. rst-class:: classref-method
|void| **set_item_id**\ (\ index\: :ref:`int<class_int>`, id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_id>`
Imposta l'``id`` dell'elemento all'indice ``index``.
L'``id`` è utilizzato nei segnali :ref:`id_pressed<class_PopupMenu_signal_id_pressed>` e :ref:`id_focused<class_PopupMenu_signal_id_focused>`.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_indent:
.. rst-class:: classref-method
|void| **set_item_indent**\ (\ index\: :ref:`int<class_int>`, indent\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_indent>`
Imposta l'offset orizzontale dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_language:
.. rst-class:: classref-method
|void| **set_item_language**\ (\ index\: :ref:`int<class_int>`, language\: :ref:`String<class_String>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_language>`
Sets the language code of the text for the item at the given index to ``language``. This is used for line-breaking and text shaping algorithms. If ``language`` is empty, the current locale is used.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_metadata:
.. rst-class:: classref-method
|void| **set_item_metadata**\ (\ index\: :ref:`int<class_int>`, metadata\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_metadata>`
Imposta i metadati di un elemento, che possono essere di qualsiasi tipo. Puoi ottenerli in seguito con :ref:`get_item_metadata()<class_PopupMenu_method_get_item_metadata>`, che fornisce un modo semplice per assegnare dati di contesto agli elementi.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_multistate:
.. rst-class:: classref-method
|void| **set_item_multistate**\ (\ index\: :ref:`int<class_int>`, state\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_multistate>`
Imposta lo stato di un elemento multistato. Vedi :ref:`add_multistate_item()<class_PopupMenu_method_add_multistate_item>` per i dettagli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_multistate_max:
.. rst-class:: classref-method
|void| **set_item_multistate_max**\ (\ index\: :ref:`int<class_int>`, max_states\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_multistate_max>`
Imposta gli stati massimi di un elemento multistato. Vedi :ref:`add_multistate_item()<class_PopupMenu_method_add_multistate_item>` per i dettagli.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_shortcut:
.. rst-class:: classref-method
|void| **set_item_shortcut**\ (\ index\: :ref:`int<class_int>`, shortcut\: :ref:`Shortcut<class_Shortcut>`, global\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_PopupMenu_method_set_item_shortcut>`
Imposta una scorciatoia (:ref:`Shortcut<class_Shortcut>`) per l'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_shortcut_disabled:
.. rst-class:: classref-method
|void| **set_item_shortcut_disabled**\ (\ index\: :ref:`int<class_int>`, disabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_shortcut_disabled>`
Disabilita la scorciatoia (:ref:`Shortcut<class_Shortcut>`) dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_submenu:
.. rst-class:: classref-method
|void| **set_item_submenu**\ (\ index\: :ref:`int<class_int>`, submenu\: :ref:`String<class_String>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_submenu>`
**Deprecato:** Prefer using :ref:`set_item_submenu_node()<class_PopupMenu_method_set_item_submenu_node>` instead.
Imposta il sottomenu dell'elemento all'indice ``index``. Il sottomenu è il nome di un nodo **PopupMenu** figlio che verrebbe mostrato quando si clicca sull'elemento.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_submenu_node:
.. rst-class:: classref-method
|void| **set_item_submenu_node**\ (\ index\: :ref:`int<class_int>`, submenu\: :ref:`PopupMenu<class_PopupMenu>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_submenu_node>`
Imposta il sottomenu dell'elemento all'indice ``index``. Il sottomenu è un nodo **PopupMenu** che verrebbe mostrato quando si clicca sull'elemento. Deve essere un figlio di questo **PopupMenu** o non avere un genitore (nel qual caso sarà automaticamente aggiunto come figlio). Se il popup ``submenu`` ha un altro genitore, questo metodo fallirà.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_text:
.. rst-class:: classref-method
|void| **set_item_text**\ (\ index\: :ref:`int<class_int>`, text\: :ref:`String<class_String>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_text>`
Imposta il testo dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_text_direction:
.. rst-class:: classref-method
|void| **set_item_text_direction**\ (\ index\: :ref:`int<class_int>`, direction\: :ref:`TextDirection<enum_Control_TextDirection>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_text_direction>`
Imposta la direzione di scrittura della base di testo dell'elemento.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_set_item_tooltip:
.. rst-class:: classref-method
|void| **set_item_tooltip**\ (\ index\: :ref:`int<class_int>`, tooltip\: :ref:`String<class_String>`\ ) :ref:`🔗<class_PopupMenu_method_set_item_tooltip>`
Imposta la stringa del tooltip dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_toggle_item_checked:
.. rst-class:: classref-method
|void| **toggle_item_checked**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_toggle_item_checked>`
Commuta lo stato di spunta dell'elemento all'indice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_method_toggle_item_multistate:
.. rst-class:: classref-method
|void| **toggle_item_multistate**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_method_toggle_item_multistate>`
Passa allo stato successivo di un elemento multistato. Vedi :ref:`add_multistate_item()<class_PopupMenu_method_add_multistate_item>` per i dettagli.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà del tema
------------------------------------------------------------------------
.. _class_PopupMenu_theme_color_font_accelerator_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_accelerator_color** = ``Color(0.7, 0.7, 0.7, 0.8)`` :ref:`🔗<class_PopupMenu_theme_color_font_accelerator_color>`
Il :ref:`Color<class_Color>` del testo utilizzato per le scorciatoie e gli acceleratori che sono visualizzati accanto al nome dell'elemento di menu quando definiti. Vedi :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` per ulteriori informazioni sugli acceleratori.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_color_font_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_PopupMenu_theme_color_font_color>`
Il :ref:`Color<class_Color>` predefinito del testo per i nomi degli elementi di menu.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_color_font_disabled_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_disabled_color** = ``Color(0.4, 0.4, 0.4, 0.8)`` :ref:`🔗<class_PopupMenu_theme_color_font_disabled_color>`
Il :ref:`Color<class_Color>` utilizzato per il testo degli elementi di menu disabilitati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_color_font_hover_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_hover_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_PopupMenu_theme_color_font_hover_color>`
Il :ref:`Color<class_Color>` utilizzato per il testo al passaggio del mouse.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_color_font_outline_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_PopupMenu_theme_color_font_outline_color>`
La tinta del contorno del testo ella voce del menu.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_color_font_separator_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_separator_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_PopupMenu_theme_color_font_separator_color>`
Il :ref:`Color<class_Color>` utilizzato per il testo dei separatori etichettati. Vedi :ref:`add_separator()<class_PopupMenu_method_add_separator>`.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_color_font_separator_outline_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_separator_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_PopupMenu_theme_color_font_separator_outline_color>`
La tinta dei contorni del testo del separatore etichettato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_gutter_compact:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **gutter_compact** = ``1`` :ref:`🔗<class_PopupMenu_theme_constant_gutter_compact>`
If not ``0``, the icon gutter will be merged with the checkbox gutter when possible. This acts as a boolean.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_h_separation:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **h_separation** = ``4`` :ref:`🔗<class_PopupMenu_theme_constant_h_separation>`
Lo spazio orizzontale tra i componenti dell'elemento.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_icon_max_width:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **icon_max_width** = ``0`` :ref:`🔗<class_PopupMenu_theme_constant_icon_max_width>`
La larghezza massima consentita dell'icona dell'elemento. Questo limite è applicato al di sopra della dimensione predefinita dell'icona, ma prima del valore impostato con :ref:`set_item_icon_max_width()<class_PopupMenu_method_set_item_icon_max_width>`. L'altezza è regolata in base al rapporto dell'icona.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_indent:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **indent** = ``10`` :ref:`🔗<class_PopupMenu_theme_constant_indent>`
Larghezza del singolo livello di indentazione.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_item_end_padding:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **item_end_padding** = ``2`` :ref:`🔗<class_PopupMenu_theme_constant_item_end_padding>`
Spaziatura orizzontale a destra degli elementi (o a sinistra, nel layout RTL).
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_item_start_padding:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **item_start_padding** = ``2`` :ref:`🔗<class_PopupMenu_theme_constant_item_start_padding>`
Spaziatura orizzontale a sinistra degli elementi (o a destra, nel layout RTL).
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_outline_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **outline_size** = ``0`` :ref:`🔗<class_PopupMenu_theme_constant_outline_size>`
La dimensione del contorno del testo dell'elemento.
\ **Nota:** Se si utilizza un font con :ref:`FontFile.multichannel_signed_distance_field<class_FontFile_property_multichannel_signed_distance_field>` abilitato, il suo :ref:`FontFile.msdf_pixel_range<class_FontFile_property_msdf_pixel_range>` deve essere impostato su almeno il *doppio* del valore di :ref:`outline_size<class_PopupMenu_theme_constant_outline_size>` affinché il rendering del contorno appaia corretto. Altrimenti, il contorno potrebbe apparire troncato prima del previsto.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_separator_outline_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **separator_outline_size** = ``0`` :ref:`🔗<class_PopupMenu_theme_constant_separator_outline_size>`
La dimensione del contorno del testo di un separatore etichettato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_constant_v_separation:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **v_separation** = ``4`` :ref:`🔗<class_PopupMenu_theme_constant_v_separation>`
Lo spazio verticale tra ogni elemento di menu.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_font_font:
.. rst-class:: classref-themeproperty
:ref:`Font<class_Font>` **font** :ref:`🔗<class_PopupMenu_theme_font_font>`
Il :ref:`Font<class_Font>` utilizzato per gli elementi di menu.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_font_font_separator:
.. rst-class:: classref-themeproperty
:ref:`Font<class_Font>` **font_separator** :ref:`🔗<class_PopupMenu_theme_font_font_separator>`
Il :ref:`Font<class_Font>` utilizzato per il separatore etichettato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_font_size_font_separator_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **font_separator_size** :ref:`🔗<class_PopupMenu_theme_font_size_font_separator_size>`
Dimensione del font di un separatore etichettato.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_font_size_font_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **font_size** :ref:`🔗<class_PopupMenu_theme_font_size_font_size>`
Dimensione del font degli elementi del menu.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_checked:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **checked** :ref:`🔗<class_PopupMenu_theme_icon_checked>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di casella di spunta che sono spuntati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_checked_disabled:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **checked_disabled** :ref:`🔗<class_PopupMenu_theme_icon_checked_disabled>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di casella di spunta quando sono disabilitati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_radio_checked:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **radio_checked** :ref:`🔗<class_PopupMenu_theme_icon_radio_checked>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di pulsante di scelta spuntati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_radio_checked_disabled:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **radio_checked_disabled** :ref:`🔗<class_PopupMenu_theme_icon_radio_checked_disabled>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di pulsante di scelta quando sono disabilitati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_radio_unchecked:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **radio_unchecked** :ref:`🔗<class_PopupMenu_theme_icon_radio_unchecked>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di pulsante di scelta non spuntati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_radio_unchecked_disabled:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **radio_unchecked_disabled** :ref:`🔗<class_PopupMenu_theme_icon_radio_unchecked_disabled>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di pulsante di scelta non spuntati, quando sono disabilitati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_submenu:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **submenu** :ref:`🔗<class_PopupMenu_theme_icon_submenu>`
Icona :ref:`Texture2D<class_Texture2D>` per la freccia del sottomenu (per i layout da sinistra a destra).
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_submenu_mirrored:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **submenu_mirrored** :ref:`🔗<class_PopupMenu_theme_icon_submenu_mirrored>`
Icona :ref:`Texture2D<class_Texture2D>` per la freccia del sottomenu (per i layout da destra a sinistra).
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_unchecked:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **unchecked** :ref:`🔗<class_PopupMenu_theme_icon_unchecked>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di casella di spunta che non sono spuntati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_icon_unchecked_disabled:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **unchecked_disabled** :ref:`🔗<class_PopupMenu_theme_icon_unchecked_disabled>`
Icona :ref:`Texture2D<class_Texture2D>` per gli elementi di casella di spunta che non sono spuntati, quando sono disabilitati.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_style_hover:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **hover** :ref:`🔗<class_PopupMenu_theme_style_hover>`
Lo :ref:`StyleBox<class_StyleBox>` visualizzato quando si passa il mouse su un elemento del **PopupMenu**.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_style_labeled_separator_left:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **labeled_separator_left** :ref:`🔗<class_PopupMenu_theme_style_labeled_separator_left>`
Lo :ref:`StyleBox<class_StyleBox>` per il lato sinistro del separatore etichettato. Vedi :ref:`add_separator()<class_PopupMenu_method_add_separator>`.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_style_labeled_separator_right:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **labeled_separator_right** :ref:`🔗<class_PopupMenu_theme_style_labeled_separator_right>`
Lo :ref:`StyleBox<class_StyleBox>` per il lato destro del separatore etichettato. Vedi :ref:`add_separator()<class_PopupMenu_method_add_separator>`.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_style_panel:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **panel** :ref:`🔗<class_PopupMenu_theme_style_panel>`
Lo :ref:`StyleBox<class_StyleBox>` per il pannello di sfondo.
.. rst-class:: classref-item-separator
----
.. _class_PopupMenu_theme_style_separator:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **separator** :ref:`🔗<class_PopupMenu_theme_style_separator>`
Lo :ref:`StyleBox<class_StyleBox>` utilizzato per i separatori. Vedi :ref:`add_separator()<class_PopupMenu_method_add_separator>`.
.. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)`
.. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)`
.. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)`
.. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)`
.. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)`
.. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)`
.. |void| replace:: :abbr:`void (Nessun valore restituito.)`
Reference in New Issue View Git Blame Copy Permalink