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() 🔗

Випромінюється, коли діалогове вікно приймається, тобто натискається кнопка ОК.

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() 🔗

Повертає екземпляр Button OK.

Попередження: Це обов'язковий внутрішній вузол, вилучення або звільнення якого може призвести до аварійного завершення роботи програми. Якщо ви хочете приховати його або будь-який з його дочірніх елементів, скористайтеся їхньою властивістю 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 🔗

За замовчуванням AcceptDialog дозволяє лише використовувати або закривати його з тим самим результатом. Однак сигнали сигнал підтверджено і сигнал скасовано можуть зробити дві дії позитивними, а метод add_button() дозволяє додавати власні кнопки та дії.

int buttons_min_width = 0 🔗

Мінімальна ширина кожної кнопки в нижньому рядку (наприклад, OK/Cancel) у пікселях. Це можна збільшити, щоб кнопки з коротким текстом було легше натискати.

int buttons_separation = 10 🔗

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

StyleBox panel 🔗

Панель, яка заповнює фон вікна.