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

Наследует: 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 🔗

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