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¶
action_mode |
|
|
flat |
|
|
focus_mode |
|
|
|
||
|
||
toggle_mode |
|
Methods¶
get_popup ( ) const |
|
void |
set_disable_shortcuts ( bool disabled ) |
void |
show_popup ( ) |
Theme Properties¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
Signals¶
about_to_popup ( )
Emitted when the PopupMenu of this MenuButton is about to show.
Property Descriptions¶
int item_count = 0
The number of items currently in the list.
bool switch_on_hover = false
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