NativeMenu

Eredita: Object

Un'interfaccia server per i menu nativi del sistema operativo.

Descrizione

NativeMenu gestisce l'accesso di basso livello alla barra nativa globale dei menu del sistema operativo e ai menu popup.

Nota: Questa è un'API di basso livello, considera di usare MenuBar con MenuBar.prefer_global_menu impostato su true e PopupMenu con PopupMenu.prefer_native_menu impostato su true.

Per creare un menu, usa create_menu(), aggiungi voci di menu usando i metodi add_*_item. Per rimuovere un menu, usa free_menu().

var menu

func _menu_callback(item_id):
    if item_id == "ITEM_CUT":
        cut()
    elif item_id == "ITEM_COPY":
        copy()
    elif item_id == "ITEM_PASTE":
        paste()

func _enter_tree():
    # Crea un nuovo menu e aggiungi elementi:
    menu = NativeMenu.create_menu()
    NativeMenu.add_item(menu, "Cut", _menu_callback, Callable(), "ITEM_CUT")
    NativeMenu.add_item(menu, "Copy", _menu_callback, Callable(), "ITEM_COPY")
    NativeMenu.add_separator(menu)
    NativeMenu.add_item(menu, "Paste", _menu_callback, Callable(), "ITEM_PASTE")

func _on_button_pressed():
    # Mostra il menu popup alla posizione del mouse:
    NativeMenu.popup(menu, DisplayServer.mouse_get_position())

func _exit_tree():
    # Rimuovi il menu quando non è più necessario:
    NativeMenu.free_menu(menu)

Metodi

int	add_check_item(rid: RID, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1)
int	add_icon_check_item(rid: RID, icon: Texture2D, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1)
int	add_icon_item(rid: RID, icon: Texture2D, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1)
int	add_icon_radio_check_item(rid: RID, icon: Texture2D, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1)
int	add_item(rid: RID, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1)
int	add_multistate_item(rid: RID, label: String, max_states: int, default_state: int, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1)
int	add_radio_check_item(rid: RID, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1)
int	add_separator(rid: RID, index: int = -1)
int	add_submenu_item(rid: RID, label: String, submenu_rid: RID, tag: Variant = null, index: int = -1)
void	clear(rid: RID)
RID	create_menu()
int	find_item_index_with_submenu(rid: RID, submenu_rid: RID) const
int	find_item_index_with_tag(rid: RID, tag: Variant) const
int	find_item_index_with_text(rid: RID, text: String) const
void	free_menu(rid: RID)
Key	get_item_accelerator(rid: RID, idx: int) const
Callable	get_item_callback(rid: RID, idx: int) const
int	get_item_count(rid: RID) const
Texture2D	get_item_icon(rid: RID, idx: int) const
int	get_item_indentation_level(rid: RID, idx: int) const
Callable	get_item_key_callback(rid: RID, idx: int) const
int	get_item_max_states(rid: RID, idx: int) const
int	get_item_state(rid: RID, idx: int) const
RID	get_item_submenu(rid: RID, idx: int) const
Variant	get_item_tag(rid: RID, idx: int) const
String	get_item_text(rid: RID, idx: int) const
String	get_item_tooltip(rid: RID, idx: int) const
float	get_minimum_width(rid: RID) const
Callable	get_popup_close_callback(rid: RID) const
Callable	get_popup_open_callback(rid: RID) const
Vector2	get_size(rid: RID) const
RID	get_system_menu(menu_id: SystemMenus) const
String	get_system_menu_name(menu_id: SystemMenus) const
bool	has_feature(feature: Feature) const
bool	has_menu(rid: RID) const
bool	has_system_menu(menu_id: SystemMenus) const
bool	is_item_checkable(rid: RID, idx: int) const
bool	is_item_checked(rid: RID, idx: int) const
bool	is_item_disabled(rid: RID, idx: int) const
bool	is_item_hidden(rid: RID, idx: int) const
bool	is_item_radio_checkable(rid: RID, idx: int) const
bool	is_opened(rid: RID) const
bool	is_system_menu(rid: RID) const
void	popup(rid: RID, position: Vector2i)
void	remove_item(rid: RID, idx: int)
void	set_interface_direction(rid: RID, is_rtl: bool)
void	set_item_accelerator(rid: RID, idx: int, keycode: Key)
void	set_item_callback(rid: RID, idx: int, callback: Callable)
void	set_item_checkable(rid: RID, idx: int, checkable: bool)
void	set_item_checked(rid: RID, idx: int, checked: bool)
void	set_item_disabled(rid: RID, idx: int, disabled: bool)
void	set_item_hidden(rid: RID, idx: int, hidden: bool)
void	set_item_hover_callbacks(rid: RID, idx: int, callback: Callable)
void	set_item_icon(rid: RID, idx: int, icon: Texture2D)
void	set_item_indentation_level(rid: RID, idx: int, level: int)
void	set_item_key_callback(rid: RID, idx: int, key_callback: Callable)
void	set_item_max_states(rid: RID, idx: int, max_states: int)
void	set_item_radio_checkable(rid: RID, idx: int, checkable: bool)
void	set_item_state(rid: RID, idx: int, state: int)
void	set_item_submenu(rid: RID, idx: int, submenu_rid: RID)
void	set_item_tag(rid: RID, idx: int, tag: Variant)
void	set_item_text(rid: RID, idx: int, text: String)
void	set_item_tooltip(rid: RID, idx: int, tooltip: String)
void	set_minimum_width(rid: RID, width: float)
void	set_popup_close_callback(rid: RID, callback: Callable)
void	set_popup_open_callback(rid: RID, callback: Callable)

