MenuBar¶

为每个PopupMenu子级创建菜单的水平菜单栏。

描述¶

为每个PopupMenu子节点创建菜单的水平菜单栏。通过将PopupMenu添加到此节点来创建新项目。项目标题由Window.title确定，如果Window.title为空，则由节点名称确定。项目标题可以使用set_menu_title()覆盖。

属性¶

bool	flat	`false`
String	language	`""`
bool	prefer_global_menu	`true`
int	start_index	`-1`
bool	switch_on_hover	`true`
TextDirection	text_direction	`0`

方法¶

int	get_menu_count() const
PopupMenu	get_menu_popup(menu: int) const
String	get_menu_title(menu: int) const
String	get_menu_tooltip(menu: int) const
bool	is_menu_disabled(menu: int) const
bool	is_menu_hidden(menu: int) const
bool	is_native_menu() const
void	set_disable_shortcuts(disabled: bool)
void	set_menu_disabled(menu: int, disabled: bool)
void	set_menu_hidden(menu: int, hidden: bool)
void	set_menu_title(menu: int, title: String)
void	set_menu_tooltip(menu: int, tooltip: String)

主题属性¶

Color	font_color	`Color(0.875, 0.875, 0.875, 1)`
Color	font_disabled_color	`Color(0.875, 0.875, 0.875, 0.5)`
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_hover_pressed_color	`Color(1, 1, 1, 1)`
Color	font_outline_color	`Color(0, 0, 0, 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	disabled_mirrored
StyleBox	hover
StyleBox	hover_mirrored
StyleBox	hover_pressed
StyleBox	hover_pressed_mirrored
StyleBox	normal
StyleBox	normal_mirrored
StyleBox	pressed
StyleBox	pressed_mirrored

属性说明¶

bool flat = false 🔗

void set_flat(value: bool)
bool is_flat()

平面MenuBar不显示项目装饰。

String language = "" 🔗

void set_language(value: String)
String get_language()

用于换行和文本整形算法的语言代码，如果留空则使用当前语言环境。

bool prefer_global_menu = true 🔗

void set_prefer_global_menu(value: bool)
bool is_prefer_global_menu()

如果true，MenuBar将在支持时使用系统全局菜单。

注意：如果支持true和全局菜单，则不显示此节点，大小为零，并且除PopupMenu之外的所有子节点都无法访问。

注意：此属性覆盖子节点的PopupMenu.prefer_native_menu属性的值。

int start_index = -1 🔗

void set_start_index(value: int)
int get_start_index()

在全局菜单中按位置顺序插入MenuBar项。MenuBar中的所有菜单项始终作为连续范围插入。首先插入start_index较低的菜单。最后插入start_index等于-1的菜单。

bool switch_on_hover = true 🔗

void set_switch_on_hover(value: bool)
bool is_switch_on_hover()

如果true，当光标悬停在菜单项上方时，它将关闭当前的PopupMenu并打开另一个。

TextDirection text_direction = 0 🔗

void set_text_direction(value: TextDirection)
TextDirection get_text_direction()

基本文本写作方向。

方法说明¶

返回菜单项的数量。

返回与菜单项关联的PopupMenu。

返回菜单项标题。

返回菜单项工具提示。

如果菜单项被禁用，则返回true。

如果菜单项被隐藏，则返回true。

如果此MenuBar支持并使用系统全局菜单，则返回true。

void set_disable_shortcuts(disabled: bool) 🔗

如果true，则禁用快捷方式并且不能用于触发按钮。

如果true，则禁用菜单项。

如果true，则隐藏菜单项。

设置菜单项标题。

菜单项工具提示。

主题属性说明¶

Color font_color = Color(0.875, 0.875, 0.875, 1) 🔗

菜单项的默认文本Color。

Color font_disabled_color = Color(0.875, 0.875, 0.875, 0.5) 🔗

禁用菜单项时使用的文本Color。

Color font_focus_color = Color(0.95, 0.95, 0.95, 1) 🔗

菜单项聚焦时使用的文本Color。仅替换菜单项的正常文本颜色。禁用、悬停和按下状态优先于此颜色。

Color font_hover_color = Color(0.95, 0.95, 0.95, 1) 🔗

悬停菜单项时使用的文本Color。

Color font_hover_pressed_color = Color(1, 1, 1, 1) 🔗

悬停并按下菜单项时使用的文本Color。

Color font_outline_color = Color(0, 0, 0, 1) 🔗

菜单项文本轮廓的色调。

Color font_pressed_color = Color(1, 1, 1, 1) 🔗

按下菜单项时使用的文本Color。

int h_separation = 4 🔗

菜单项之间的水平空间。

int outline_size = 0 🔗

文本大纲的大小。

注意：如果使用启用了FontFile.multichannel_signed_distance_field的字体，则其FontFile.msdf_pixel_range必须设置为至少两倍outline_size的值才能使轮廓渲染看起来正确。否则，轮廓可能会比预期的更早被切断。

Font font 🔗

菜单项文本的Font。

int font_size 🔗

菜单项文本的字体大小。

StyleBox disabled 🔗

禁用菜单项时使用的StyleBox。

StyleBox disabled_mirrored 🔗

StyleBox在禁用菜单项时使用（用于从右到左的布局）。

StyleBox hover 🔗

StyleBox在菜单项悬停时使用。

StyleBox hover_mirrored 🔗

StyleBox在菜单项悬停时使用（用于从右到左的布局）。

StyleBox hover_pressed 🔗

StyleBox在同时按下菜单项并悬停时使用。

StyleBox hover_pressed_mirrored 🔗

StyleBox用于同时按下菜单项并悬停（用于从右到左的布局）。

StyleBox normal 🔗

菜单项的默认StyleBox。

StyleBox normal_mirrored 🔗

菜单项的默认StyleBox（用于从右到左的布局）。

StyleBox pressed 🔗

StyleBox在按下菜单项时使用。

StyleBox pressed_mirrored 🔗

StyleBox在按下菜单项时使用（用于从右到左的布局）。