Struct gdnative_bindings_lily::PopupMenu

pub struct PopupMenu { /* fields omitted */ }

core class PopupMenu inherits Popup (unsafe).

Official documentation

See the documentation of this class in the Godot engine’s official documentation. The method descriptions are generated from it and typically contain code samples in GDScript, not Rust.

Memory management

Non reference counted objects such as the ones of this type are usually owned by the engine.

PopupMenu is a reference-only type. Persistent references can only exist in the unsafe Ref<PopupMenu> form.

In the cases where Rust code owns an object of this type, for example if the object was just created on the Rust side and not passed to the engine yet, ownership should be either given to the engine or the object must be manually destroyed using Ref::free, or Ref::queue_free if it is a Node.

Class hierarchy

PopupMenu inherits methods from:

• Popup
• Control
• CanvasItem
• Node
• Object

Safety

All types in the Godot API have “interior mutability” in Rust parlance. To enforce that the official thread-safety guidelines are followed, the typestate pattern is used in the Ref and TRef smart pointers, and the Instance API. The typestate Access in these types tracks whether the access is unique, shared, or exclusive to the current thread. For more information, see the type-level documentation on Ref.

Implementations

impl PopupMenu

pub fn new() -> Ref<Self, Unique>

Creates a new instance of this object.

Because this type is not reference counted, the lifetime of the returned object is not automatically managed.

Immediately after creation, the object is owned by the caller, and can be passed to the engine (in which case the engine will be responsible for destroying the object) or destroyed manually using Ref::free, or preferably Ref::queue_free if it is a Node.

