AcceptDialog

继承： Window < Viewport < Node < Object

用于用户通知的基本对话框。

描述

AcceptDialog 的默认用途是允许它只被接受或关闭，结果相同。但是，confirmed 和 canceled 信号允许使两个动作不同，add_button() 方法允许添加自定义按钮和动作。

注意：AcceptDialog 默认情况下是隐藏的。若要显示，调用节点上来自 Window 的 popup_* 方法中的其中一个，比如 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_cancel 动作时会隐藏对话框（该动作默认绑定至 Escape，在 macOS 上则是 Cmd + W）。

bool dialog_hide_on_ok = true 🔗

void set_hide_on_ok(value: bool)
bool get_hide_on_ok()

如果为 true，按下确定按钮时对话框将隐藏。如果要在收到 confirmed 信号时执行类似输入验证的操作，则可以将其设置为 false，然后在自己的逻辑中处理对话框的隐藏。

注意：从此类派生的某些节点可以具有不同的默认值，并且可能有自己的内置逻辑会覆盖此设置。例如 FileDialog 默认其为 false，并在按下确定时实现了自己的输入验证代码，如果输入有效，最终将隐藏对话框。因此，不能在 FileDialog 中使用此属性来禁止在按确定时隐藏对话框。

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

确定按钮显示的文本（见 get_ok_button()）。留空时使用默认文本。

方法说明

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

将带有标签 text 和自定义 action 的按钮添加到对话框，并返回该创建的按钮。

如果 action 不为空，按下按钮将发出具有指定动作字符串的 custom_action 信号。

如果 right 为 true，按钮会被放置在所有同级按钮的右侧。

可以使用 remove_button() 方法从对话框中移除使用该方法创建的按钮。

Button add_cancel_button(name: String) 🔗

在对话框中添加一个带有标签 name 和取消动作的按钮，并返回创建的按钮。

你可以使用 remove_button() 方法从对话框中删除用此方法创建的按钮。

Label get_label() 🔗

返回内置文本所使用的标签。

警告：这是个必要的内部节点，移除并释放它有可能造成崩溃。如果你希望隐藏它或它的任意一个子节点，请使用它们的 CanvasItem.visible 属性。

Button get_ok_button() 🔗

返回确定按钮 Button 实例。

警告：这是个必要的内部节点，移除并释放它有可能造成崩溃。如果你希望隐藏它或它的任意一个子节点，请使用它们的 CanvasItem.visible 属性。

void register_text_enter(line_edit: LineEdit) 🔗

在对话框中注册 LineEdit。当按下回车键时，对话框将被接受。

void remove_button(button: Button) 🔗

从对话框中移除 button。但不释放该 button 对象。button 必须是用 add_button() 或 add_cancel_button() 方法添加的 Button。移除后，按下该 button 将不再发出该对话框的 custom_action 或 canceled 信号。

主题属性说明

int buttons_min_height = 0 🔗

底部按钮（如确定、取消）的最小高度，单位为像素。可以让文本较短的按钮更便于点击/点按。

int buttons_min_width = 0 🔗

底部按钮（如确定、取消）的最小宽度，单位为像素。可以让文本较短的按钮更便于点击/点按。

int buttons_separation = 10 🔗

对话框内容和按钮行之间的垂直空间的大小。

StyleBox panel 🔗

填充窗口背景的面板。