The QDialogButtonBox class is a widget that presents buttons in a layout that is appropriate to the current widget style. 更多...
| 頭： | #include <QDialogButtonBox> |
| qmake: | QT += widgets |
| Since: | Qt 4.2 |
| 繼承： | QWidget |
| enum | ButtonLayout { WinLayout, MacLayout, KdeLayout, GnomeLayout, AndroidLayout } |
| enum | ButtonRole { InvalidRole, AcceptRole, RejectRole, DestructiveRole, ..., NRoles } |
| enum | StandardButton { Ok, Open, Save, Cancel, ..., NoButton } |
| flags | StandardButtons |
| QDialogButtonBox (QWidget * parent = nullptr) | |
| QDialogButtonBox (Qt::Orientation orientation , QWidget * parent = nullptr) | |
| QDialogButtonBox (QDialogButtonBox::StandardButtons buttons , QWidget * parent = nullptr) | |
| QDialogButtonBox (QDialogButtonBox::StandardButtons buttons , Qt::Orientation orientation , QWidget * parent = nullptr) | |
| virtual | ~QDialogButtonBox () |
| void | addButton (QAbstractButton * button , QDialogButtonBox::ButtonRole role ) |
| QPushButton * | addButton (const QString & text , QDialogButtonBox::ButtonRole role ) |
| QPushButton * | addButton (QDialogButtonBox::StandardButton button ) |
| QPushButton * | button (QDialogButtonBox::StandardButton which ) const |
| QDialogButtonBox::ButtonRole | buttonRole (QAbstractButton * button ) const |
| QList<QAbstractButton *> | buttons () const |
| bool | centerButtons () const |
| void | clear () |
| Qt::Orientation | orientation () const |
| void | removeButton (QAbstractButton * button ) |
| void | setCenterButtons (bool center ) |
| void | setOrientation (Qt::Orientation orientation ) |
| void | setStandardButtons (QDialogButtonBox::StandardButtons buttons ) |
| QDialogButtonBox::StandardButton | standardButton (QAbstractButton * button ) const |
| QDialogButtonBox::StandardButtons | standardButtons () const |
| void | accepted () |
| void | clicked (QAbstractButton * button ) |
| void | helpRequested () |
| void | rejected () |
| const QMetaObject | staticMetaObject |
| virtual void | changeEvent (QEvent * event ) override |
| virtual bool | event (QEvent * event ) override |
The QDialogButtonBox class is a widget that presents buttons in a layout that is appropriate to the current widget style.
Dialogs and message boxes typically present buttons in a layout that conforms to the interface guidelines for that platform. Invariably, different platforms have different layouts for their dialogs. QDialogButtonBox allows a developer to add buttons to it and will automatically use the appropriate layout for the user's desktop environment.
大多數對話框按鈕遵循某些角色。這些角色包括：
There can also be alternate ways of dismissing the dialog which may cause destructive results.
Most dialogs have buttons that can almost be considered standard (e.g. OK and Cancel buttons). It is sometimes convenient to create these buttons in a standard way.
There are a couple ways of using QDialogButtonBox . One ways is to create the buttons (or button texts) yourself and add them to the button box, specifying their role.
findButton = new QPushButton(tr("&Find"));
findButton->setDefault(true);
moreButton = new QPushButton(tr("&More"));
moreButton->setCheckable(true);
moreButton->setAutoDefault(false);
另外， QDialogButtonBox provides several standard buttons (e.g. OK, Cancel, Save) that you can use. They exist as flags so you can OR them together in the constructor.
buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok
| QDialogButtonBox::Cancel);
connect(buttonBox, &QDialogButtonBox::accepted, this, &QDialog::accept);
connect(buttonBox, &QDialogButtonBox::rejected, this, &QDialog::reject);
You can mix and match normal buttons and standard buttons.
Currently the buttons are laid out in the following way if the button box is horizontal:
|
Button box laid out in horizontal GnomeLayout |
|
Button box laid out in horizontal KdeLayout |
|
Button box laid out in horizontal MacLayout |
|
Button box laid out in horizontal WinLayout |
The buttons are laid out the following way if the button box is vertical:
| GnomeLayout | KdeLayout | MacLayout | WinLayout |
|
|
|
|
Additionally, button boxes that contain only buttons with ActionRole or HelpRole can be considered modeless and have an alternate look on macOS :
| 非模態水平 MacLayout |
|
| 非模態垂直 MacLayout |
|
When a button is clicked in the button box, the clicked () signal is emitted for the actual button is that is pressed. For convenience, if the button has an AcceptRole , RejectRole ，或 HelpRole ， accepted (), rejected ()，或 helpRequested () signals are emitted respectively.
If you want a specific button to be default you need to call QPushButton::setDefault () on it yourself. However, if there is no default button set and to preserve which button is the default button across platforms when using the QPushButton::autoDefault property, the first push button with the accept role is made the default button when the QDialogButtonBox is shown,
另請參閱 QMessageBox , QPushButton ，和 QDialog .
This enum describes the layout policy to be used when arranging the buttons contained in the button box.
| 常量 | 值 | 描述 |
|---|---|---|
QDialogButtonBox::WinLayout
|
0
|
Use a policy appropriate for applications on Windows. |
QDialogButtonBox::MacLayout
|
1
|
Use a policy appropriate for applications on macOS . |
QDialogButtonBox::KdeLayout
|
2
|
Use a policy appropriate for applications on KDE. |
QDialogButtonBox::GnomeLayout
|
3
|
Use a policy appropriate for applications on GNOME. |
QDialogButtonBox::AndroidLayout
|
GnomeLayout + 2
|
Use a policy appropriate for applications on Android. This enum value was added in Qt 5.10. |
The button layout is specified by the current style . However, on the X11 platform, it may be influenced by the desktop environment.
These enums describe flags for standard buttons. Each button has a defined ButtonRole .
| 常量 | 值 | 描述 |
|---|---|---|
QDialogButtonBox::Ok
|
0x00000400
|
An "OK" button defined with the AcceptRole . |
QDialogButtonBox::Open
|
0x00002000
|
An "Open" button defined with the AcceptRole . |
QDialogButtonBox::Save
|
0x00000800
|
A "Save" button defined with the AcceptRole . |
QDialogButtonBox::Cancel
|
0x00400000
|
A "Cancel" button defined with the RejectRole . |
QDialogButtonBox::Close
|
0x00200000
|
A "Close" button defined with the RejectRole . |
QDialogButtonBox::Discard
|
0x00800000
|
A "Discard" or "Don't Save" button, depending on the platform, defined with the DestructiveRole . |
QDialogButtonBox::Apply
|
0x02000000
|
An "Apply" button defined with the ApplyRole . |
QDialogButtonBox::Reset
|
0x04000000
|
A "Reset" button defined with the ResetRole . |
QDialogButtonBox::RestoreDefaults
|
0x08000000
|
A "Restore Defaults" button defined with the ResetRole . |
QDialogButtonBox::Help
|
0x01000000
|
A "Help" button defined with the HelpRole . |
QDialogButtonBox::SaveAll
|
0x00001000
|
A "Save All" button defined with the AcceptRole . |
QDialogButtonBox::Yes
|
0x00004000
|
A "Yes" button defined with the YesRole . |
QDialogButtonBox::YesToAll
|
0x00008000
|
A "Yes to All" button defined with the YesRole . |
QDialogButtonBox::No
|
0x00010000
|
A "No" button defined with the NoRole . |
QDialogButtonBox::NoToAll
|
0x00020000
|
A "No to All" button defined with the NoRole . |
QDialogButtonBox::Abort
|
0x00040000
|
An "Abort" button defined with the RejectRole . |
QDialogButtonBox::Retry
|
0x00080000
|
A "Retry" button defined with the AcceptRole . |
QDialogButtonBox::Ignore
|
0x00100000
|
An "Ignore" button defined with the AcceptRole . |
QDialogButtonBox::NoButton
|
0x00000000
|
無效按鈕。 |
StandardButtons 類型是 typedef 對於 QFlags <StandardButton>. It stores an OR combination of StandardButton values.
另請參閱 ButtonRole and standardButtons .
This property holds whether the buttons in the button box are centered
默認情況下，此特性為
false
. This behavior is appopriate for most types of dialogs. A notable exception is message boxes on most platforms (e.g. Windows), where the button box is centered horizontally.
訪問函數：
| bool | centerButtons () const |
| void | setCenterButtons (bool center ) |
另請參閱 QMessageBox .
This property holds the orientation of the button box
By default, the orientation is horizontal (i.e. the buttons are laid out side by side). The possible orientations are Qt::Horizontal and Qt::Vertical .
訪問函數：
| Qt::Orientation | orientation () const |
| void | setOrientation (Qt::Orientation orientation ) |
collection of standard buttons in the button box
This property controls which standard buttons are used by the button box.
訪問函數：
| QDialogButtonBox::StandardButtons | standardButtons () const |
| void | setStandardButtons (QDialogButtonBox::StandardButtons buttons ) |
另請參閱 addButton ().
This enum describes the roles that can be used to describe buttons in the button box. Combinations of these roles are as flags used to describe different aspects of their behavior.
| 常量 | 描述 |
|---|---|
InvalidRole
|
按鈕無效。 |
AcceptRole
|
Clicking the button causes the dialog to be accepted (e.g. OK). |
RejectRole
|
Clicking the button causes the dialog to be rejected (e.g. Cancel). |
DestructiveRole
|
Clicking the button causes a destructive change (e.g. for Discarding Changes) and closes the dialog. |
ActionRole
|
點擊按鈕導緻對話框中元素改變。 |
HelpRole
|
可以點擊按鈕以請求幫助。 |
YesRole
|
像 Yes 按鈕的按鈕。 |
NoRole
|
The button is a "No"-like button. |
ApplyRole
|
The button applies current changes. |
ResetRole
|
The button resets the dialog's fields to default values. |
另請參閱 StandardButton .
構造空的水平按鈕框采用給定 parent .
另請參閱 orientation and addButton ().
構造空按鈕框采用給定 orientation and parent .
另請參閱 orientation and addButton ().
構造水平按鈕框采用給定 parent ，包含的標準按鈕指定通過 buttons .
該函數在 Qt 5.2 引入。
另請參閱 orientation and addButton ().
構造按鈕框采用給定 orientation and parent ，包含的標準按鈕指定通過 buttons .
另請參閱 orientation and addButton ().
[虛擬]
QDialogButtonBox::
~QDialogButtonBox
()
銷毀按鈕框。
[signal]
void
QDialogButtonBox::
accepted
()
此信號被發射當點擊按鈕框內按鈕時，隻要它的定義是采用 AcceptRole or YesRole .
另請參閱 rejected (), clicked ()，和 helpRequested ().
添加給定 button to the button box with the specified role . If the role is invalid, the button is not added.
If the button has already been added, it is removed and added again with the new role.
注意： The button box takes ownership of the button.
另請參閱 removeButton () 和 clear ().
Creates a push button with the given text , adds it to the button box for the specified role , and returns the corresponding push button. If role is invalid, no button is created, and zero is returned.
另請參閱 removeButton () 和 clear ().
添加標準 button to the button box if it is valid to do so, and returns a push button. If button is invalid, it is not added to the button box, and zero is returned.
另請參閱 removeButton () 和 clear ().
返迴 QPushButton 對應標準按鈕 which , or 0 if the standard button doesn't exist in this button box.
另請參閱 standardButton (), standardButtons ()，和 buttons ().
Returns the button role for the specified button 。此函數返迴 InvalidRole if button is 0 or has not been added to the button box.
另請參閱 buttons () 和 addButton ().
Returns a list of all the buttons that have been added to the button box.
另請參閱 buttonRole (), addButton ()，和 removeButton ().
[override virtual protected]
void
QDialogButtonBox::
changeEvent
(
QEvent
*
event
)
重實現自 QWidget::changeEvent ().
Clears the button box, deleting all buttons within it.
另請參閱 removeButton () 和 addButton ().
[signal]
void
QDialogButtonBox::
clicked
(
QAbstractButton
*
button
)
This signal is emitted when a button inside the button box is clicked. The specific button that was pressed is specified by button .
另請參閱 accepted (), rejected ()，和 helpRequested ().
[override virtual protected]
bool
QDialogButtonBox::
event
(
QEvent
*
event
)
重實現自 QWidget::event ().
[signal]
void
QDialogButtonBox::
helpRequested
()
此信號被發射當點擊按鈕框內按鈕時，隻要它的定義是采用 HelpRole .
另請參閱 accepted (), rejected ()，和 clicked ().
[signal]
void
QDialogButtonBox::
rejected
()
此信號被發射當點擊按鈕框內按鈕時，隻要它的定義是采用 RejectRole or NoRole .
另請參閱 accepted (), helpRequested ()，和 clicked ().
移除 button from the button box without deleting it and sets its parent to zero.
另請參閱 clear (), buttons ()，和 addButton ().
返迴的標準按鈕枚舉值對應給定 button ，或 NoButton 若給定 button 不是標準按鈕。
另請參閱 button (), buttons ()，和 standardButtons ().