AcceptDialog

Inherits: WindowDialog < Popup < Control < CanvasItem < Node < Object

Inherited By: ConfirmationDialog

用户通知的基本对话框。

描述

该对话框对于向用户发送有关事件的小通知很有用。它只能被接受或关闭,并且结果相同。

属性

方法

信号

• confirmed ( )

接受对话框时，即按下OK按钮时发出。

• custom_action ( String action )

按下自定义按钮时发出。 参阅add_button。

属性说明

• bool dialog_autowrap

为对话框中的文本设置自动换行。

• bool dialog_hide_on_ok

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

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

• String dialog_text

对话框显示的文本。

方法说明

• Button add_button ( String text, bool right=false, String action=”” )

向对话框中添加一个带有标签text和自定义action的按钮，并返回该创建的按钮。按下时，action会被传递给custom_action信号。

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

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

• Button add_cancel ( String name )

向对话框中添加一个标签为name和一个取消动作的按钮，然后返回这个新创建的按钮。

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

• Label get_label ( )

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

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

• Button get_ok ( )

返回确定按钮 Button 实例。

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

• void register_text_enter ( Node line_edit )

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

• void remove_button ( Control button )

从对话框中移除 button。但不释放 该button对象。button 必须是添加有 add_button 或 add_cancel 方法的 Button。移除后，按下该button将不再发出此对话框的custom_action信号或取消此对话框。