godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2026-01-04 10:09:56 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
4.x
godot-docs-l10n/classes/zh_Hant/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

1902 lines
127 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_PopupMenu:
PopupMenu
=========
**繼承：** :ref:`Popup<class_Popup>` **<** :ref:`Window<class_Window>` **<** :ref:`Viewport<class_Viewport>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
用於顯示選項列表的模態視窗。
.. rst-class:: classref-introduction-group
說明
----
**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
屬性
----
.. 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
方法
----
.. 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
主題屬性
--------
.. 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
訊號
----
.. _class_PopupMenu_signal_id_focused:
.. rst-class:: classref-signal
**id_focused**\ (\ id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PopupMenu_signal_id_focused>`
使用者使用 :ref:`ProjectSettings.input/ui_up<class_ProjectSettings_property_input/ui_up>` 或 :ref:`ProjectSettings.input/ui_down<class_ProjectSettings_property_input/ui_down>` 輸入動作移動至 ID 為 ``id`` 的功能表專案時發出。
.. 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>`
發生選單項的新增、修改、刪除時發出。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
屬性說明
--------
.. _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**\ (\ )
如果為 ``true``\ ，允許用字母鍵導覽 **PopupMenu**\ 。
.. 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**\ (\ )
如果為 ``true``\ ，則在選中核取方塊或選項按鈕時隱藏 **PopupMenu**\ 。
.. 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**\ (\ )
如果為 ``true``\ ，當一個專案被選中時隱藏 **PopupMenu**\ 。
.. 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**\ (\ )
如果為 ``true``\ ，則在選中狀態項時隱藏 **PopupMenu**\ 。
.. 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**\ (\ )
目前列表中的專案數。
.. 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**\ (\ )
If ``true``, :ref:`MenuBar<class_MenuBar>` will use native menu when supported.
\ **Note:** If **PopupMenu** is linked to :ref:`StatusIndicator<class_StatusIndicator>`, :ref:`MenuBar<class_MenuBar>`, or another **PopupMenu** item it can use native menu regardless of this property, use :ref:`is_native_menu()<class_PopupMenu_method_is_native_menu>` to check it.
.. 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**\ (\ )
If set to one of the values of :ref:`SystemMenus<enum_NativeMenu_SystemMenus>`, this **PopupMenu** is bound to the special system menu. Only one **PopupMenu** can be bound to each special menu at a time.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
方法說明
--------
.. _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>`
根據 **PopupMenu** 的捷徑和加速器檢查提供的 ``event``\ ，並啟動具有配對事件的第一個專案。如果 ``for_global_only`` 為 ``true``\ ，只有 ``global`` 設定為 ``true`` 的捷徑和加速器才會被呼叫。
如果專案已成功激活，則傳回 ``true``\ 。
\ **注意：**\ 某些\ :ref:`Control<class_Control>`\ ，例如\ :ref:`MenuButton<class_MenuButton>`\ ，會自動呼叫此方法。
.. 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>`
新增一個帶有文字 ``label`` 的新的可勾選項。
可以選擇提供一個 ``id`` 以及一個加速器（\ ``accel``\ ）。如果未提供 ``id``\ ，將從索引中建立一個。如果未提供 ``accel``\ ，則預設值 0（對應於 :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`\ ）將被分配給該項（這意味著它不會有任何加速器）。有關加速器的更多資訊，請參閱 :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>`\ 。
\ **注意：**\ 可勾選的項只顯示一個勾選標記，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。有關如何控制它的更多資訊，請參閱 :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>`\ 。
.. 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>`
新增一個新的可勾選項並為其分配指定的 :ref:`Shortcut<class_Shortcut>`\ 。將核取方塊的標籤設定為 :ref:`Shortcut<class_Shortcut>` 的名稱。
可以選擇提供一個 ``id``\ 。如果未提供 ``id``\ ，將從索引中建立一個。
\ **注意：**\ 可勾選項只顯示一個勾選標記，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。有關如何控制它的更多資訊，請參閱 :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>`\ 。
.. 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>`
新增一個帶有文字 ``label`` 和圖示 ``texture`` 的新的可勾選項。
可以選擇提供一個 ``id`` 以及一個加速器（\ ``accel``\ ）。如果未提供 ``id``\ ，將從索引中建立一個。如果未提供 ``accel``\ ，則預設值 0（對應於 :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`\ ）將被分配給該項（這意味著它不會有任何加速器）。有關加速器的更多資訊，請參閱 :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>`\ 。
\ **注意：**\ 可勾選項只顯示一個勾選標記，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。有關如何控制它的更多資訊，請參閱 :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>`\ 。
.. 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>`
新增一個新的可勾選項並為其分配指定的 :ref:`Shortcut<class_Shortcut>` 和圖示 ``texture``\ 。將複選框的標籤設定為 :ref:`Shortcut<class_Shortcut>` 的名稱。
可以選擇提供一個 ``id``\ 。如果未提供 ``id``\ ，將從索引中建立一個。
\ **注意：**\ 可勾選項只顯示一個勾選標記，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。有關如何控制它的更多資訊，請參閱 :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>`\ 。
.. 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>`
新增帶有文字 ``label`` 和圖示 ``texture`` 的新功能表專案。
還可以提供 ``id`` 和快捷鍵（\ ``accel``\ ）。如果沒有提供 ``id``\ ，則會根據索引來建立。如果沒有提供 ``accel``\ ，則會為該功能表專案分配預設的 0（對應 :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`\ ，在這裡表示沒有快捷鍵）。更多快捷鍵相關的信息見 :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>`\ 。
.. 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>`
與 :ref:`add_icon_check_item()<class_PopupMenu_method_add_icon_check_item>` 相同，但使用選項按鈕。
.. 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>`
與 :ref:`add_icon_check_shortcut()<class_PopupMenu_method_add_icon_check_shortcut>` 相同，但使用一個選項按鈕。
.. 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>`
新增新的功能表專案，並為其分配指定的 :ref:`Shortcut<class_Shortcut>` 和圖示 ``texture``\ 。核取方塊的標籤會被設為 :ref:`Shortcut<class_Shortcut>` 的名稱。
還可以提供 ``id``\ 。如果沒有提供 ``id``\ ，則會根據索引來建立。
.. 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>`
新增一個帶有文字 ``label`` 的新項。
可以選擇提供一個 ``id`` 以及一個加速器（\ ``accel``\ ）。如果未提供 ``id``\ ，將從索引中建立一個。如果未提供 ``accel``\ ，則預設值 0（對應於 :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`\ ）將被分配給該項（這意味著它不會有任何加速器）。有關加速器的更多資訊，請參閱 :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>`\ 。
\ **注意：**\ 提供的 ``id`` 僅用於 :ref:`id_pressed<class_PopupMenu_signal_id_pressed>` 和 :ref:`id_focused<class_PopupMenu_signal_id_focused>` 訊號。它與在函式中，例如在 :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>` 中的 ``index`` 參數無關。
.. 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>`
Adds a new multistate item with text ``label``.
Contrarily to normal binary items, multistate items can have more than two states, as defined by ``max_states``. The default value is defined by ``default_state``.
An ``id`` can optionally be provided, as well as an accelerator (``accel``). If no ``id`` is provided, one will be created from the index. If no ``accel`` is provided, then the default value of 0 (corresponding to :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`) will be assigned to the item (which means it won't have any accelerator). See :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` for more info on accelerators.
::
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("First state")
1:
print("Second state")
2:
print("Third state")
)
\ **Note:** Multistate items don't update their state automatically and must be done manually. See :ref:`toggle_item_multistate()<class_PopupMenu_method_toggle_item_multistate>`, :ref:`set_item_multistate()<class_PopupMenu_method_set_item_multistate>` and :ref:`get_item_multistate()<class_PopupMenu_method_get_item_multistate>` for more info on how to control it.
.. 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>`
新增一個帶有文字 ``label`` 的新單選勾選按鈕。
可以選擇提供一個 ``id`` 以及一個加速器（\ ``accel``\ ）。如果未提供 ``id``\ ，將從索引中建立一個。如果未提供 ``accel``\ ，則預設值 0（對應於 :ref:`@GlobalScope.KEY_NONE<class_@GlobalScope_constant_KEY_NONE>`\ ）將被分配給該項（這意味著它不會有任何加速器）。有關加速器的更多資訊，請參閱 :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>`\ 。
\ **注意：**\ 可勾選項只顯示一個勾選標記，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。有關如何控制它的更多資訊，請參閱 :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>`\ 。
.. 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>`
新增一個新的單選勾選按鈕並為其分配一個 :ref:`Shortcut<class_Shortcut>`\ 。將核取方塊的標籤設定為 :ref:`Shortcut<class_Shortcut>` 的名稱。
可以選擇提供一個 ``id``\ 。如果未提供 ``id``\ ，將從索引中建立一個。
\ **注意：**\ 可勾選項只顯示一個勾選標記，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。有關如何控制它的更多資訊，請參閱 :ref:`set_item_checked()<class_PopupMenu_method_set_item_checked>`\ 。
.. 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>`
在功能表專案之間新增分隔線。分隔線也佔用索引，可以使用 ``id`` 參數設定。
還可以提供 ``label``\ ，會在分隔線的中間位置顯示。
.. 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>`
新增 :ref:`Shortcut<class_Shortcut>`\ 。
還可以提供 ``id``\ 。如果沒有提供 ``id``\ ，則會根據索引來建立。
.. 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>`
**已棄用：** Prefer using :ref:`add_submenu_node_item()<class_PopupMenu_method_add_submenu_node_item>` instead.
Adds an item that will act as a submenu of the parent **PopupMenu** node when clicked. The ``submenu`` argument must be the name of an existing **PopupMenu** that has been added as a child to this node. This submenu will be shown when the item is clicked, hovered for long enough, or activated using the ``ui_select`` or ``ui_right`` input actions.
An ``id`` can optionally be provided. If no ``id`` is provided, one will be created from the index.
.. 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>`
Adds an item that will act as a submenu of the parent **PopupMenu** node when clicked. This submenu will be shown when the item is clicked, hovered for long enough, or activated using the ``ui_select`` or ``ui_right`` input actions.
\ ``submenu`` must be either child of this **PopupMenu** or has no parent node (in which case it will be automatically added as a child). If the ``submenu`` popup has another parent, this method will fail.
An ``id`` can optionally be provided. If no ``id`` is provided, one will be created from the index.
.. 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>`
從 **PopupMenu** 刪除所有專案。如果 ``free_submenus`` 為 ``true``\ ，則自動釋放子選單節點。
.. 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>`
返回目前焦點專案的索引。如果沒有焦點，則返回 ``-1``\ 。
.. 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>`
返回給定 ``index`` 處專案的加速器。加速器是一種鍵盤快捷鍵，即使目前未打開功能表按鈕，也可以按下它來觸發功能表按鈕。返回值是一個整數，通常是 :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` 和 :ref:`Key<enum_@GlobalScope_Key>` 使用按位元或操作的組合，例如 ``KEY_MASK_CTRL | KEY_A``\ （\ :kbd:`Ctrl + A`\ ）。如果沒有為指定的 ``index`` 定義加速器，則 :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>` 返回 ``0``\ （對應於 :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>`
Returns the auto translate mode of the item at the given ``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>`
返回給定 ``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>`
返回給定 ``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>`
返回給定 ``index`` 處用於調變功能表專案圖示的 :ref:`Color<class_Color>`\ 。
.. 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>`
返回給定 ``index`` 處功能表專案的 ID。\ ``id`` 可以手動分配，而索引則不能。
.. 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>`
返回給定 ``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>`
返回包含指定 ``id`` 的功能表專案的索引。索引由引擎自動分配給各個專案，無法手動設定。
.. 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>`
返回專案文字的語言程式碼。
.. 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>`
返回指定功能表專案的中繼資料，可能是任何型別。可以使用 :ref:`set_item_metadata()<class_PopupMenu_method_set_item_metadata>` 來設定中繼資料，這樣就能很很方便地將本文資料分配給功能表專案。
.. 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>`
Returns the state of the item at the given ``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>`
Returns the max states of the item at the given ``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>`
返回給定 ``index`` 處功能表專案所關聯的 :ref:`Shortcut<class_Shortcut>`\ 。
.. 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>`
**已棄用：** Prefer using :ref:`get_item_submenu_node()<class_PopupMenu_method_get_item_submenu_node>` instead.
返回給定 ``index`` 處功能表專案的子功能表名稱。有關如何新增子功能表的更多資訊，請參見 :ref:`add_submenu_item()<class_PopupMenu_method_add_submenu_item>`\ 。
.. 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>`
Returns the submenu of the item at the given ``index``, or ``null`` if no submenu was added. See :ref:`add_submenu_node_item()<class_PopupMenu_method_add_submenu_node_item>` for more info on how to add a submenu.
.. 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>`
返回索引為 ``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>`
返回專案文字的基礎書寫方向。
.. 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>`
返回索引為 ``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>`
如果給定 ``index`` 處的功能表專案可以某種方式勾選，即如果它有一個核取方塊或單選按鈕，則返回 ``true``\ 。
\ **注意：**\ 可勾選項僅顯示一個勾選標記或選項按鈕，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。
.. 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>`
如果給定的 ``index`` 處的功能表專案被勾選，則返回 ``true``\ 。
.. 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>`
如果給定 ``index`` 處的功能表專案被禁用，則返回 ``true``\ 。功能表專案被禁用時無法被選擇，對應的動作也無法被呼叫。
有關如何禁用功能表專案的更多資訊，請參閱 :ref:`set_item_disabled()<class_PopupMenu_method_set_item_disabled>`\ 。
.. 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>`
如果給定 ``index`` 處的功能表專案具有選項按鈕樣式的可勾選性，則返回 ``true``\ 。
\ **注意：**\ 這純粹是裝飾性的；必須新增用於單選組中勾選/取消勾選專案的邏輯。
.. 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>`
如果功能表專案是分隔符號，則返回 ``true``\ 。分隔符號會顯示為一條線。有關如何新增分隔符號的更多資訊，請參閱 :ref:`add_separator()<class_PopupMenu_method_add_separator>`\ 。
.. 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>`
如果指定功能表專案的快捷方式被禁用，則返回 ``true``\ 。
.. 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>`
Returns ``true`` if the system native menu is supported and currently used by this **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>`
Returns ``true`` if the menu is bound to the special system menu.
.. 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>`
從選單中移除給定 ``index`` 處的功能表專案。
\ **注意：**\ 被移除的功能表專案後面的功能表專案的索引將移動一位元。
.. 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>`
移動滾動視圖，使位於給定 ``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>`
將目前聚焦的功能表專案設定為給定的 ``index``\ 。
將 ``-1`` 作為索引傳入將不會聚焦任何功能表專案。
.. 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>`
在給定的 ``index`` 處設定專案的加速器。加速器是一種鍵盤快捷鍵，即使目前未打開功能表按鈕，也可以按下它來觸發功能表按鈕。\ ``accel`` 通常是 :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` 和 :ref:`Key<enum_@GlobalScope_Key>` 使用按位元或操作的組合，例如 ``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>`
設定給定 ``index`` 處的項是否具有一個核取方塊。如果為 ``false``\ ，則將項的型別設定為純文字。
\ **注意：**\ 可勾選的項只顯示一個核取記號，但沒有任何內建的勾選行為，必須手動勾選/取消勾選。
.. 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>`
將給定 ``index`` 處的項的型別設定為一個選項按鈕。如果為 ``false``\ ，則將項的型別設定為純文字。
.. 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>`
將給定 ``index`` 處的項標記為分隔符號，這意味著它將顯示為直線段。如果為 ``false``\ ，則將項的型別設定為純文字。
.. 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>`
Sets the auto translate mode of the item at the given ``index``.
Items use :ref:`Node.AUTO_TRANSLATE_MODE_INHERIT<class_Node_constant_AUTO_TRANSLATE_MODE_INHERIT>` by default, which uses the same auto translate mode as the **PopupMenu** itself.
.. 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>`
設定位於給定的 ``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>`
啟用/禁用位於給定 ``index`` 的功能表專案。處於禁用狀態的功能表專案無法被選中，也無法呼叫其動作。
.. 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>`
替換索引為 ``index`` 的功能表專案的 :ref:`Texture2D<class_Texture2D>` 圖示。
.. 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>`
設定給定 ``index`` 處功能表專案所允許的最大圖示寬度。這是在圖示預設大小和 :ref:`icon_max_width<class_PopupMenu_theme_constant_icon_max_width>` 的基礎上的限制。高度會根據圖示的長寬比調整。
.. 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>`
設定索引為 ``index`` 的功能表專案圖示的調變 :ref:`Color<class_Color>`\ 。
.. 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>`
設定位於給定 ``index`` 的功能表專案的 ``id``\ 。
\ :ref:`id_pressed<class_PopupMenu_signal_id_pressed>` 和 :ref:`id_focused<class_PopupMenu_signal_id_focused>` 等訊號中會用到 ``id``\ 。
.. 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>`
設定索引為 ``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>`
設定項的中繼資料，該項可以是任何型別。稍後你可以使用\ :ref:`get_item_metadata()<class_PopupMenu_method_get_item_metadata>`\ 獲取它，它提供了一種將本文資料分配給項的簡單方法。
.. 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>`
設定一個多態專案的狀態。詳情請參閱 :ref:`add_multistate_item()<class_PopupMenu_method_add_multistate_item>`\ 。
.. 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>`
Sets the max states of a multistate item. See :ref:`add_multistate_item()<class_PopupMenu_method_add_multistate_item>` for details.
.. 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>`
設定索引為 ``index`` 的功能表專案的 :ref:`Shortcut<class_Shortcut>`\ 。
.. 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>`
禁用索引為 ``index`` 的功能表專案的 :ref:`Shortcut<class_Shortcut>`\ 。
.. 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>`
**已棄用：** Prefer using :ref:`set_item_submenu_node()<class_PopupMenu_method_set_item_submenu_node>` instead.
設定位於給定 ``index`` 的功能表專案的子功能表。子功能表為點擊該功能表專案後應該顯示的子 **PopupMenu** 節點的名稱。
.. 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>`
Sets the submenu of the item at the given ``index``. The submenu is a **PopupMenu** node that would be shown when the item is clicked. It must either be a child of this **PopupMenu** or has no parent (in which case it will be automatically added as a child). If the ``submenu`` popup has another parent, this method will fail.
.. 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>`
設定索引為 ``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>`
設定專案文字的基礎書寫方向。
.. 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>`
設定索引為 ``index`` 的功能表專案的 :ref:`String<class_String>` 工具提示。
.. 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>`
切換索引為 ``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>`
迴圈到一個多態專案的下一個狀態。詳情請參閱 :ref:`add_multistate_item()<class_PopupMenu_method_add_multistate_item>`\ 。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
主題屬性說明
------------
.. _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>`
文字 :ref:`Color<class_Color>` 用於快捷鍵和加速器，當定義時顯示在功能表專案名稱旁邊。有關加速器的更多信息，請參閱 :ref:`get_item_accelerator()<class_PopupMenu_method_get_item_accelerator>`\ 。
.. 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>`
功能表專案名稱的預設文字 :ref:`Color<class_Color>`\ 。
.. 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>`
用於禁用功能表專案的文字 :ref:`Color<class_Color>`\ 。
.. 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>`
用於懸停文字的 :ref:`Color<class_Color>`\ 。
.. 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>`
功能表專案文字輪廓的色調。
.. 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>`
用於標注分隔符號文字的顏色 :ref:`Color<class_Color>`\ 。見 :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>`
帶標籤分隔符號的文字輪廓的色調。
.. 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>`
功能表專案元素之間的水平間距。
.. 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>`
功能表專案圖示所允許的最大寬度。這是在圖示預設大小的基礎上的限制，在 :ref:`set_item_icon_max_width()<class_PopupMenu_method_set_item_icon_max_width>` 所設定的值之前生效。高度會根據圖示的長寬比調整。
.. 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>`
單個縮進級別的寬度。
.. 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>`
所有功能表專案右側的水平內邊距（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>`
所有功能表專案左側的水平內邊距（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>`
專案文字輪廓的大小。
\ **注意：**\ 如果使用啟用了 :ref:`FontFile.multichannel_signed_distance_field<class_FontFile_property_multichannel_signed_distance_field>` 的字形，其 :ref:`FontFile.msdf_pixel_range<class_FontFile_property_msdf_pixel_range>` 必須至少設定為 :ref:`outline_size<class_PopupMenu_theme_constant_outline_size>` 的\ *兩倍*\ ，輪廓算繪才能看起來正確。否則，輪廓可能會比預期的更早被切斷。
.. 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>`
帶標籤分隔符號的文字輪廓的大小。
.. 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>`
每個功能表專案之間的垂直間距。
.. 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>`
用於功能表專案的 :ref:`Font<class_Font>` 字形。
.. 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>`
用於帶文字分隔線的 :ref:`Font<class_Font>` 字形。
.. 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>`
帶標籤分隔符號的字形大小。
.. 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>`
功能表專案的字形大小。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於選中狀態的複選項。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於選中狀態的已禁用複選項。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於選中狀態的單選項。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於選中狀態的已禁用單選項。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於未選狀態的單選項。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於未選狀態的已禁用單選項。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於子功能表箭頭（用於從左至右佈局）。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於子功能表箭頭（用於從右至左佈局）。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於未選狀態的複選項。
.. 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>`
:ref:`Texture2D<class_Texture2D>` 圖示，用於處於未選狀態的已禁用複選項。
.. 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>`
當 **PopupMenu** 功能表專案被懸停時顯示的 :ref:`StyleBox<class_StyleBox>`\ 。
.. 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>`
用於標籤分隔器的左側 :ref:`StyleBox<class_StyleBox>`\ 。請參閱 :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>`
用於標籤分隔器的右側 :ref:`StyleBox<class_StyleBox>`\ 。請參閱 :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>`
:ref:`StyleBox<class_StyleBox>` for the background panel.
.. 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>`
用於分隔符號的 :ref:`StyleBox<class_StyleBox>`\ 。請參閱 :ref:`add_separator()<class_PopupMenu_method_add_separator>`\ 。
.. |virtual| replace:: :abbr:`virtual (本方法通常需要使用者覆寫才能生效。)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (本方法沒有副作用。不會修改該實例的任何成員變數。)`
.. |vararg| replace:: :abbr:`vararg (本方法除了這裡描述的參數外，還可以接受任意數量的參數。)`
.. |constructor| replace:: :abbr:`constructor (本方法用於建構一個型別。)`
.. |static| replace:: :abbr:`static (本方法無需實例即可呼叫，因此可以直接使用類別名稱呼叫。)`
.. |operator| replace:: :abbr:`operator (本方法描述將本型別作為左運算元時可用的有效運算子。)`
.. |bitfield| replace:: :abbr:`BitField (此值是由下列旗標組成的位元遮罩整數。)`
.. |void| replace:: :abbr:`void (無回傳值。)`
Reference in New Issue View Git Blame Copy Permalink