Enumerazioni

enum Feature: 🔗

Feature FEATURE_GLOBAL_MENU = 0

NativeMenu supporta il menu principale globale nativo.

Feature FEATURE_POPUP_MENU = 1

NativeMenu supporta i menu nativi a comparsa.

Feature FEATURE_OPEN_CLOSE_CALLBACK = 2

NativeMenu supporta i callback di apertura e chiusura del menu.

Feature FEATURE_HOVER_CALLBACK = 3

NativeMenu supporta il callback al passaggio del mouse sulle voci del menu.

Feature FEATURE_KEY_CALLBACK = 4

NativeMenu supporta il callback dell'acceleratore/tasto delle voci del menu.

enum SystemMenus: 🔗

SystemMenus INVALID_MENU_ID = 0

ID del menu speciale di sistema non valido.

SystemMenus MAIN_MENU_ID = 1

ID del menu principale globale.

SystemMenus APPLICATION_MENU_ID = 2

ID del menu Applicazione (il primo menu dopo il menu "Apple" su macOS).

SystemMenus WINDOW_MENU_ID = 3

ID del menu "Finestra" (su macOS questo menu include voci comuni di controllo delle finestre e un elenco delle finestre aperte).

SystemMenus HELP_MENU_ID = 4

ID del menu "Aiuto" (su macOS questo menu include la barra di ricerca della guida).

SystemMenus DOCK_MENU_ID = 5

ID del menu di scelta rapida sull'icona del dock (su macOS questo menu include voci comuni di controllo delle applicazioni e un elenco delle finestre aperte).

Descrizioni dei metodi

int add_check_item(rid: RID, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1) 🔗

Aggiunge una nuova voce spuntabile con il testo label al menu globale rid.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

È possibile definire un accelerator, ovvero una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il accelerator è generalmente una combinazione di KeyModifierMask e Key che utilizzano OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: I chiamabili callback e key_callback devono accettare soltanto un parametro variante, il parametro passato ai chiamabili sarà il valore passato a tag.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Su Windows, accelerator e key_callback sono ignorati.

int add_icon_check_item(rid: RID, icon: Texture2D, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1) 🔗

Aggiunge una nuova voce spuntabile con il testo label e l'icona icon al menu globale rid.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

È possibile definire un accelerator, ovvero una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il accelerator è generalmente una combinazione di KeyModifierMask e Key che utilizzano OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: I chiamabili callback e key_callback devono accettare soltanto un parametro variante, il parametro passato ai chiamabili sarà il valore passato a tag.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Su Windows, accelerator e key_callback sono ignorati.

int add_icon_item(rid: RID, icon: Texture2D, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1) 🔗

