AcceptDialog

Hereda: Window < Viewport < Node < Object

Un diálogo base utilizado para la notificación al usuario.

Descripción

El uso predeterminado de AcceptDialog es permitir que solo se acepte o se cierre, con el mismo resultado. Sin embargo, las señales confirmed y canceled permiten diferenciar ambas acciones, y el método add_button() permite agregar botones y acciones personalizadas.

Propiedades

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)

Métodos

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)

Propiedades del Tema

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

Señales

canceled() 🔗

Emitida cuando se cierra el diálogo o se pulsa el botón creado con add_cancel_button().

confirmed() 🔗

Emitida cuando se acepta el diálogo, es decir, se pulsa el botón OK.

custom_action(action: StringName) 🔗

Emitida cuando se pulsa un botón personalizado con una acción. Véase add_button().

Descripciones de Propiedades

bool dialog_autowrap = false 🔗

void set_autowrap(value: bool)
bool has_autowrap()

El texto se expande automáticamente en el diálogo.

bool dialog_close_on_escape = true 🔗

void set_close_on_escape(value: bool)
bool get_close_on_escape()

Si es true, el diálogo se ocultará cuando se pulse la acción ui_cancel (por defecto, esta acción está vinculada a @GlobalScope.KEY_ESCAPE).

bool dialog_hide_on_ok = true 🔗

void set_hide_on_ok(value: bool)
bool get_hide_on_ok()

Si es true, el diálogo se oculta cuando se pulsa el botón OK. Puedes ajustarlo a false si quieres hacer, por ejemplo, la validación de entrada al recibir la señal confirmed, y manejar el ocultamiento del diálogo en tu propia lógica.

Nota: Algunos nodos derivados de esta clase pueden tener un valor por defecto diferente, y potencialmente su propia lógica incorporada anulando este ajuste. Por ejemplo, FileDialog tiene por defecto false, y tiene su propio código de validación de entrada que se llama al pulsar OK, que eventualmente oculta el diálogo si la entrada es válida. Como tal, esta propiedad no puede ser usada en FileDialog para deshabilitar la ocultación del diálogo cuando se presiona OK.

String dialog_text = "" 🔗

void set_text(value: String)
String get_text()

El texto mostrado en el diálogo.

String ok_button_text = "" 🔗

void set_ok_button_text(value: String)
String get_ok_button_text()

El texto que muestra el botón Aceptar (véase get_ok_button()). Si está vacío, se utilizará un texto por defecto.

Descripciones de Métodos

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

Añade un botón con la etiqueta text y una action personalizada al diálogo y devuelve el botón creado.

Si action no está vacío, al pulsar el botón se emitirá la señal custom_action con la string de acción especificada.

Si es true, right colocará el botón a la derecha de cualquier botón hermano.

Puede utilizar el método remove_button() para eliminar un botón creado con este método del diálogo.

Button add_cancel_button(name: String) 🔗

Añade un botón con la etiqueta name y una acción de cancelación al diálogo y devuelve el botón creado.

Puedes usar el método remove_button() para eliminar un botón creado con este método del diálogo.

Label get_label() 🔗

Devuelve la etiqueta utilizada para el texto integrado.

Advertencia: Este es un nodo interno requerido, eliminarlo o liberarlo puede causar un fallo. Si deseas ocultarlo o cualquiera de sus hijos, usa su propiedad CanvasItem.visible.

Button get_ok_button() 🔗

Retorna la instancia de el Button aceptar.

Warning: Esto es un nodo interno requerido, removerlo y liberarlo podría causar un crasheo. Si deseas esconder este o alguno de sus hijos, utiliza su propiedad CanvasItem.visible.

void register_text_enter(line_edit: LineEdit) 🔗

Registra un LineEdit en el diálogo. Cuando se pulsa la tecla intro, el diálogo se acepta.

void remove_button(button: Button) 🔗

Elimina el button del diálogo. NO libera el button. El button debe ser un Button añadido con el método add_button() o el método add_cancel_button(). Después de la eliminación, al pulsar el button ya no se emitirán las señales custom_action o canceled de este diálogo.

Descripciones de las propiedades del tema

int buttons_min_height = 0 🔗

La altura mínima de cada botón en la fila inferior (como Aceptar/Cancelar) en píxeles. Esto se puede aumentar para facilitar hacer clic/tocar en botones con textos cortos.

int buttons_min_width = 0 🔗

El ancho mínimo de cada botón en la fila inferior (como Aceptar/Cancelar) en píxeles. Esto se puede aumentar para facilitar hacer clic/tocar en botones con textos cortos.

int buttons_separation = 10 🔗

El tamaño del espacio vertical entre el contenido del diálogo y la fila de botones.

StyleBox panel 🔗

El panel que llena el fondo de la ventana.