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

Hérite de : Button < BaseButton < Control < CanvasItem < Node < Object

Un bouton qui fait apparaître un PopupMenu quand il est cliqué.

Description

Un bouton qui fait apparaître un PopupMenu quand il est cliqué. Pour créer de nouveaux éléments dans ce PopupMenu, utilisez get_popup().add_item("Mon nom d'élément"). Vous pouvez aussi les créer directement auprès de l'inspecteur de l'éditeur Godot.

Voir aussi BaseButton qui contient des propriétés et des méthodes communes associées à ce nœud.

Propriétés

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)

Méthodes

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

---

Signaux

about_to_popup() 🔗

Émis lorsque le PopupMenu de ce MenuButton est sur le point d'être affiché.

---

Descriptions des propriétés

int item_count = 0 🔗

• void set_item_count(value: int)

• int get_item_count()

Le nombre d'éléments actuellement dans la liste.

---

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

The checkable item type of the item at index.

Note: index is a value in the 0 .. item_count - 1 range.

---

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

If true, the item at index is checked.

Note: index is a value in the 0 .. item_count - 1 range.

---

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

If true, the item at index is disabled.

Note: index is a value in the 0 .. item_count - 1 range.

---

Texture2D popup/item_{index}/icon 🔗

The icon of the item at index.

Note: index is a value in the 0 .. item_count - 1 range.

---

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

The ID of the item at index.

Note: index is a value in the 0 .. item_count - 1 range.

---

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

If true, the item at index is a separator.

Note: index is a value in the 0 .. item_count - 1 range.

---

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

The text of the item at index.

Note: index is a value in the 0 .. item_count - 1 range.

---

bool switch_on_hover = false 🔗

• void set_switch_on_hover(value: bool)

• bool is_switch_on_hover()

Si true, lorsque le curseur survole un autre MenuButton au sein du même parent qui a également switch_on_hover activé, il fermera le MenuButton actuel et ouvrira l'autre bouton.

---

Descriptions des méthodes

PopupMenu get_popup() const 🔗

Renvoie le PopupMenu contenu dans ce bouton.

Avertissement : Il s'agit d'un nœud interne nécessaire, le retirer et le libérer peut causer un plantage. Si vous voulez le cacher lui ou l'un de ses enfants, utilisez plutôt la propriété Window.visible.

---

void set_disable_shortcuts(disabled: bool) 🔗

Si true, les raccourcis sont désactivés et ne peuvent pas être utilisés pour déclencher le bouton.

---

void show_popup() 🔗

Ajuste la position et la taille de la popup pour le MenuButton, puis affiche le PopupMenu. Préférez ceci plutôt que get_popup().popup().