MenuButton¶
Inherits: Button < BaseButton < Control < CanvasItem < Node < Object
点击后会弹出 PopupMenu 的特殊按钮。
描述¶
点击后会弹出 PopupMenu 的特殊按钮。
可以使用 get_popup().add_item("菜单项目名称")
在这个 PopupMenu 中创建新项目。你也可以直接从编辑器中创建它们。要做到这点,选择 MenuButton
节点,然后在 2D 编辑器顶部的工具栏中,点击项目,然后点击弹出窗口中的添加。你将能够赋予每个项目新的属性。
与该节点相关的常用属性和方法请参阅 BaseButton。
属性¶
action_mode |
|
|
flat |
|
|
focus_mode |
|
|
|
||
toggle_mode |
|
方法¶
get_popup ( ) const |
|
void |
set_disable_shortcuts ( bool disabled ) |
主题属性¶
|
||
|
||
|
||
|
||
|
||
|
||
信号¶
about_to_show ( )
当此MenuButton的PopupMenu即将显示时触发。
属性说明¶
bool switch_on_hover
Default |
|
Setter |
set_switch_on_hover(value) |
Getter |
is_switch_on_hover() |
如果true
,当光标悬停在同一父级中也启用了switch_on_hover
的另一个MenuButton
上方时,它将关闭当前的MenuButton
并打开另一个。
方法说明¶
PopupMenu get_popup ( ) const
返回这个按钮中包含的 PopupMenu。
警告:这是一个必需的内部节点,移除和释放它可能会导致崩溃。如果你想隐藏它或它的任何子节点,请使用其 CanvasItem.visible 属性。
void set_disable_shortcuts ( bool disabled )
如果true
,快捷方式将被禁用,无法用于触发按钮。
Theme Property Descriptions¶
Color font_color
Default |
|
MenuButton
默认的字体Color颜色。
Color font_color_disabled
Default |
|
MenuButton
被禁用时的字体Color颜色。
Color font_color_focus
Default |
|
当MenuButton
获得焦点时使用的文本Color。只替换按钮的正常文本颜色。禁用、悬停和按下状态优先于这个颜色。
Color font_color_hover
Default |
|
当鼠标在 MenuButton
上悬停时使用的字体 Color 颜色。
Color font_color_pressed
Default |
|
当MenuButton
被按下时使用的字体Color颜色。
int hseparation
Default |
|
MenuButton
的文字和图标之间的水平间隙。
Font font
MenuButton
文本的Font。
StyleBox disabled
当MenuButton
被禁用时使用的StyleBox。
StyleBox focus
当MenuButton
被聚焦时使用的StyleBox。它显示在当前的StyleBox上,所以使用StyleBoxEmpty将只是禁用焦点的视觉效果。
StyleBox hover
当鼠标在 MenuButton
上悬停时使用的 StyleBox 样式盒。
StyleBox normal
MenuButton
的默认StyleBox样式盒。
StyleBox pressed
MenuButton
被按下时的StyleBox样式盒。