2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2019-04-01 10:33:56 +00:00
<class name= "MenuButton" inherits= "Button" category= "Core" version= "3.2" >
2017-09-12 20:42:36 +00:00
<brief_description >
Special button that brings up a [PopupMenu] when clicked.
</brief_description>
<description >
2020-01-23 10:14:14 +00:00
Special button that brings up a [PopupMenu] when clicked.
New items can be created inside this [PopupMenu] using [code]get_popup().add_item("My Item Name")[/code]. You can also create them directly from the editor. To do so, select the [MenuButton] node, then in the toolbar at the top of the 2D editor, click [b]Items[/b] then click [b]Add[/b] in the popup. You will be able to give each items new properties.
2017-09-12 20:42:36 +00:00
</description>
<tutorials >
</tutorials>
<methods >
2017-12-25 16:03:53 +00:00
<method name= "get_popup" qualifiers= "const" >
2017-09-12 20:42:36 +00:00
<return type= "PopupMenu" >
</return>
<description >
2019-05-24 02:15:43 +00:00
Returns the [PopupMenu] contained in this button.
2017-09-12 20:42:36 +00:00
</description>
</method>
2018-01-03 12:45:03 +00:00
<method name= "set_disable_shortcuts" >
<return type= "void" >
</return>
<argument index= "0" name= "disabled" type= "bool" >
</argument>
<description >
2020-01-23 10:14:14 +00:00
If [code]true[/code], shortcuts are disabled and cannot be used to trigger the button.
2018-01-03 12:45:03 +00:00
</description>
</method>
2017-09-12 20:42:36 +00:00
</methods>
2018-07-29 22:26:43 +00:00
<members >
2019-09-24 11:34:03 +00:00
<member name= "action_mode" type= "int" setter= "set_action_mode" getter= "get_action_mode" override= "true" enum= "BaseButton.ActionMode" default= "0" />
<member name= "enabled_focus_mode" type= "int" setter= "set_enabled_focus_mode" getter= "get_enabled_focus_mode" override= "true" enum= "Control.FocusMode" default= "0" />
<member name= "flat" type= "bool" setter= "set_flat" getter= "is_flat" override= "true" default= "true" />
<member name= "focus_mode" type= "int" setter= "set_focus_mode" getter= "get_focus_mode" override= "true" enum= "Control.FocusMode" default= "0" />
2019-06-29 10:38:01 +00:00
<member name= "switch_on_hover" type= "bool" setter= "set_switch_on_hover" getter= "is_switch_on_hover" default= "false" >
2020-01-23 10:14:14 +00:00
If [code]true[/code], when the cursor hovers above another [MenuButton] within the same parent which also has [code]switch_on_hover[/code] enabled, it will close the current [MenuButton] and open the other one.
2018-07-29 22:26:43 +00:00
</member>
2019-09-24 11:34:03 +00:00
<member name= "toggle_mode" type= "bool" setter= "set_toggle_mode" getter= "is_toggle_mode" override= "true" default= "true" />
2018-07-29 22:26:43 +00:00
</members>
2017-09-12 20:42:36 +00:00
<signals >
<signal name= "about_to_show" >
<description >
Emitted when [PopupMenu] of this MenuButton is about to show.
</description>
</signal>
</signals>
<constants >
</constants>
<theme_items >
<theme_item name= "disabled" type= "StyleBox" >
</theme_item>
<theme_item name= "focus" type= "StyleBox" >
</theme_item>
<theme_item name= "font" type= "Font" >
</theme_item>
2019-07-09 07:13:00 +00:00
<theme_item name= "font_color" type= "Color" default= "Color( 0.88, 0.88, 0.88, 1 )" >
2017-09-12 20:42:36 +00:00
</theme_item>
2019-06-29 10:38:01 +00:00
<theme_item name= "font_color_disabled" type= "Color" default= "Color( 1, 1, 1, 0.3 )" >
2017-09-12 20:42:36 +00:00
</theme_item>
2019-07-09 07:13:00 +00:00
<theme_item name= "font_color_hover" type= "Color" default= "Color( 0.94, 0.94, 0.94, 1 )" >
2017-09-12 20:42:36 +00:00
</theme_item>
2019-06-29 10:38:01 +00:00
<theme_item name= "font_color_pressed" type= "Color" default= "Color( 1, 1, 1, 1 )" >
2017-09-12 20:42:36 +00:00
</theme_item>
<theme_item name= "hover" type= "StyleBox" >
</theme_item>
2019-06-29 10:38:01 +00:00
<theme_item name= "hseparation" type= "int" default= "3" >
2017-09-12 20:42:36 +00:00
</theme_item>
<theme_item name= "normal" type= "StyleBox" >
</theme_item>
<theme_item name= "pressed" type= "StyleBox" >
</theme_item>
</theme_items>
</class>