MenuButton

Inherits: Button < BaseButton < Control < CanvasItem < Node < Object

A button that brings up a PopupMenu when clicked.

Description

A button that brings up a PopupMenu when clicked. To create new items inside this PopupMenu, use get_popup().add_item("My Item Name"). You can also create them directly from Godot editor’s inspector.

See also BaseButton which contains common properties and methods associated with this node.

Properties

ActionMode

action_mode

0 (overrides BaseButton)

bool

flat

true (overrides Button)

FocusMode

focus_mode

0 (overrides Control)

int

item_count

0

bool

switch_on_hover

false

bool

toggle_mode

true (overrides BaseButton)

Methods

PopupMenu

get_popup ( ) const

void

set_disable_shortcuts ( bool disabled )

void

show_popup ( )


Signals

about_to_popup ( )

Emitted when the PopupMenu of this MenuButton is about to show.


Property Descriptions

int item_count = 0

  • void set_item_count ( int value )

  • int get_item_count ( )

The number of items currently in the list.


bool switch_on_hover = false

  • void set_switch_on_hover ( bool value )

  • bool is_switch_on_hover ( )

If true, when the cursor hovers above another MenuButton within the same parent which also has switch_on_hover enabled, it will close the current MenuButton and open the other one.


Method Descriptions

PopupMenu get_popup ( ) const

Returns the PopupMenu contained in this button.

Warning: This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their Window.visible property.


void set_disable_shortcuts ( bool disabled )

If true, shortcuts are disabled and cannot be used to trigger the button.


void show_popup ( )

Adjusts popup position and sizing for the MenuButton, then shows the PopupMenu. Prefer this over using get_popup().popup().

Previous Next


© Copyright 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision 53e837c6.

Built with Sphinx using a theme provided by Read the Docs.