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

AcceptDialog

Eredita: Window < Viewport < Node < Object

Ereditato da: ConfirmationDialog

Una finestra di dialogo di base utilizzata per la notifica dell'utente.

Descrizione

L'uso predefinito di AcceptDialog è quello di consentire che sia accettato o chiuso, con lo stesso risultato. Tuttavia, i segnali confirmed e canceled permettono di distinguere le due azioni, e il metodo add_button() consente di aggiungere pulsanti e azioni personalizzate.

Nota: AcceptDialog è inizialmente invisibile. Per renderlo visibile, chiama uno dei metodi popup_* da Window sul nodo, come ad esempio Window.popup_centered_clamped().

Proprietà

bool	dialog_autowrap	`false`
bool	dialog_close_on_escape	`true`
bool	dialog_hide_on_ok	`true`
String	dialog_text	`""`
bool	exclusive	`true` (overrides Window)
bool	keep_title_visible	`true` (overrides Window)
bool	maximize_disabled	`true` (overrides Window)
bool	minimize_disabled	`true` (overrides Window)
String	ok_button_text	`""`
String	title	`"Alert!"` (overrides Window)
bool	transient	`true` (overrides Window)
bool	visible	`false` (overrides Window)
bool	wrap_controls	`true` (overrides Window)

Metodi

Button	add_button(text: String, right: bool = false, action: String = "")
Button	add_cancel_button(name: String)
Label	get_label()
Button	get_ok_button()
void	register_text_enter(line_edit: LineEdit)
void	remove_button(button: Button)

Proprietà del tema

int	buttons_min_height	`0`
int	buttons_min_width	`0`
int	buttons_separation	`10`
StyleBox	panel

Segnali

canceled() 🔗

Emesso quando la finestra di dialogo è chiusa o un pulsante creato con add_cancel_button() viene premuto.

confirmed() 🔗

Emesso quando la finestra di dialogo è accettata, ossia quando il pulsante OK viene premuto.

custom_action(action: StringName) 🔗

Emesso quando viene premuto un pulsante personalizzato con un'azione. Vedi add_button().

Descrizioni delle proprietà

bool dialog_autowrap = false 🔗

void set_autowrap(value: bool)
bool has_autowrap()

Imposta il ritorno a capo automatico per il testo nella finestra di dialogo.

bool dialog_close_on_escape = true 🔗

void set_close_on_escape(value: bool)
bool get_close_on_escape()

Se true, la finestra di dialogo sarà nascosta quando viene premuta l'azione ui_close_dialog (normalmente, questa azione è associata a Escape, o Cmd + W su macOS).

bool dialog_hide_on_ok = true 🔗

void set_hide_on_ok(value: bool)
bool get_hide_on_ok()

Se true, la finestra di dialogo è nascosta quando il pulsante OK viene premuto. È possibile impostarlo a false se si desidera eseguire, ad esempio, validazione di input quando si riceve il segnale confirmed e gestire come la finestra di dialogo viene nascosta nel proprio codice.

Nota: Alcuni nodi derivati da questa classe possono avere un valore predefinito diverso, ed eventualmente la loro logica integrata che sovrascrive questa impostazione. Ad esempio per un FileDialog è predefinito a false, e ha il proprio codice di validazione di input che viene chiamato quando si preme OK, che nasconde infine la finestra di dialogo se l'input è valido. Perciò, questa proprietà non può essere utilizzata in FileDialog per prevenire che la finestra di dialogo diventi nascosta quando si preme OK.

String dialog_text = "" 🔗

void set_text(value: String)
String get_text()

Il testo visualizzato per la finestra di dialogo.

String ok_button_text = "" 🔗

void set_ok_button_text(value: String)
String get_ok_button_text()

Il testo visualizzato dal pulsante di conferma (vedi get_ok_button()). Se vuoto, un testo predefinito sarà utilizzato.

Descrizioni dei metodi

Button add_button(text: String, right: bool = false, action: String = "") 🔗

Aggiunge un pulsante con l'etichetta text e una azione action personalizzata alla finestra di dialogo e restituisce il pulsante creato.

Se action non è vuoto, premendo il pulsante verrà emesso il segnale custom_action con la stringa di azione specificata.

Se true, right metterà il pulsante a destra di eventuali pulsanti fratelli.

È possibile usare il metodo remove_button() per rimuovere un pulsante creato con questo metodo dalla finestra di dialogo.

Button add_cancel_button(name: String) 🔗

Aggiunge un pulsante con l'etichetta name e un'azione di cancellazione alla finestra di dialogo e restituisce il pulsante creato.

È possibile utilizzare il metodo remove_button() per rimuovere un pulsante creato con questo metodo dalla finestra di dialogo.

Label get_label() 🔗

Restituisce l'etichetta utilizzata per il testo integrato.

Attenzione: Questo è un nodo interno necessario, rimuoverlo e liberarlo potrebbe causare un crash. Se si desidera nascondere esso o uno dei suoi figli, utilizza le loro proprietà CanvasItem.visible.

Button get_ok_button() 🔗

Restituisce l'istanza del Button di accettazione.

Attenzione: Questo è un nodo interno necessario, rimuoverlo e liberarlo potrebbe causare un crash. Se si desidera nascondere esso o uno dei suoi figli, utilizza le loro proprietà CanvasItem.visible.

void register_text_enter(line_edit: LineEdit) 🔗

Registra un LineEdit nella finestra di dialogo. Quando viene premuto il tasto invio, la finestra di dialogo verrà accettata.

void remove_button(button: Button) 🔗

Rimuove il button dalla finestra di dialogo. NON libera il button. Il pulsante button deve essere un Button aggiunto con il metodo add_button() o add_cancel_button(). Dopo la rimozione, premere il button non emetterà più i segnali custom_action o canceled di questo dialogo.

Descrizioni delle proprietà del tema

int buttons_min_height = 0 🔗

L'altezza minima di ogni pulsante nella riga inferiore (come OK o Cancella) in pixel. Questa può essere aumentata per rendere i pulsanti con testi brevi più facili da cliccare o toccare.

int buttons_min_width = 0 🔗

La larghezza minima di ogni pulsante nella riga inferiore (come OK o Cancella) in pixel. Questa può essere aumentata per rendere i pulsanti con testi brevi più facili da cliccare o toccare.

int buttons_separation = 10 🔗

La dimensione dello spazio verticale tra il contenuto della finestra di dialogo e la riga dei pulsanti.

StyleBox panel 🔗

Il pannello che riempie lo sfondo della finestra.