内容

特性
信号
方法
详细描述
Dialog Title and Buttons
模态对话框
非模态对话框

Dialog QML Type

Popup dialog with standard buttons and a title, used for short-term interaction with the user. 更多...

导入语句：	import QtQuick.Controls 2.15
Since:	Qt 5.8
继承：	Popup

所有成员列表，包括继承成员

特性

footer : Item
header : Item
implicitFooterHeight : real
implicitFooterWidth : real
implicitHeaderHeight : real
implicitHeaderWidth : real
result : int
standardButtons : enumeration
title : string

信号

accepted ()
applied ()
discarded ()
helpRequested ()
rejected ()
reset ()

方法

void accept ()
void done (int result )
void reject ()
AbstractButton standardButton (StandardButton button )

详细描述

A dialog is a popup mostly used for short-term tasks and brief communications with the user. Similarly to ApplicationWindow and Page , Dialog is organized into three sections: header , contentItem ，和 footer .

Dialog Title and Buttons

Dialog's title is displayed by a style-specific title bar that is assigned as a dialog header 在默认情况下。

Dialog's standard buttons are managed by a DialogButtonBox that is assigned as a dialog footer by default. The dialog's standardButtons property is forwarded to the respective property of the button box. Furthermore, the accepted() and rejected() signals of the button box are connected to the respective signals in Dialog.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel
    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

A modal dialog blocks input to other content beneath the dialog. When a modal dialog is opened, the user must finish interacting with the dialog and close it before they can access any other content in the same window.

Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

非模态对话框

A modeless dialog is a dialog that operates independently of other content around the dialog. When a modeless dialog is opened, the user is allowed to interact with both the dialog and the other content in the same window.

Dialog {
    id: dialog
    modal: false
    standardButtons: Dialog.Ok
}

另请参阅 DialogButtonBox and 弹出控件 .

特性文档编制

This property holds the dialog footer item. The footer item is positioned to the bottom, and resized to the width of the dialog. The default value is null .

注意： Assigning a DialogButtonBox as a dialog footer automatically connects its accepted() and rejected() signals to the respective signals in Dialog.

注意： Assigning a DialogButtonBox , ToolBar ，或 TabBar as a dialog footer automatically sets the respective DialogButtonBox::position , ToolBar::position ，或 TabBar::position 特性到 Footer .

另请参阅 header .

header : Item

This property holds the dialog header item. The header item is positioned to the top, and resized to the width of the dialog. The default value is null .

注意： Assigning a DialogButtonBox as a dialog header automatically connects its accepted() and rejected() signals to the respective signals in Dialog.

注意： Assigning a DialogButtonBox , ToolBar ，或 TabBar as a dialog header automatically sets the respective DialogButtonBox::position , ToolBar::position ，或 TabBar::position 特性到 Header .

另请参阅 footer .

[read-only] implicitFooterHeight : real

This property holds the implicit footer height.

值等于 footer && footer.visible ? footer.implicitHeight : 0 .

该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。

另请参阅 implicitFooterWidth and implicitHeaderHeight .

[read-only] implicitFooterWidth : real

This property holds the implicit footer width.

值等于 footer && footer.visible ? footer.implicitWidth : 0 .

该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。

另请参阅 implicitFooterHeight and implicitHeaderWidth .

[read-only] implicitHeaderHeight : real

This property holds the implicit header height.

值等于 header && header.visible ? header.implicitHeight : 0 .

该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。

另请参阅 implicitHeaderWidth and implicitFooterHeight .

[read-only] implicitHeaderWidth : real

This property holds the implicit header width.

值等于 header && header.visible ? header.implicitWidth : 0 .

该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。

另请参阅 implicitHeaderHeight and implicitFooterWidth .

result : int

This property holds the result code.

Standard result codes:

常量	描述
`Dialog.Accepted`	The dialog was accepted.
`Dialog.Rejected`	The dialog was rejected.

该特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。