Aggiunge una nuova voce con il testo label e l'icona icon al menu globale rid.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

È possibile definire un accelerator, ovvero una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il accelerator è generalmente una combinazione di KeyModifierMask e Key che utilizzano OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: I chiamabili callback e key_callback devono accettare soltanto un parametro variante, il parametro passato ai chiamabili sarà il valore passato a tag.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Su Windows, accelerator e key_callback sono ignorati.

int add_icon_radio_check_item(rid: RID, icon: Texture2D, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1) 🔗

Aggiunge una nuova voce spuntabile di opzione (radio) con il testo label e l'icona icon al menu globale rid.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

È possibile definire un accelerator, ovvero una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il accelerator è generalmente una combinazione di KeyModifierMask e Key che utilizzano OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: Le voci spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionate e deselezionate manualmente. Consulta set_item_checked() per ulteriori informazioni su come controllarle.

Nota: I chiamabili callback e key_callback devono accettare soltanto un parametro variante, il parametro passato ai chiamabili sarà il valore passato a tag.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Su Windows, accelerator e key_callback sono ignorati.

int add_item(rid: RID, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1) 🔗

Aggiunge una nuova voce con il testo label al menu globale rid.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

È possibile definire un accelerator, ovvero una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il accelerator è generalmente una combinazione di KeyModifierMask e Key che utilizzano OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: I chiamabili callback e key_callback devono accettare soltanto un parametro variante, il parametro passato ai chiamabili sarà il valore passato a tag.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Su Windows, accelerator e key_callback sono ignorati.

int add_multistate_item(rid: RID, label: String, max_states: int, default_state: int, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1) 🔗

Aggiunge una nuova voce con il testo label al menu globale rid.

Contrariamente alle voci binarie normali, le voci multistato possono avere più di due stati, come definito da max_states. Ogni pressione o attivazione della voce aumenterà lo stato di uno. Il valore predefinito è definito da default_state.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

È possibile definire un accelerator, ovvero una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il accelerator è generalmente una combinazione di KeyModifierMask e Key che utilizzano OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: Come predefinito, non c'è alcuna indicazione sullo stato attuale della voce, la quale dovrebbe essere modificata manualmente.

Nota: I chiamabili callback e key_callback devono accettare soltanto un parametro variante, il parametro passato ai chiamabili sarà il valore passato a tag.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Su Windows, accelerator e key_callback sono ignorati.

int add_radio_check_item(rid: RID, label: String, callback: Callable = Callable(), key_callback: Callable = Callable(), tag: Variant = null, accelerator: Key = 0, index: int = -1) 🔗

Aggiunge una nuova voce spuntabile di opzione (radio) con il testo label al menu globale rid.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

È possibile definire un accelerator, ovvero una scorciatoia da tastiera che può essere premuta per attivare il pulsante del menu anche se non è attualmente aperto. Il accelerator è generalmente una combinazione di KeyModifierMask e Key che utilizzano OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: Le voci spuntabili mostrano solo un segno di spunta, ma non hanno alcun comportamento di spunta incorporato e devono essere selezionate e deselezionate manualmente. Consulta set_item_checked() per ulteriori informazioni su come controllarle.

Nota: I chiamabili callback e key_callback devono accettare soltanto un parametro variante, il parametro passato ai chiamabili sarà il valore passato a tag.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Su Windows, accelerator e key_callback sono ignorati.

int add_separator(rid: RID, index: int = -1) 🔗

Aggiunge un separatore tra le voci del menu globale rid. Anche i separatori occupano un indice.

Restituisce l'indice della voce inserita, non è garantito che sia uguale al valore di index.

Nota: Questo metodo è implementato su macOS e Windows.

int add_submenu_item(rid: RID, label: String, submenu_rid: RID, tag: Variant = null, index: int = -1) 🔗

Aggiunge un elemento che fungerà da sottomenu del menu globale rid. L'argomento submenu_rid è il RID del menu globale che sarà mostrato quando si clicca sull'elemento.

Restituisce l'indice dell'elemento inserito, non è garantito che sia uguale al valore di index.

Nota: Questo metodo è implementato su macOS e Windows.

void clear(rid: RID) 🔗

