AcceptDialog

继承： Window < Viewport < Node < Object

派生： ConfirmationDialog

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

描述

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

属性

方法

主题属性

信号

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，当按下退出键（@GlobalScope.KEY_ESCAPE）时，对话框将被隐藏。

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 = "OK" 🔗

• 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 🔗

填充窗口背景的面板。