AcceptDialog

Успадковує: Window < Viewport < Node < Object

Успадковано від: ConfirmationDialog

Базове діалогове вікно, яке використовується для сповіщень користувача.

Опис

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

Властивості

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_cancel (за замовчуванням ця дія пов’язана з @GlobalScope.KEY_ESCAPE).

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 🔗

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