AcceptDialog¶
Inherits: WindowDialog < Popup < Control < CanvasItem < Node < Object
Inherited By: ConfirmationDialog
用户通知的基本对话框。
描述¶
该对话框对于向用户发送有关事件的小通知很有用。它只能被接受或关闭,并且结果相同。
属性¶
|
||
|
||
|
||
window_title |
|
方法¶
add_button ( String text, bool right=false, String action="" ) |
|
add_cancel ( String name ) |
|
get_label ( ) |
|
get_ok ( ) |
|
void |
register_text_enter ( Node line_edit ) |
void |
remove_button ( Control button ) |
信号¶
confirmed ( )
接受对话框时,即按下OK按钮时发出。
custom_action ( String action )
按下自定义按钮时发出。 参阅add_button。
属性说明¶
bool dialog_autowrap
Default |
|
Setter |
set_autowrap(value) |
Getter |
has_autowrap() |
为对话框中的文本设置自动换行。
bool dialog_hide_on_ok
Default |
|
Setter |
set_hide_on_ok(value) |
Getter |
get_hide_on_ok() |
如果为 true
,按下OK按钮时对话框将隐藏。如果要在收到 confirmed 信号时执行类似输入验证的操作,则可以将其设置为false
,然后在自己的逻辑中处理对话框的隐藏。
注意: 从此类派生的某些节点可以具有不同的默认值,并且可能有自己的内置逻辑会覆盖此设置。 例如,FileDialog 默认其为 false
,并在按下OK时实现了自己的输入验证代码,如果输入有效,最终将隐藏对话框。因此,不能在 FileDialog 中使用此属性来禁止在按OK时隐藏对话框。
String dialog_text
Default |
|
Setter |
set_text(value) |
Getter |
get_text() |
对话框显示的文本。
方法说明¶
向对话框中添加一个带有标签text
和自定义action
的按钮,并返回该创建的按钮。按下时,action
会被传递给custom_action信号。
如果right
为true
,按钮会被放置在所有同级按钮的右边。
您可以使用 remove_button 方法从对话框中删除使用此方法创建的按钮。
向对话框中添加一个标签为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信号或取消此对话框。