AcceptDialog

Наследует: Window < Viewport < Node < Object

Наследуется от: ConfirmationDialog

Базовый диалог, используемый для уведомления пользователя.

Описание

По умолчанию AcceptDialog позволяет только принять или закрыть диалоговое окно, результат один и тот же. Однако сигналы confirmed и canceled позволяют сделать эти два действия разными, а метод add_button() позволяет добавлять пользовательские кнопки и действия.

Примечание: AcceptDialog по умолчанию невидим. Чтобы сделать его видимым, вызовите один из методов popup_* из Window узла, например, Window.popup_centered_clamped().

Свойства

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)

Методы

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)

Свойства темы

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

Сигналы

canceled() 🔗

Вызывается при закрытии диалогового окна или нажатии кнопки, созданной с помощью add_cancel_button().

confirmed() 🔗

Излучается при принятии диалога, т.е. когда нажата кнопка OK.

custom_action(action: StringName) 🔗

Генерируется при нажатии пользовательской кнопки с действием. См. add_button().

Описания свойств

bool dialog_autowrap = false 🔗

void set_autowrap(value: bool)
bool has_autowrap()

Устанавливает автоматический перенос текста в диалоге.

bool dialog_close_on_escape = true 🔗

void set_close_on_escape(value: bool)
bool get_close_on_escape()

Если true, диалоговое окно будет скрыто при нажатии действия ui_close_dialog (по умолчанию это действие привязано к клавише Escape или Cmd + W в macOS).

bool dialog_hide_on_ok = true 🔗

void set_hide_on_ok(value: bool)
bool get_hide_on_ok()

Если true, диалоговое окно будет скрыто при нажатии кнопки OK. Вы можете установить значение в false если хотите, например, сделать проверку ввода при получении сигнала confirmed, и обработать сокрытие диалога в своей собственной логике.

Примечание: Некоторые узлы, производные от этого класса, могут иметь другое значение по умолчанию, и потенциально их собственная встроенная логика переопределяет этот параметр. Например, FileDialog имеет значение по умолчанию false и собственный код проверки ввода, который вызывается при нажатии кнопки OK, который в конечном итоге скрывает диалог, если ввод является допустимым. Как таковое, это свойство не может быть использовано в FileDialog для отключения скрытия диалога при нажатии OK.

String dialog_text = "" 🔗

void set_text(value: String)
String get_text()

Текст, отображаемый в диалоговом окне.

String ok_button_text = "" 🔗

void set_ok_button_text(value: String)
String get_ok_button_text()

Текст, отображаемый кнопкой OK (см. get_ok_button()). Если пусто, будет использован текст по умолчанию.

Описания метода

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

Добавляет кнопку с меткой text и настраиваемым параметром action в диалоговое окно и возвращает созданную кнопку.

Если action не пуст, нажатие кнопки сгенерирует сигнал custom_action с указанной строкой действия.

Если true, right разместит кнопку справа от всех родственных кнопок.

Вы можете использовать метод remove_button() для удаления кнопки, созданной с помощью этого метода, из диалогового окна.

Button add_cancel_button(name: String) 🔗

Добавляет кнопку с меткой name и действие отмены в диалоговое окно и возвращает созданную кнопку.

Вы можете использовать метод remove_button(), чтобы удалить кнопку, созданную с помощью этого метода, из диалогового окна.

Label get_label() 🔗

Возвращает метку, используемую для встроенного текста.

Предупреждение: Это обязательный внутренний узел, его удаление и освобождение может привести к сбою. Если вы хотите скрыть его или любой из его дочерних элементов, используйте их свойство CanvasItem.visible.

Button get_ok_button() 🔗

Возвращает экземпляр кнопки OK Button.

Предупреждение: Это обязательный внутренний узел, его удаление и освобождение может привести к сбою. Если вы хотите скрыть его или любой из его дочерних элементов, используйте их свойство CanvasItem.visible.

void register_text_enter(line_edit: LineEdit) 🔗

Регистрирует LineEdit в диалоге. При нажатии клавиши ввода диалог будет принят.

void remove_button(button: Button) 🔗

Удаляет кнопку button из диалогового окна. НЕ освобождает button. button должна быть Button, добавленной с помощью метода add_button() или add_cancel_button(). После удаления нажатие button больше не будет выдавать сигналы custom_action или canceled этого диалогового окна.

Описания свойств темы

int buttons_min_height = 0 🔗

Минимальная высота каждой кнопки в нижнем ряду (например, OK/Отмена) в пикселях. Ее можно увеличить, чтобы кнопки с коротким текстом было легче нажимать/касать.

int buttons_min_width = 0 🔗

Минимальная ширина каждой кнопки в нижнем ряду (например, OK/Отмена) в пикселях. Ее можно увеличить, чтобы кнопки с коротким текстом было легче нажимать/касать.

int buttons_separation = 10 🔗

Размер вертикального пространства между содержимым диалогового окна и рядом кнопок.

StyleBox panel 🔗

Панель которая заполняет задний план окна.