Rimuove tutte le voci dal menu globale rid.

Nota: Questo metodo è implementato su macOS e Windows.

Crea un nuovo oggetto per menù globale.

Nota: Questo metodo è implementato su macOS e Windows.

int find_item_index_with_submenu(rid: RID, submenu_rid: RID) const 🔗

Restituisce l'indice dell'elemento con il sottomenu specificato da submenu_rid. Gli indici vengono assegnati automaticamente a ciascun elemento dal motore e non possono essere impostati manualmente.

Nota: Questo metodo è implementato su macOS e Windows.

int find_item_index_with_tag(rid: RID, tag: Variant) const 🔗

Restituisce l'indice dell'elemento con il tag tag specificato. Gli indici vengono assegnati automaticamente a ciascun elemento dal motore e non possono essere impostati manualmente.

Nota: Questo metodo è implementato su macOS e Windows.

int find_item_index_with_text(rid: RID, text: String) const 🔗

Restituisce l'indice dell'elemento con il testo text specificato. Gli indici vengono assegnati automaticamente a ciascun elemento dal motore e non possono essere impostati manualmente.

Nota: Questo metodo è implementato su macOS e Windows.

Libera un oggetto menù globale creato da questo NativeMenu.

Nota: Questo metodo è implementato su macOS e Windows.

Key get_item_accelerator(rid: RID, idx: int) const 🔗

Restituisce l'acceleratore dell'elemento all'indice idx. Gli acceleratori sono combinazioni speciali di tasti che attivano l'elemento, indifferentemente da quale controllo è focalizzato.

Nota: Questo metodo è implementato solo su macOS.

Callable get_item_callback(rid: RID, idx: int) const 🔗

Restituisce il callback dell'elemento all'indice idx.

Nota: Questo metodo è implementato su macOS e Windows.

int get_item_count(rid: RID) const 🔗

Restituisce il numero di voci nel menu globale rid.

Nota: Questo metodo è implementato su macOS e Windows.

Texture2D get_item_icon(rid: RID, idx: int) const 🔗

Restituisce l'icona dell'elemento all'indice idx.

Nota: Questo metodo è implementato su macOS e Windows.

int get_item_indentation_level(rid: RID, idx: int) const 🔗

Restituisce l'offset orizzontale dell'elemento al dato indice idx.

Nota: Questo metodo è implementato solo su macOS.

Callable get_item_key_callback(rid: RID, idx: int) const 🔗

Restituisce il callback dell'acceleratore dell'elemento all'indice idx.

Nota: Questo metodo è implementato solo su macOS.

int get_item_max_states(rid: RID, idx: int) const 🔗

Restituisce il numero di stati di un elemento multistato. Vedi add_multistate_item() per i dettagli.

Nota: Questo metodo è implementato su macOS e Windows.

int get_item_state(rid: RID, idx: int) const 🔗

Restituisce lo stato di un elemento multistato. Vedi add_multistate_item() per i dettagli.

Nota: Questo metodo è implementato su macOS e Windows.

RID get_item_submenu(rid: RID, idx: int) const 🔗

Restituisce l'ID del sottomenu dell'elemento all'indice idx. Consulta add_submenu_item() per ulteriori informazioni su come aggiungere un sottomenu.

Nota: Questo metodo è implementato su macOS e Windows.

Variant get_item_tag(rid: RID, idx: int) const 🔗

Restituisce i metadati dell'elemento specificato, che potrebbero essere di qualsiasi tipo. È possibile impostarli con set_item_tag(), il quale fornisce un modo semplice per assegnare dati di contesto agli elementi.

Nota: Questo metodo è implementato su macOS e Windows.

String get_item_text(rid: RID, idx: int) const 🔗

Restituisce il testo dell'elemento all'indice idx.

Nota: Questo metodo è implementato su macOS e Windows.

Restituisce il tooltip associato all'indice specificato idx.

Nota: Questo metodo è implementato solo su macOS.

float get_minimum_width(rid: RID) const 🔗

Restituisce la larghezza minima del menu globale.

Nota: Questo metodo è implementato solo su macOS.

Restituisce il callback di chiusura del menu globale.