另请参阅 accept() , reject() ，和 done() .

standardButtons : enumeration

This property holds a combination of standard buttons that are used by the dialog.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel
    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

The buttons will be positioned in the appropriate order for the user's platform.

Possible flags:

常量	描述
`Dialog.Ok`	An "OK" button defined with the `AcceptRole` .
`Dialog.Open`	An "Open" button defined with the `AcceptRole` .
`Dialog.Save`	A "Save" button defined with the `AcceptRole` .
`Dialog.Cancel`	A "Cancel" button defined with the `RejectRole` .
`Dialog.Close`	A "Close" button defined with the `RejectRole` .
`Dialog.Discard`	A "Discard" or "Don't Save" button, depending on the platform, defined with the `DestructiveRole` .
`Dialog.Apply`	An "Apply" button defined with the `ApplyRole` .
`Dialog.Reset`	A "Reset" button defined with the `ResetRole` .
`Dialog.RestoreDefaults`	A "Restore Defaults" button defined with the `ResetRole` .
`Dialog.Help`	A "Help" button defined with the `HelpRole` .
`Dialog.SaveAll`	A "Save All" button defined with the `AcceptRole` .
`Dialog.Yes`	A "Yes" button defined with the `YesRole` .
`Dialog.YesToAll`	A "Yes to All" button defined with the `YesRole` .
`Dialog.No`	A "No" button defined with the `NoRole` .
`Dialog.NoToAll`	A "No to All" button defined with the `NoRole` .
`Dialog.Abort`	An "Abort" button defined with the `RejectRole` .
`Dialog.Retry`	A "Retry" button defined with the `AcceptRole` .
`Dialog.Ignore`	An "Ignore" button defined with the `AcceptRole` .
`Dialog.NoButton`	无效按钮。

另请参阅 DialogButtonBox .

title : string

This property holds the dialog title.

The title is displayed in the dialog header.

Dialog {
    title: qsTr("About")
    Label {
        text: "Lorem ipsum..."
    }
}

信号文档编制

accepted ()

This signal is emitted when the dialog has been accepted either interactively or by calling accept() .

注意： This signal is not emitted when closing the dialog with close() or setting visible to false .

注意： 相应处理程序是 onAccepted .

另请参阅 rejected() .

applied ()

此信号被发射当 Dialog.Apply standard button is clicked.

注意： 相应处理程序是 onApplied .

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

另请参阅 discarded() and reset() .

discarded ()

此信号被发射当 Dialog.Discard standard button is clicked.

注意： 相应处理程序是 onDiscarded .

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

另请参阅 reset() and applied() .

helpRequested ()

此信号被发射当 Dialog.Help standard button is clicked.

注意： 相应处理程序是 onHelpRequested .

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

另请参阅 accepted() and rejected() .

rejected ()

This signal is emitted when the dialog has been rejected either interactively or by calling reject() .

注意： This signal is not emitted when closing the dialog with close() or setting visible to false .

注意： 相应处理程序是 onRejected .

另请参阅 accepted() .

reset ()

此信号被发射当 Dialog.Reset standard button is clicked.

注意： 相应处理程序是 onReset .

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

另请参阅 discarded() and applied() .

方法文档编制

void accept ()

Closes the dialog and emits the accepted() 信号。

另请参阅 reject() and done() .

void done ( int result )

Closes the dialog, sets the result ，和发射 accepted() or rejected() depending on whether the result is Dialog.Accepted or Dialog.Rejected ，分别。

This method was introduced in QtQuick.Controls 2.3 (Qt 5.10).

另请参阅 accept() , reject() ，和 result .

void reject ()

Closes the dialog and emits the rejected() 信号。

另请参阅 accept() and done() .

AbstractButton standardButton ( StandardButton button )

Returns the specified standard button ，或 null if it does not exist.

This method was introduced in QtQuick.Controls 2.3 (Qt 5.10).

另请参阅 standardButtons .