Popup dialog with standard buttons and a title, used for short-term interaction with the user. 更多...
import 语句: | import QtQuick.Controls |
继承: |
(since QtQuick.Controls 2.5 (Qt 5.12))
(since QtQuick.Controls 2.5 (Qt 5.12))
(since QtQuick.Controls 2.5 (Qt 5.12))
(since QtQuick.Controls 2.5 (Qt 5.12))
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.3 (Qt 5.10))
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 .
The padding properties only affect the contentItem. Use the spacing property to affect the space between header, contentItem and footer.
By default, Dialogs have focus .
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 () 和 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 弹出控件 .
footer : Item |
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 () 和 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 () 和 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
特性到
头
.
另请参阅 footer .
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 .
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 .
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 .
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 ().
|
此信号发射当
Dialog.Apply
standard button is clicked.
注意:
相应处理程序是
onApplied
.
This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).
|
此信号发射当
Dialog.Discard
standard button is clicked.
注意:
相应处理程序是
onDiscarded
.
This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).
|
此信号发射当
Dialog.Help
standard button is clicked.
注意:
相应处理程序是
onHelpRequested
.
This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).
另请参阅 accepted () 和 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 ().
|
此信号发射当
Dialog.Reset
standard button is clicked.
注意:
相应处理程序是
onReset
.
This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).
另请参阅 discarded () 和 applied ().
void accept () |
Emits the accepted () signal and closes the dialog.
|
Dialog.Accepted
or
Dialog.Rejected
,分别。
This method was introduced in QtQuick.Controls 2.3 (Qt 5.10).
另请参阅 accept (), reject (),和 result .
void reject () |
Emits the rejected () signal and closes the dialog.
|
Returns the specified standard
button
,或
null
if it does not exist.
This method was introduced in QtQuick.Controls 2.3 (Qt 5.10).
另请参阅 standardButtons .