pub fn add_check_item(&self, label: impl Into<GodotString>, id: i64, accel: i64)

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 [method 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 [method set_item_checked] for more info on how to control it.

Default Arguments

• id - -1
• accel - 0

pub fn add_check_shortcut(
    &self,
    shortcut: impl AsArg<ShortCut>,
    id: i64,
    global: bool
)

Adds a new checkable item and assigns the specified ShortCut to it. Sets the label of the checkbox to the 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 [method set_item_checked] for more info on how to control it.

Default Arguments

• id - -1
• global - false

pub fn add_icon_check_item(
    &self,
    texture: impl AsArg<Texture>,
    label: impl Into<GodotString>,
    id: i64,
    accel: i64
)

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 [method 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 [method set_item_checked] for more info on how to control it.

Default Arguments

• id - -1
• accel - 0

pub fn add_icon_check_shortcut(
    &self,
    texture: impl AsArg<Texture>,
    shortcut: impl AsArg<ShortCut>,
    id: i64,
    global: bool
)

Adds a new checkable item and assigns the specified ShortCut and icon texture to it. Sets the label of the checkbox to the 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 [method set_item_checked] for more info on how to control it.

Default Arguments

• id - -1
• global - false

pub fn add_icon_item(
    &self,
    texture: impl AsArg<Texture>,
    label: impl Into<GodotString>,
    id: i64,
    accel: i64
)

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 [method get_item_accelerator] for more info on accelerators.

Default Arguments

• id - -1
• accel - 0

pub fn add_icon_radio_check_item(
    &self,
    texture: impl AsArg<Texture>,
    label: impl Into<GodotString>,
    id: i64,
    accel: i64
)

Same as [method add_icon_check_item], but uses a radio check button.

Default Arguments

• id - -1
• accel - 0

pub fn add_icon_radio_check_shortcut(
    &self,
    texture: impl AsArg<Texture>,
    shortcut: impl AsArg<ShortCut>,
    id: i64,
    global: bool
)

Same as [method add_icon_check_shortcut], but uses a radio check button.

Default Arguments

• id - -1
• global - false

pub fn add_icon_shortcut(
    &self,
    texture: impl AsArg<Texture>,
    shortcut: impl AsArg<ShortCut>,
    id: i64,
    global: bool
)

Adds a new item and assigns the specified ShortCut and icon texture to it. Sets the label of the checkbox to the ShortCut’s name. An id can optionally be provided. If no id is provided, one will be created from the index.

Default Arguments

• id - -1
• global - false

pub fn add_item(&self, label: impl Into<GodotString>, id: i64, accel: i64)

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 [method get_item_accelerator] for more info on accelerators.

Default Arguments

• id - -1
• accel - 0

pub fn add_multistate_item(
    &self,
    label: impl Into<GodotString>,
    max_states: i64,
    default_state: i64,
    id: i64,
    accel: i64
)

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 [method get_item_accelerator] for more info on accelerators.

Default Arguments

• default_state - 0
• id - -1
• accel - 0

pub fn add_radio_check_item(
    &self,
    label: impl Into<GodotString>,
    id: i64,
    accel: i64
)

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 [method 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 [method set_item_checked] for more info on how to control it.

Default Arguments

• id - -1
• accel - 0

pub fn add_radio_check_shortcut(
    &self,
    shortcut: impl AsArg<ShortCut>,
    id: i64,
    global: bool
)

Adds a new radio check button and assigns a ShortCut to it. Sets the label of the checkbox to the 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 [method set_item_checked] for more info on how to control it.

Default Arguments

• id - -1
• global - false

pub fn add_separator(&self, label: impl Into<GodotString>, id: i64)

Adds a separator between items. Separators also occupy an index.

Default Arguments

• label - ""

pub fn add_shortcut(
    &self,
    shortcut: impl AsArg<ShortCut>,
    id: i64,
    global: bool
)

Adds a ShortCut. An id can optionally be provided. If no id is provided, one will be created from the index.

Default Arguments

• id - -1
• global - false

pub fn add_submenu_item(
    &self,
    label: impl Into<GodotString>,
    submenu: impl Into<GodotString>,
    id: i64
)

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.

Default Arguments

• id - -1

pub fn clear(&self)

Removes all items from the PopupMenu.

pub fn allow_search(&self) -> bool

If true, allows to navigate PopupMenu with letter keys.

pub fn get_current_index(&self) -> i64

pub fn get_item_accelerator(&self, idx: i64) -> i64

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.

pub fn get_item_count(&self) -> i64

Returns the number of items in the PopupMenu.

pub fn get_item_icon(&self, idx: i64) -> Option<Ref<Texture, Shared>>

Returns the icon of the item at index idx.

pub fn get_item_id(&self, idx: i64) -> i64

Returns the id of the item at index idx. id can be manually assigned, while index can not.

pub fn get_item_index(&self, id: i64) -> i64

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.

pub fn get_item_metadata(&self, idx: i64) -> Variant

Returns the metadata of the specified item, which might be of any type. You can set it with [method set_item_metadata], which provides a simple way of assigning context data to items.

pub fn get_item_shortcut(&self, idx: i64) -> Option<Ref<ShortCut, Shared>>

Returns the ShortCut associated with the specified idx item.

pub fn get_item_submenu(&self, idx: i64) -> GodotString

Returns the submenu name of the item at index idx. See [method add_submenu_item] for more info on how to add a submenu.

pub fn get_item_text(&self, idx: i64) -> GodotString

Returns the text of the item at index idx.

pub fn get_item_tooltip(&self, idx: i64) -> GodotString

Returns the tooltip associated with the specified index index idx.

pub fn submenu_popup_delay(&self) -> f64

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.

pub fn is_hide_on_checkable_item_selection(&self) -> bool

If true, hides the PopupMenu when a checkbox or radio button is selected.

pub fn is_hide_on_item_selection(&self) -> bool

If true, hides the PopupMenu when an item is selected.

pub fn is_hide_on_state_item_selection(&self) -> bool

If true, hides the PopupMenu when a state item is selected.

pub fn is_hide_on_window_lose_focus(&self) -> bool

Returns true if the popup will be hidden when the window loses focus or not.

pub fn is_item_checkable(&self, idx: i64) -> bool

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.

pub fn is_item_checked(&self, idx: i64) -> bool

Returns true if the item at index idx is checked.

pub fn is_item_disabled(&self, idx: i64) -> bool

Returns true if the item at index idx is disabled. When it is disabled it can’t be selected, or its action invoked. See [method set_item_disabled] for more info on how to disable an item.

pub fn is_item_radio_checkable(&self, idx: i64) -> bool

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.

pub fn is_item_separator(&self, idx: i64) -> bool

Returns true if the item is a separator. If it is, it will be displayed as a line. See [method add_separator] for more info on how to add a separator.

pub fn is_item_shortcut_disabled(&self, idx: i64) -> bool

Returns true if the specified item’s shortcut is disabled.

pub fn remove_item(&self, idx: i64)

Removes the item at index idx from the menu. Note: The indices of items after the removed item will be shifted by one.

pub fn set_allow_search(&self, allow: bool)

If true, allows to navigate PopupMenu with letter keys.

pub fn set_hide_on_checkable_item_selection(&self, enable: bool)

If true, hides the PopupMenu when a checkbox or radio button is selected.

pub fn set_hide_on_item_selection(&self, enable: bool)

If true, hides the PopupMenu when an item is selected.

pub fn set_hide_on_state_item_selection(&self, enable: bool)

If true, hides the PopupMenu when a state item is selected.

pub fn set_hide_on_window_lose_focus(&self, enable: bool)

Hides the PopupMenu when the window loses focus.

pub fn set_item_accelerator(&self, idx: i64, accel: i64)

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.

pub fn set_item_as_checkable(&self, idx: i64, enable: bool)

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.

pub fn set_item_as_radio_checkable(&self, idx: i64, enable: bool)

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.

pub fn set_item_as_separator(&self, idx: i64, enable: bool)

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.

pub fn set_item_checked(&self, idx: i64, checked: bool)

Sets the checkstate status of the item at index idx.

pub fn set_item_disabled(&self, idx: i64, disabled: bool)

Enables/disables the item at index idx. When it is disabled, it can’t be selected and its action can’t be invoked.

pub fn set_item_icon(&self, idx: i64, icon: impl AsArg<Texture>)

Replaces the Texture icon of the specified idx.

pub fn set_item_id(&self, idx: i64, id: i64)

Sets the id of the item at index idx.

pub fn set_item_metadata(&self, idx: i64, metadata: impl OwnedToVariant)

Sets the metadata of an item, which may be of any type. You can later get it with [method get_item_metadata], which provides a simple way of assigning context data to items.

pub fn set_item_multistate(&self, idx: i64, state: i64)

Sets the state of an multistate item. See [method add_multistate_item] for details.

pub fn set_item_shortcut(
    &self,
    idx: i64,
    shortcut: impl AsArg<ShortCut>,
    global: bool
)

Sets a ShortCut for the specified item idx.

Default Arguments

• global - false

pub fn set_item_shortcut_disabled(&self, idx: i64, disabled: bool)

Disables the ShortCut of the specified index idx.

pub fn set_item_submenu(&self, idx: i64, submenu: impl Into<GodotString>)

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.

pub fn set_item_text(&self, idx: i64, text: impl Into<GodotString>)

Sets the text of the item at index idx.

pub fn set_item_tooltip(&self, idx: i64, tooltip: impl Into<GodotString>)

Sets the String tooltip of the item at the specified index idx.

pub fn set_submenu_popup_delay(&self, seconds: f64)

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.

pub fn toggle_item_checked(&self, idx: i64)

Toggles the check state of the item of the specified index idx.

pub fn toggle_item_multistate(&self, idx: i64)

Cycle to the next state of an multistate item. See [method add_multistate_item] for details.

Methods from Deref<Target = Popup>

pub const NOTIFICATION_POPUP_HIDE: i64

pub const NOTIFICATION_POST_POPUP: i64

pub fn is_exclusive(&self) -> bool

If true, the popup will not be hidden when a click event occurs outside of it, or when it receives the ui_cancel action event. Note: Enabling this property doesn’t affect the Close or Cancel buttons’ behavior in dialogs that inherit from this class. As a workaround, you can use [method WindowDialog.get_close_button] or [method ConfirmationDialog.get_cancel] and hide the buttons in question by setting their [member CanvasItem.visible] property to false.

pub fn popup(&self, bounds: Rect2)

Popup (show the control in modal form).

Default Arguments

• bounds - Rect2( 0, 0, 0, 0 )

pub fn popup_centered(&self, size: Vector2)

Popup (show the control in modal form) in the center of the screen relative to its current canvas transform, at the current size, or at a size determined by size.

Default Arguments

• size - Vector2( 0, 0 )

pub fn popup_centered_clamped(&self, size: Vector2, fallback_ratio: f64)

Popup (show the control in modal form) in the center of the screen relative to the current canvas transform, clamping the size to size, then ensuring the popup is no larger than the viewport size multiplied by fallback_ratio.

Default Arguments

• size - Vector2( 0, 0 )
• fallback_ratio - 0.75

pub fn popup_centered_minsize(&self, minsize: Vector2)

Popup (show the control in modal form) in the center of the screen relative to the current canvas transform, ensuring the size is never smaller than minsize.

Default Arguments

• minsize - Vector2( 0, 0 )

pub fn popup_centered_ratio(&self, ratio: f64)

Popup (show the control in modal form) in the center of the screen relative to the current canvas transform, scaled at a ratio of size of the screen.

Default Arguments

• ratio - 0.75

pub fn set_as_minsize(&self)

Shrink popup to keep to the minimum size of content.

pub fn set_exclusive(&self, enable: bool)

If true, the popup will not be hidden when a click event occurs outside of it, or when it receives the ui_cancel action event. Note: Enabling this property doesn’t affect the Close or Cancel buttons’ behavior in dialogs that inherit from this class. As a workaround, you can use [method WindowDialog.get_close_button] or [method ConfirmationDialog.get_cancel] and hide the buttons in question by setting their [member CanvasItem.visible] property to false.

Trait Implementations

impl Debug for PopupMenu

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for PopupMenu

type Target = Popup

The resulting type after dereferencing.

fn deref(&self) -> &Popup

Dereferences the value.

impl DerefMut for PopupMenu

fn deref_mut(&mut self) -> &mut Popup

Mutably dereferences the value.

impl GodotObject for PopupMenu

type RefKind = ManuallyManaged

The memory management kind of this type. This modifies the behavior of the Ref smart pointer. See its type-level documentation for more information.

fn class_name() -> &'static str

fn null() -> Null<Self>

Creates an explicitly null reference of Self as a method argument. This makes type inference easier for the compiler compared to Option.

fn new() -> Ref<Self, Unique> where
    Self: Instanciable, 

Creates a new instance of Self using a zero-argument constructor, as a Unique reference.

fn cast<T>(&self) -> Option<&T> where
    T: GodotObject + SubClass<Self>, 

Performs a dynamic reference downcast to target type.

fn upcast<T>(&self) -> &T where
    Self: SubClass<T>,
    T: GodotObject, 

Performs a static reference upcast to a supertype that is guaranteed to be valid.

unsafe fn assume_shared(&self) -> Ref<Self, Shared>

Creates a persistent reference to the same Godot object with shared thread access.

unsafe fn assume_thread_local(&self) -> Ref<Self, ThreadLocal> where
    Self: GodotObject<RefKind = RefCounted>, 

Creates a persistent reference to the same Godot object with thread-local thread access.

unsafe fn assume_unique(&self) -> Ref<Self, Unique>

Creates a persistent reference to the same Godot object with unique access.

unsafe fn try_from_instance_id<'a>(id: i64) -> Option<TRef<'a, Self, Shared>>

Recovers a instance ID previously returned by Object::get_instance_id if the object is still alive. See also TRef::try_from_instance_id.

unsafe fn from_instance_id<'a>(id: i64) -> TRef<'a, Self, Shared>

Recovers a instance ID previously returned by Object::get_instance_id if the object is still alive, and panics otherwise. This does NOT guarantee that the resulting reference is safe to use.

impl Instanciable for PopupMenu

fn construct() -> Ref<Self, Unique>

impl QueueFree for PopupMenu

unsafe fn godot_queue_free(obj: *mut godot_object)

impl Sealed for PopupMenu

impl SubClass<CanvasItem> for PopupMenu

impl SubClass<Control> for PopupMenu

impl SubClass<Node> for PopupMenu

impl SubClass<Object> for PopupMenu

impl SubClass<Popup> for PopupMenu