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 ( )

Theme Properties¶

Color	font_color	`Color(0.875, 0.875, 0.875, 1)`
Color	font_disabled_color	`Color(1, 1, 1, 0.3)`
Color	font_focus_color	`Color(0.95, 0.95, 0.95, 1)`
Color	font_hover_color	`Color(0.95, 0.95, 0.95, 1)`
Color	font_outline_color	`Color(1, 1, 1, 1)`
Color	font_pressed_color	`Color(1, 1, 1, 1)`
int	h_separation	`4`
int	outline_size	`0`
Font	font
int	font_size
StyleBox	disabled
StyleBox	focus
StyleBox	hover
StyleBox	normal
StyleBox	pressed

Signals¶

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¶

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.

Adjusts popup position and sizing for the MenuButton, then shows the