:github_url: hide .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. .. Generator: https://github.com/godotengine/godot/tree/3.6/doc/tools/make_rst.py. .. XML source: https://github.com/godotengine/godot/tree/3.6/doc/classes/PopupMenu.xml. .. _class_PopupMenu: PopupMenu ========= **Inherits:** :ref:`Popup` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` PopupMenu displays a list of options. .. rst-class:: classref-introduction-group Description ----------- **PopupMenu** is a :ref:`Control` that displays a list of options. They are popular in toolbars or context menus. \ **Incremental search:** Like :ref:`ItemList` and :ref:`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`. \ **Note:** The ID values used for items are limited to 32 bits, not full 64 bits of :ref:`int`. This has a range of ``-2^32`` to ``2^32 - 1``, i.e. ``-2147483648`` to ``2147483647``. .. rst-class:: classref-reftable-group Properties ---------- .. table:: :widths: auto +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`bool` | :ref:`allow_search` | ``false`` | +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`bool` | :ref:`hide_on_checkable_item_selection` | ``true`` | +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`bool` | :ref:`hide_on_item_selection` | ``true`` | +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`bool` | :ref:`hide_on_state_item_selection` | ``false`` | +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`float` | :ref:`max_height` | ``0.0`` | +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`float` | :ref:`submenu_popup_delay` | ``0.3`` | +------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Methods ------- .. table:: :widths: auto +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_check_item` **(** :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_check_shortcut` **(** :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_icon_check_item` **(** :ref:`Texture` texture, :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_icon_check_shortcut` **(** :ref:`Texture` texture, :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_icon_item` **(** :ref:`Texture` texture, :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_icon_radio_check_item` **(** :ref:`Texture` texture, :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_icon_radio_check_shortcut` **(** :ref:`Texture` texture, :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_icon_shortcut` **(** :ref:`Texture` texture, :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_item` **(** :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_multistate_item` **(** :ref:`String` label, :ref:`int` max_states, :ref:`int` default_state=0, :ref:`int` id=-1, :ref:`int` accel=0 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_radio_check_item` **(** :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_radio_check_shortcut` **(** :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_separator` **(** :ref:`String` label="", :ref:`int` id=-1 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_shortcut` **(** :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_submenu_item` **(** :ref:`String` label, :ref:`String` submenu, :ref:`int` id=-1 **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`clear` **(** **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_current_index` **(** **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_item_accelerator` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_item_count` **(** **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Texture` | :ref:`get_item_icon` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_item_id` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_item_index` **(** :ref:`int` id **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`get_item_metadata` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`ShortCut` | :ref:`get_item_shortcut` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_item_submenu` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_item_text` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_item_tooltip` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_hide_on_window_lose_focus` **(** **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_item_checkable` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_item_checked` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_item_disabled` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_item_radio_checkable` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_item_separator` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_item_shortcut_disabled` **(** :ref:`int` idx **)** |const| | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`remove_item` **(** :ref:`int` idx **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_current_index` **(** :ref:`int` index **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_hide_on_window_lose_focus` **(** :ref:`bool` enable **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_accelerator` **(** :ref:`int` idx, :ref:`int` accel **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_as_checkable` **(** :ref:`int` idx, :ref:`bool` enable **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_as_radio_checkable` **(** :ref:`int` idx, :ref:`bool` enable **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_as_separator` **(** :ref:`int` idx, :ref:`bool` enable **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_checked` **(** :ref:`int` idx, :ref:`bool` checked **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_disabled` **(** :ref:`int` idx, :ref:`bool` disabled **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_icon` **(** :ref:`int` idx, :ref:`Texture` icon **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_id` **(** :ref:`int` idx, :ref:`int` id **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_metadata` **(** :ref:`int` idx, :ref:`Variant` metadata **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_multistate` **(** :ref:`int` idx, :ref:`int` state **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_shortcut` **(** :ref:`int` idx, :ref:`ShortCut` shortcut, :ref:`bool` global=false **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_shortcut_disabled` **(** :ref:`int` idx, :ref:`bool` disabled **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_submenu` **(** :ref:`int` idx, :ref:`String` submenu **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_text` **(** :ref:`int` idx, :ref:`String` text **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_item_tooltip` **(** :ref:`int` idx, :ref:`String` tooltip **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`toggle_item_checked` **(** :ref:`int` idx **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`toggle_item_multistate` **(** :ref:`int` idx **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Theme Properties ---------------- .. table:: :widths: auto +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Color` | :ref:`font_color` | ``Color( 0.88, 0.88, 0.88, 1 )`` | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Color` | :ref:`font_color_accel` | ``Color( 0.7, 0.7, 0.7, 0.8 )`` | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Color` | :ref:`font_color_disabled` | ``Color( 0.4, 0.4, 0.4, 0.8 )`` | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Color` | :ref:`font_color_hover` | ``Color( 0.88, 0.88, 0.88, 1 )`` | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Color` | :ref:`font_color_separator` | ``Color( 0.88, 0.88, 0.88, 1 )`` | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`int` | :ref:`hseparation` | ``4`` | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`int` | :ref:`vseparation` | ``4`` | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Font` | :ref:`font` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Font` | :ref:`font_separator` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Texture` | :ref:`checked` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Texture` | :ref:`radio_checked` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Texture` | :ref:`radio_unchecked` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Texture` | :ref:`submenu` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`Texture` | :ref:`unchecked` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`StyleBox` | :ref:`hover` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`StyleBox` | :ref:`labeled_separator_left` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`StyleBox` | :ref:`labeled_separator_right` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`StyleBox` | :ref:`panel` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`StyleBox` | :ref:`panel_disabled` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ | :ref:`StyleBox` | :ref:`separator` | | +---------------------------------+-------------------------------------------------------------------------------------+----------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Signals ------- .. _class_PopupMenu_signal_id_focused: .. rst-class:: classref-signal **id_focused** **(** :ref:`int` id **)** Emitted when user navigated to an item of some ``id`` using ``ui_up`` or ``ui_down`` action. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_signal_id_pressed: .. rst-class:: classref-signal **id_pressed** **(** :ref:`int` id **)** Emitted when an item of some ``id`` is pressed or its accelerator is activated. \ **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** **(** :ref:`int` index **)** Emitted when an item of some ``index`` is pressed or its accelerator is activated. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Property Descriptions --------------------- .. _class_PopupMenu_property_allow_search: .. rst-class:: classref-property :ref:`bool` **allow_search** = ``false`` .. rst-class:: classref-property-setget - void **set_allow_search** **(** :ref:`bool` value **)** - :ref:`bool` **get_allow_search** **(** **)** If ``true``, allows navigating **PopupMenu** with letter keys. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_property_hide_on_checkable_item_selection: .. rst-class:: classref-property :ref:`bool` **hide_on_checkable_item_selection** = ``true`` .. rst-class:: classref-property-setget - void **set_hide_on_checkable_item_selection** **(** :ref:`bool` value **)** - :ref:`bool` **is_hide_on_checkable_item_selection** **(** **)** If ``true``, hides the **PopupMenu** when a checkbox or radio button is selected. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_property_hide_on_item_selection: .. rst-class:: classref-property :ref:`bool` **hide_on_item_selection** = ``true`` .. rst-class:: classref-property-setget - void **set_hide_on_item_selection** **(** :ref:`bool` value **)** - :ref:`bool` **is_hide_on_item_selection** **(** **)** If ``true``, hides the **PopupMenu** when an item is selected. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_property_hide_on_state_item_selection: .. rst-class:: classref-property :ref:`bool` **hide_on_state_item_selection** = ``false`` .. rst-class:: classref-property-setget - void **set_hide_on_state_item_selection** **(** :ref:`bool` value **)** - :ref:`bool` **is_hide_on_state_item_selection** **(** **)** If ``true``, hides the **PopupMenu** when a state item is selected. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_property_max_height: .. rst-class:: classref-property :ref:`float` **max_height** = ``0.0`` .. rst-class:: classref-property-setget - void **set_max_height** **(** :ref:`float` value **)** - :ref:`float` **get_max_height** **(** **)** If non-zero, the ``PopupMenu`` will be resized vertically to that maximum value, showing a scrollbar if the content doesn't fit. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_property_submenu_popup_delay: .. rst-class:: classref-property :ref:`float` **submenu_popup_delay** = ``0.3`` .. rst-class:: classref-property-setget - void **set_submenu_popup_delay** **(** :ref:`float` value **)** - :ref:`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. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Method Descriptions ------------------- .. _class_PopupMenu_method_add_check_item: .. rst-class:: classref-method void **add_check_item** **(** :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** Adds a new checkable item with text ``label``. 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 ``0`` will be assigned to it. See :ref:`get_item_accelerator` for more info on accelerators. \ **Note:** Checkable items just display a checkmark, but don't have any built-in checking behavior and must be checked/unchecked manually. See :ref:`set_item_checked` for more info on how to control it. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_check_shortcut: .. rst-class:: classref-method void **add_check_shortcut** **(** :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** Adds a new checkable item and assigns the specified :ref:`ShortCut` to it. Sets the label of the checkbox to the :ref:`ShortCut`'s name. An ``id`` can optionally be provided. If no ``id`` is provided, one will be created from the index. \ **Note:** Checkable items just display a checkmark, but don't have any built-in checking behavior and must be checked/unchecked manually. See :ref:`set_item_checked` for more info on how to control it. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_icon_check_item: .. rst-class:: classref-method void **add_icon_check_item** **(** :ref:`Texture` texture, :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** Adds a new checkable item with text ``label`` and icon ``texture``. 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 ``0`` will be assigned to it. See :ref:`get_item_accelerator` for more info on accelerators. \ **Note:** Checkable items just display a checkmark, but don't have any built-in checking behavior and must be checked/unchecked manually. See :ref:`set_item_checked` for more info on how to control it. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_icon_check_shortcut: .. rst-class:: classref-method void **add_icon_check_shortcut** **(** :ref:`Texture` texture, :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** Adds a new checkable item and assigns the specified :ref:`ShortCut` and icon ``texture`` to it. Sets the label of the checkbox to the :ref:`ShortCut`'s name. An ``id`` can optionally be provided. If no ``id`` is provided, one will be created from the index. \ **Note:** Checkable items just display a checkmark, but don't have any built-in checking behavior and must be checked/unchecked manually. See :ref:`set_item_checked` for more info on how to control it. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_icon_item: .. rst-class:: classref-method void **add_icon_item** **(** :ref:`Texture` texture, :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** Adds a new item with text ``label`` and icon ``texture``. 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 ``0`` will be assigned to it. See :ref:`get_item_accelerator` for more info on accelerators. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_icon_radio_check_item: .. rst-class:: classref-method void **add_icon_radio_check_item** **(** :ref:`Texture` texture, :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** Same as :ref:`add_icon_check_item`, but uses a radio check button. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_icon_radio_check_shortcut: .. rst-class:: classref-method void **add_icon_radio_check_shortcut** **(** :ref:`Texture` texture, :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** Same as :ref:`add_icon_check_shortcut`, but uses a radio check button. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_icon_shortcut: .. rst-class:: classref-method void **add_icon_shortcut** **(** :ref:`Texture` texture, :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** Adds a new item and assigns the specified :ref:`ShortCut` and icon ``texture`` to it. Sets the label of the checkbox to the :ref:`ShortCut`'s name. 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_item: .. rst-class:: classref-method void **add_item** **(** :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** Adds a new item with text ``label``. 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 ``0`` will be assigned to it. See :ref:`get_item_accelerator` for more info on accelerators. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_multistate_item: .. rst-class:: classref-method void **add_multistate_item** **(** :ref:`String` label, :ref:`int` max_states, :ref:`int` default_state=0, :ref:`int` id=-1, :ref:`int` accel=0 **)** 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``. Each press or activate of the item will increase the state by one. 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 ``0`` will be assigned to it. See :ref:`get_item_accelerator` for more info on accelerators. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_radio_check_item: .. rst-class:: classref-method void **add_radio_check_item** **(** :ref:`String` label, :ref:`int` id=-1, :ref:`int` accel=0 **)** Adds a new radio check button with text ``label``. 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 ``0`` will be assigned to it. See :ref:`get_item_accelerator` for more info on accelerators. \ **Note:** Checkable items just display a checkmark, but don't have any built-in checking behavior and must be checked/unchecked manually. See :ref:`set_item_checked` for more info on how to control it. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_radio_check_shortcut: .. rst-class:: classref-method void **add_radio_check_shortcut** **(** :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** Adds a new radio check button and assigns a :ref:`ShortCut` to it. Sets the label of the checkbox to the :ref:`ShortCut`'s name. An ``id`` can optionally be provided. If no ``id`` is provided, one will be created from the index. \ **Note:** Checkable items just display a checkmark, but don't have any built-in checking behavior and must be checked/unchecked manually. See :ref:`set_item_checked` for more info on how to control it. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_separator: .. rst-class:: classref-method void **add_separator** **(** :ref:`String` label="", :ref:`int` id=-1 **)** Adds a separator between items. Separators also occupy an index, which you can set by using the ``id`` parameter. A ``label`` can optionally be provided, which will appear at the center of the separator. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_add_shortcut: .. rst-class:: classref-method void **add_shortcut** **(** :ref:`ShortCut` shortcut, :ref:`int` id=-1, :ref:`bool` global=false **)** Adds a :ref:`ShortCut`. 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_item: .. rst-class:: classref-method void **add_submenu_item** **(** :ref:`String` label, :ref:`String` submenu, :ref:`int` id=-1 **)** Adds an item that will act as a submenu of the parent **PopupMenu** node when clicked. The ``submenu`` argument is the name of the child **PopupMenu** node that will be shown when the item is clicked. 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** **(** **)** Removes all items from the **PopupMenu**. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_current_index: .. rst-class:: classref-method :ref:`int` **get_current_index** **(** **)** |const| Returns the index of the currently focused item. Returns ``-1`` if no item is focused. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_accelerator: .. rst-class:: classref-method :ref:`int` **get_item_accelerator** **(** :ref:`int` idx **)** |const| Returns the accelerator of the item at index ``idx``. Accelerators are special combinations of keys that activate the item, no matter which control is focused. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_count: .. rst-class:: classref-method :ref:`int` **get_item_count** **(** **)** |const| Returns the number of items in the **PopupMenu**. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_icon: .. rst-class:: classref-method :ref:`Texture` **get_item_icon** **(** :ref:`int` idx **)** |const| Returns the icon of the item at index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_id: .. rst-class:: classref-method :ref:`int` **get_item_id** **(** :ref:`int` idx **)** |const| Returns the id of the item at index ``idx``. ``id`` can be manually assigned, while index can not. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_index: .. rst-class:: classref-method :ref:`int` **get_item_index** **(** :ref:`int` id **)** |const| Returns the index of the item containing the specified ``id``. Index is automatically assigned to each item by the engine. Index can not be set manually. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_metadata: .. rst-class:: classref-method :ref:`Variant` **get_item_metadata** **(** :ref:`int` idx **)** |const| Returns the metadata of the specified item, which might be of any type. You can set it with :ref:`set_item_metadata`, which provides a simple way of assigning context data to items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_shortcut: .. rst-class:: classref-method :ref:`ShortCut` **get_item_shortcut** **(** :ref:`int` idx **)** |const| Returns the :ref:`ShortCut` associated with the specified ``idx`` item. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_submenu: .. rst-class:: classref-method :ref:`String` **get_item_submenu** **(** :ref:`int` idx **)** |const| Returns the submenu name of the item at index ``idx``. See :ref:`add_submenu_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` **get_item_text** **(** :ref:`int` idx **)** |const| Returns the text of the item at index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_get_item_tooltip: .. rst-class:: classref-method :ref:`String` **get_item_tooltip** **(** :ref:`int` idx **)** |const| Returns the tooltip associated with the specified index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_is_hide_on_window_lose_focus: .. rst-class:: classref-method :ref:`bool` **is_hide_on_window_lose_focus** **(** **)** |const| Returns ``true`` if the popup will be hidden when the window loses focus or not. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_is_item_checkable: .. rst-class:: classref-method :ref:`bool` **is_item_checkable** **(** :ref:`int` idx **)** |const| Returns ``true`` if the item at index ``idx`` is checkable in some way, i.e. if it has a checkbox or radio button. \ **Note:** Checkable items just display a checkmark or radio button, but don't have any built-in checking behavior and must be checked/unchecked manually. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_is_item_checked: .. rst-class:: classref-method :ref:`bool` **is_item_checked** **(** :ref:`int` idx **)** |const| Returns ``true`` if the item at index ``idx`` is checked. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_is_item_disabled: .. rst-class:: classref-method :ref:`bool` **is_item_disabled** **(** :ref:`int` idx **)** |const| Returns ``true`` if the item at index ``idx`` is disabled. When it is disabled it can't be selected, or its action invoked. See :ref:`set_item_disabled` for more info on how to disable an item. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_is_item_radio_checkable: .. rst-class:: classref-method :ref:`bool` **is_item_radio_checkable** **(** :ref:`int` idx **)** |const| Returns ``true`` if the item at index ``idx`` has radio button-style checkability. \ **Note:** This is purely cosmetic; you must add the logic for checking/unchecking items in radio groups. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_is_item_separator: .. rst-class:: classref-method :ref:`bool` **is_item_separator** **(** :ref:`int` idx **)** |const| Returns ``true`` if the item is a separator. If it is, it will be displayed as a line. See :ref:`add_separator` for more info on how to add a separator. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_is_item_shortcut_disabled: .. rst-class:: classref-method :ref:`bool` **is_item_shortcut_disabled** **(** :ref:`int` idx **)** |const| Returns ``true`` if the specified item's shortcut is disabled. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_remove_item: .. rst-class:: classref-method void **remove_item** **(** :ref:`int` idx **)** Removes the item at index ``idx`` from the menu. \ **Note:** The indices of items after the removed item will be shifted by one. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_current_index: .. rst-class:: classref-method void **set_current_index** **(** :ref:`int` index **)** Sets the currently focused item as the given ``index``. Passing ``-1`` as the index makes so that no item is focused. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_hide_on_window_lose_focus: .. rst-class:: classref-method void **set_hide_on_window_lose_focus** **(** :ref:`bool` enable **)** Hides the **PopupMenu** when the window loses focus. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_accelerator: .. rst-class:: classref-method void **set_item_accelerator** **(** :ref:`int` idx, :ref:`int` accel **)** Sets the accelerator of the item at index ``idx``. Accelerators are special combinations of keys that activate the item, no matter which control is focused. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_as_checkable: .. rst-class:: classref-method void **set_item_as_checkable** **(** :ref:`int` idx, :ref:`bool` enable **)** Sets whether the item at index ``idx`` has a checkbox. If ``false``, sets the type of the item to plain text. \ **Note:** Checkable items just display a checkmark, but don't have any built-in checking behavior and must be checked/unchecked manually. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_as_radio_checkable: .. rst-class:: classref-method void **set_item_as_radio_checkable** **(** :ref:`int` idx, :ref:`bool` enable **)** Sets the type of the item at the specified index ``idx`` to radio button. If ``false``, sets the type of the item to plain text. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_as_separator: .. rst-class:: classref-method void **set_item_as_separator** **(** :ref:`int` idx, :ref:`bool` enable **)** Mark the item at index ``idx`` as a separator, which means that it would be displayed as a line. If ``false``, sets the type of the item to plain text. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_checked: .. rst-class:: classref-method void **set_item_checked** **(** :ref:`int` idx, :ref:`bool` checked **)** Sets the checkstate status of the item at index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_disabled: .. rst-class:: classref-method void **set_item_disabled** **(** :ref:`int` idx, :ref:`bool` disabled **)** Enables/disables the item at index ``idx``. When it is disabled, it can't be selected and its action can't be invoked. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_icon: .. rst-class:: classref-method void **set_item_icon** **(** :ref:`int` idx, :ref:`Texture` icon **)** Replaces the :ref:`Texture` icon of the specified ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_id: .. rst-class:: classref-method void **set_item_id** **(** :ref:`int` idx, :ref:`int` id **)** Sets the ``id`` of the item at index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_metadata: .. rst-class:: classref-method void **set_item_metadata** **(** :ref:`int` idx, :ref:`Variant` metadata **)** Sets the metadata of an item, which may be of any type. You can later get it with :ref:`get_item_metadata`, which provides a simple way of assigning context data to items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_multistate: .. rst-class:: classref-method void **set_item_multistate** **(** :ref:`int` idx, :ref:`int` state **)** Sets the state of a multistate item. See :ref:`add_multistate_item` for details. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_shortcut: .. rst-class:: classref-method void **set_item_shortcut** **(** :ref:`int` idx, :ref:`ShortCut` shortcut, :ref:`bool` global=false **)** Sets a :ref:`ShortCut` for the specified item ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_shortcut_disabled: .. rst-class:: classref-method void **set_item_shortcut_disabled** **(** :ref:`int` idx, :ref:`bool` disabled **)** Disables the :ref:`ShortCut` of the specified index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_submenu: .. rst-class:: classref-method void **set_item_submenu** **(** :ref:`int` idx, :ref:`String` submenu **)** Sets the submenu of the item at index ``idx``. The submenu is the name of a child **PopupMenu** node that would be shown when the item is clicked. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_text: .. rst-class:: classref-method void **set_item_text** **(** :ref:`int` idx, :ref:`String` text **)** Sets the text of the item at index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_set_item_tooltip: .. rst-class:: classref-method void **set_item_tooltip** **(** :ref:`int` idx, :ref:`String` tooltip **)** Sets the :ref:`String` tooltip of the item at the specified index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_toggle_item_checked: .. rst-class:: classref-method void **toggle_item_checked** **(** :ref:`int` idx **)** Toggles the check state of the item of the specified index ``idx``. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_method_toggle_item_multistate: .. rst-class:: classref-method void **toggle_item_multistate** **(** :ref:`int` idx **)** Cycle to the next state of a multistate item. See :ref:`add_multistate_item` for details. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Theme Property Descriptions --------------------------- .. _class_PopupMenu_theme_color_font_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_color** = ``Color( 0.88, 0.88, 0.88, 1 )`` The default text :ref:`Color` for menu items' names. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_color_font_color_accel: .. rst-class:: classref-themeproperty :ref:`Color` **font_color_accel** = ``Color( 0.7, 0.7, 0.7, 0.8 )`` The text :ref:`Color` used for shortcuts and accelerators that show next to the menu item name when defined. See :ref:`get_item_accelerator` for more info on accelerators. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_color_font_color_disabled: .. rst-class:: classref-themeproperty :ref:`Color` **font_color_disabled** = ``Color( 0.4, 0.4, 0.4, 0.8 )`` :ref:`Color` used for disabled menu items' text. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_color_font_color_hover: .. rst-class:: classref-themeproperty :ref:`Color` **font_color_hover** = ``Color( 0.88, 0.88, 0.88, 1 )`` :ref:`Color` used for the hovered text. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_color_font_color_separator: .. rst-class:: classref-themeproperty :ref:`Color` **font_color_separator** = ``Color( 0.88, 0.88, 0.88, 1 )`` :ref:`Color` used for labeled separators' text. See :ref:`add_separator`. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_constant_hseparation: .. rst-class:: classref-themeproperty :ref:`int` **hseparation** = ``4`` The horizontal space between the item's name and the shortcut text/submenu arrow. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_constant_vseparation: .. rst-class:: classref-themeproperty :ref:`int` **vseparation** = ``4`` The vertical space between each menu item. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_font_font: .. rst-class:: classref-themeproperty :ref:`Font` **font** :ref:`Font` used for the menu items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_font_font_separator: .. rst-class:: classref-themeproperty :ref:`Font` **font_separator** :ref:`Font` used for the labeled separator. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_icon_checked: .. rst-class:: classref-themeproperty :ref:`Texture` **checked** :ref:`Texture` icon for the checked checkbox items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_icon_radio_checked: .. rst-class:: classref-themeproperty :ref:`Texture` **radio_checked** :ref:`Texture` icon for the checked radio button items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_icon_radio_unchecked: .. rst-class:: classref-themeproperty :ref:`Texture` **radio_unchecked** :ref:`Texture` icon for the unchecked radio button items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_icon_submenu: .. rst-class:: classref-themeproperty :ref:`Texture` **submenu** :ref:`Texture` icon for the submenu arrow. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_icon_unchecked: .. rst-class:: classref-themeproperty :ref:`Texture` **unchecked** :ref:`Texture` icon for the unchecked checkbox items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_style_hover: .. rst-class:: classref-themeproperty :ref:`StyleBox` **hover** :ref:`StyleBox` displayed when the **PopupMenu** item is hovered. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_style_labeled_separator_left: .. rst-class:: classref-themeproperty :ref:`StyleBox` **labeled_separator_left** :ref:`StyleBox` for the left side of labeled separator. See :ref:`add_separator`. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_style_labeled_separator_right: .. rst-class:: classref-themeproperty :ref:`StyleBox` **labeled_separator_right** :ref:`StyleBox` for the right side of labeled separator. See :ref:`add_separator`. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_style_panel: .. rst-class:: classref-themeproperty :ref:`StyleBox` **panel** Default :ref:`StyleBox` of the **PopupMenu** items. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_style_panel_disabled: .. rst-class:: classref-themeproperty :ref:`StyleBox` **panel_disabled** :ref:`StyleBox` used when the **PopupMenu** item is disabled. .. rst-class:: classref-item-separator ---- .. _class_PopupMenu_theme_style_separator: .. rst-class:: classref-themeproperty :ref:`StyleBox` **separator** :ref:`StyleBox` used for the separators. See :ref:`add_separator`. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)` .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)` .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)` .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`