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...

OptionButton

Eredita: Button < BaseButton < Control < CanvasItem < Node < Object

Un pulsante che, se premuto, apre un menu a tendina con opzioni selezionabili.

Descrizione

OptionButton è un tipo di pulsante che apre un menu a tendina con voci selezionabili quando viene premuto. La voce selezionata diventa la voce "attuale" e viene visualizzata come testo del pulsante.

Vedi anche BaseButton che contiene proprietà e metodi comuni associati a questo nodo.

Nota: Gli ID utilizzati per le voci sono interi a 32 bit, non a 64 bit pieni di int. Questi hanno un intervallo di -2^32 a 2^32 - 1, ovvero, -2147483648 a 2147483647.

Nota: Le proprietà Button.text e Button.icon sono impostate automaticamente in base alla voce selezionata. Non si dovrebbero cambiare manualmente.

Proprietà

ActionMode	action_mode	`0` (overrides BaseButton)
HorizontalAlignment	alignment	`0` (overrides Button)
bool	allow_reselect	`false`
bool	fit_to_longest_item	`true`
int	item_count	`0`
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	search_bar_enabled	`false`
bool	search_bar_fuzzy_search_enabled	`true`
int	search_bar_fuzzy_search_max_misses	`2`
int	search_bar_min_item_count	`0`
int	selected	`-1`
bool	toggle_mode	`true` (overrides BaseButton)

Metodi

void	add_icon_item(texture: Texture2D, label: String, id: int = -1)
void	add_item(label: String, id: int = -1)
void	add_separator(text: String = "")
void	clear()
AutoTranslateMode	get_item_auto_translate_mode(idx: int) const
Texture2D	get_item_icon(idx: int) const
int	get_item_id(idx: int) const
int	get_item_index(id: int) const
Variant	get_item_metadata(idx: int) const
String	get_item_text(idx: int) const
String	get_item_tooltip(idx: int) const
PopupMenu	get_popup() const
int	get_selectable_item(from_last: bool = false) const
int	get_selected_id() const
Variant	get_selected_metadata() const
bool	has_selectable_items() const
bool	is_item_disabled(idx: int) const
bool	is_item_separator(idx: int) const
void	remove_item(idx: int)
void	select(idx: int)
void	set_disable_shortcuts(disabled: bool)
void	set_item_auto_translate_mode(idx: int, mode: AutoTranslateMode)
void	set_item_disabled(idx: int, disabled: bool)
void	set_item_icon(idx: int, texture: Texture2D)
void	set_item_id(idx: int, id: int)
void	set_item_metadata(idx: int, metadata: Variant)
void	set_item_text(idx: int, text: String)
void	set_item_tooltip(idx: int, tooltip: String)
void	show_popup()

Proprietà del tema

int	arrow_margin	`4`
int	modulate_arrow	`0`
Texture2D	arrow

Segnali

item_focused(index: int) 🔗

Emesso quando l'utente passa a una voce utilizzando le azioni di input ProjectSettings.input/ui_up o ProjectSettings.input/ui_down. L'indice della voce selezionata viene passata come argomento.

item_selected(index: int) 🔗

Emesso quando la voce attuale è stata cambiata dall'utente. L'indice della voce selezionata viene passato come argomento.

allow_reselect deve essere abilitato per selezionare la stessa voce nuovamente.

Descrizioni delle proprietà

bool allow_reselect = false 🔗

void set_allow_reselect(value: bool)
bool get_allow_reselect()

Se true, la voce attualmente selezionata può essere selezionata nuovamente.

bool fit_to_longest_item = true 🔗

void set_fit_to_longest_item(value: bool)
bool is_fit_to_longest_item()

If true, minimum size will be determined by the longest item's width, instead of the currently selected one's. It will also take the popup's margins into account, making the button match its total width.

Note: For performance reasons, the minimum size doesn't update immediately when adding, removing or modifying items.

int item_count = 0 🔗

void set_item_count(value: int)
int get_item_count()

Il numero di voci tra cui selezionare.

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

Se true, la voce all'indice index è disabilitata.