[Qt 教程之Widgets模块] —— QDialogButtonBox按钮框

Qt系列教程总目录

0. 简介

QDialogButtongBox是一个包含很多按钮的控件，对话框中有多个需要分组排列的按钮时，可以使用QDialogButtongBox类。
开发人员可以向QDialogButtonBox添加按钮，QDialogButtonBox会根据平台自动使用合适的布局。

Qt Creator 添加新文件的对话框和Photoshop调整曲线的对话框都可以使用QDialogButtonBox来处理：

1. 创建QDialogButtongBox

QDialogButtongBox有4个构造函数，

QDialogButtonBox(QWidget *parent = nullptr);
QDialogButtonBox(Qt::Orientation orientation, QWidget *parent = nullptr);
explicit QDialogButtonBox(StandardButtons buttons, QWidget *parent = nullptr);
QDialogButtonBox(StandardButtons buttons, Qt::Orientation orientation, QWidget *parent = nullptr);
1
2
3
4

同样可以通过拖动控件创建，也可以使用代码直接创建，控件创建默认使用构造函数QDialogButtonBox(QWidget *parent = nullptr);，控件创建会默认添加cancel和ok两个标准按钮。

对于其他三个构造函数的参数，其中，Qt::Orientation是枚举，可以指定按钮纵向或横向排列（如上图两个例子）；StandardButtons也是枚举，用于指定标准按钮。

如下图创建了四个QDialogButtonBox，其中，第一行通过拖拽控件创建，其余通过代码直接创建，依次使用了上面四个构造函数：

2. 枚举

QDialogButtonBox有用到一些枚举变量，详见下方：

2.1. Qt::Orientation

按钮排列方式

enum Orientation {
    Horizontal = 0x1,
    Vertical = 0x2
};
1
2
3
4

说明：

2.2. QDialogButtonBox::ButtonRole

描述按钮角色，不同角色的按钮有不同的行为

enum ButtonRole {
    InvalidRole = -1,
    AcceptRole,
    RejectRole,
    DestructiveRole,
    ActionRole,
    HelpRole,
    YesRole,
    NoRole,
    ResetRole,
    ApplyRole,

    NRoles
};
1
2
3
4
5
6
7
8
9
10
11
12
13
14

说明：

2.3. QDialogButtonBox::StandardButton

标准按钮

enum StandardButton {
    NoButton           = 0x00000000,
    Ok                 = 0x00000400,
    Save               = 0x00000800,
    SaveAll            = 0x00001000,
    Open               = 0x00002000,
    Yes                = 0x00004000,
    YesToAll           = 0x00008000,
    No                 = 0x00010000,
    NoToAll            = 0x00020000,
    Abort              = 0x00040000,
    Retry              = 0x00080000,
    Ignore             = 0x00100000,
    Close              = 0x00200000,
    Cancel             = 0x00400000,
    Discard            = 0x00800000,
    Help               = 0x01000000,
    Apply              = 0x02000000,
    Reset              = 0x04000000,
    RestoreDefaults    = 0x08000000,

#ifndef Q_MOC_RUN
    FirstButton        = Ok,
    LastButton         = RestoreDefaults
#endif
};
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

说明：

3. 成员函数与信号

QDialogButtonBox 公有继承与QWidget，所以QWidget的公有成员函数QDialogButtonBox都能使用。

QDialogButtonBox的成员函数如下：

3.1. 按钮排列方式

3.2. 添加与删除按钮

3.3. 按钮与角色

3.4. 标准按钮

3.5. 按钮居中