Nota: Questo metodo è implementato su macOS e Windows.

Restituisce il callback di apertura del menu globale.

Nota: Questo metodo è implementato solo su macOS.

Vector2 get_size(rid: RID) const 🔗

Restituisce le dimensioni del menu globale.

Nota: Questo metodo è implementato solo su macOS.

Restituisce il RID di un menu speciale di sistema.

Nota: Questo metodo è implementato solo su macOS.

Restituisce il nome leggibile di un menu speciale di sistema.

Nota: Questo metodo è implementato solo su macOS.

bool has_feature(feature: Feature) const 🔗

Restituisce true se la funzionalità feature è supportata dal NativeMenu attuale, altrimenti false.

Nota: Questo metodo è implementato su macOS e Windows.

Restituisce true se rid è un menu globale valido.

Nota: Questo metodo è implementato su macOS e Windows.

Restituisce true se è supportato un menu speciale di sistema.

Nota: Questo metodo è implementato solo su macOS.

bool is_item_checkable(rid: RID, idx: int) const 🔗

Restituisce true se l'elemento all'indice idx è spuntabile in qualche modo, ad esempio se ha una casella di spunta o un pulsante di scelta (radio).

Nota: Questo metodo è implementato su macOS e Windows.

bool is_item_checked(rid: RID, idx: int) const 🔗

Restituisce true se l'elemento all'indice idx è spuntato.

Nota: Questo metodo è implementato su macOS e Windows.

bool is_item_disabled(rid: RID, idx: int) const 🔗

Restituisce true se l'elemento all'indice idx è disabilitato. Quando è disabilitato, non può essere selezionato e la sua azione non può essere richiamata.

Consulta set_item_disabled() per ulteriori informazioni su come disabilitare un elemento.

Nota: Questo metodo è implementato su macOS e Windows.

bool is_item_hidden(rid: RID, idx: int) const 🔗

Restituisce true se la voce all'indice idx è nascosta.

Vedi set_item_hidden() per ulteriori informazioni su come nascondere una voce.

Nota: Questo metodo è implementato solo su macOS.

bool is_item_radio_checkable(rid: RID, idx: int) const 🔗

Restituisce true se la voce all'indice idx ha la possibilità di essere spuntato in stile pulsante di scelta (radio).

Nota: Questo è puramente estetico; bisogna aggiungere manualmente la logica per spuntare le voci nei gruppi di scelta.

Nota: Questo metodo è implementato su macOS e Windows.

bool is_opened(rid: RID) const 🔗

Restituisce true se il menu è attualmente aperto.

Nota: Questo metodo è implementato solo su macOS.

Restituisce true se il menu globale è un menu speciale di sistema.

Nota: Questo metodo è implementato solo su macOS.

Mostra il menù globale alla posizione position in coordinate di schermo.

Nota: Questo metodo è implementato su macOS e Windows.

void remove_item(rid: RID, idx: int) 🔗

Rimuove l'elemento all'indice idx dal menu globale rid.

Nota: Gli indici degli elementi successivi all'elemento rimosso verranno spostati di uno.

Nota: Questo metodo è implementato su macOS e Windows.

void set_interface_direction(rid: RID, is_rtl: bool) 🔗

Imposta la direzione di layout del testo del menu da destra a sinistra se is_rtl è true.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_accelerator(rid: RID, idx: int, keycode: Key) 🔗

Imposta l'acceleratore della voce all'indice idx. keycode può essere un solo valore da Key oppure una combinazione di KeyModifierMask e Key tramite OR bit a bit come KEY_MASK_CTRL | KEY_A (Ctrl + A).

Nota: Questo metodo è implementato solo su macOS.

void set_item_callback(rid: RID, idx: int, callback: Callable) 🔗

Imposta il callback della voce all'indice idx. Il callback viene richiamato quando si preme una voce.

Nota: Il chiamabile callback deve accettare soltanto un parametro variante, il parametro passato al chiamabile sarà il valore passato a tag quando la voce del menu è stata creata.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_checkable(rid: RID, idx: int, checkable: bool) 🔗

Imposta se l'elemento all'indice idx ha una casella di spunta. Se false, imposta il tipo dell'elemento su testo semplice.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_checked(rid: RID, idx: int, checked: bool) 🔗

