Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

MenuButton

Наследует: Button < BaseButton < Control < CanvasItem < Node < Object

Кнопка, при нажатии на которую открывается PopupMenu.

Описание

Кнопка, которая при нажатии вызывает PopupMenu. Чтобы создать новые элементы внутри этого PopupMenu, используйте get_popup().add_item("My Item Name"). Вы также можете создавать их напрямую из инспектора редактора Godot.

См. также BaseButton, который содержит общие свойства и методы, связанные с этим узлом.

Свойства

ActionMode	action_mode	0 (overrides BaseButton)
bool	flat	true (overrides Button)
FocusMode	focus_mode	3 (overrides Control)
int	item_count	0
int	popup/item_{index}/checkable	0
bool	popup/item_{index}/checked	false
bool	popup/item_{index}/disabled	false
Texture2D	popup/item_{index}/icon
int	popup/item_{index}/id	0
bool	popup/item_{index}/separator	false
String	popup/item_{index}/text	""
bool	switch_on_hover	false
bool	toggle_mode	true (overrides BaseButton)

Методы

PopupMenu	get_popup() const
void	set_disable_shortcuts(disabled: bool)
void	show_popup()

---

Сигналы

about_to_popup() 🔗

Генерируется, когда PopupMenu этой MenuButton готовится к отображению.

---

Описания свойств

int item_count = 0 🔗

• void set_item_count(value: int)

• int get_item_count()

Количество элементов в списке на данный момент.

---

int popup/item_{index}/checkable = 0 🔗

Тип элемента, который можно проверить (Включить/Выключить), находится по адресу index.

Примечание: index — это значение в диапазоне 0 .. item_count - 1.

---

bool popup/item_{index}/checked = false 🔗

Если true, включается/выключается элемент по index.

Примечание: index — это значение в диапазоне 0 .. item_count - 1.

---

bool popup/item_{index}/disabled = false 🔗

Если true, элемент по index отключен.

Примечание: index — это значение в диапазоне 0 .. item_count - 1.

---

Texture2D popup/item_{index}/icon 🔗

Значок элемента по адресу index.

Примечание: index — это значение в диапазоне 0 .. item_count - 1.

---

int popup/item_{index}/id = 0 🔗

ID Идентификатор элемента по адресу index.

Примечание: index — это значение в диапазоне от 0 .. item_count - 1.

---

bool popup/item_{index}/separator = false 🔗

Если true, то элемент по адресу index является разделителем.

Примечание: index — это значение в диапазоне 0 .. item_count - 1.

---

String popup/item_{index}/text = "" 🔗

Текст элемента по адресу index.

Примечание: index — это значение в диапазоне 0 .. item_count - 1.

---

bool switch_on_hover = false 🔗

• void set_switch_on_hover(value: bool)

• bool is_switch_on_hover()

Если true, то при наведении курсора на другой элемент MenuButton в том же родительском элементе, у которого также включен switch_on_hover, текущий элемент MenuButton будет закрыт, а другой открыт.

---

Описания метода

PopupMenu get_popup() const 🔗

Возвращает PopupMenu, содержащийся в этой кнопке.

Предупреждение: Это обязательный внутренний узел, его удаление и освобождение может привести к сбою. Если вы хотите скрыть его или любой из его дочерних элементов, используйте их свойство Window.visible.

---

void set_disable_shortcuts(disabled: bool) 🔗

Если true, сочетания клавиш отключены и не могут использоваться для активации кнопки.

---

void show_popup() 🔗

Настраивает положение и размер всплывающего окна для MenuButton, затем показывает PopupMenu. Предпочтительнее использовать этот метод, чем get_popup().popup().