Imposta lo stato di spunta dell'elemento all'indice idx.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_disabled(rid: RID, idx: int, disabled: bool) 🔗

Abilita/disabilita l'elemento all'indice idx. Quando è disabilitato, non può essere selezionato e la sua azione non può essere richiamata.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_hidden(rid: RID, idx: int, hidden: bool) 🔗

Nasconde o mostra la voce all'indice idx. Quando è nascosta, una voce non appare in un menù e la sua azione non può essere richiamata.

Nota: Questo metodo è implementato solo su macOS.

void set_item_hover_callbacks(rid: RID, idx: int, callback: Callable) 🔗

Imposta il callback della voce all'indice idx. Il callback viene emesso al passaggio del cursore.

Nota: Il chiamabile callback deve accettare soltanto un parametro variante, il parametro passato al chiamabile sarà il valore passato al parametro tag quando la voce del menu è stata creata.

Nota: Questo metodo è implementato solo su macOS.

void set_item_icon(rid: RID, idx: int, icon: Texture2D) 🔗

Sostituisce l'icona Texture2D dell'indice idx specificato.

Nota: Questo metodo è implementato su macOS e Windows.

Nota: Questo metodo non è supportato dalle voci di menu del Dock di macOS.

void set_item_indentation_level(rid: RID, idx: int, level: int) 🔗

Imposta l'offset orizzontale dell'elemento all'indice idx.

Nota: Questo metodo è implementato solo su macOS.

void set_item_key_callback(rid: RID, idx: int, key_callback: Callable) 🔗

Imposta il callback della voce all'indice idx. Il callback viene emesso quando il suo acceleratore viene attivato.

Nota: Il chiamabile key_callback deve accettare soltanto un parametro variante, il parametro passato al chiamabile sarà il valore passato al parametro tag quando la voce del menu è stata creata.

Nota: Questo metodo è implementato solo su macOS.

void set_item_max_states(rid: RID, idx: int, max_states: int) 🔗

Imposta il numero di stato di un elemento multistato. Vedi add_multistate_item() per i dettagli.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_radio_checkable(rid: RID, idx: int, checkable: bool) 🔗

Imposta il tipo di voce all'indice idx su pulsante di scelta (radio). Se false, imposta il tipo di voce su testo semplice.

Nota: Questo è puramente estetico; bisogna aggiungere manualmente la logica per spuntare le voci nei gruppi di scelta.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_state(rid: RID, idx: int, state: int) 🔗

Restituisce lo stato di un elemento multistato. Vedi add_multistate_item() per i dettagli.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_submenu(rid: RID, idx: int, submenu_rid: RID) 🔗

Imposta il RID del sottomenu dell'elemento all'indice idx. Il sottomenu è un menu globale che verrebbe mostrato quando si clicca sull'elemento.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_tag(rid: RID, idx: int, tag: Variant) 🔗

Imposta i metadati di una voce, che possono essere di qualunque tipo. Puoi ottenerli in seguito con get_item_tag(), che fornisce un modo semplice per assegnare dati di contesto alle voci.

Nota: Questo metodo è implementato su macOS e Windows.

void set_item_text(rid: RID, idx: int, text: String) 🔗

Imposta il testo della voce all'indice idx.

Nota: Questo metodo è implementato su macOS e Windows.

Imposta una String tooltip dell'elemento all'indice idx.

Nota: Questo metodo è implementato solo su macOS.

void set_minimum_width(rid: RID, width: float) 🔗

Imposta la larghezza minima del menu globale.

Nota: Questo metodo è implementato solo su macOS.

Registri chiamabili da emettere quando il menu sta per essere mostrato.

Nota: Il sistema operativo può simulare l'apertura del menu per tracciare le modifiche alle voci del menu e le scorciatoie globali, nel qual caso il callback di chiusura corrispondente non viene attivato. Utilizza is_opened() per verificare se il menu è attualmente aperto.

Nota: Questo metodo è implementato solo su macOS e Windows.

Registra un chiamabile da emettere dopo la chiusura del menu.

Nota: Questo metodo è implementato solo su macOS.