[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);

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

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

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

2. 枚举

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

2.1. Qt::Orientation

按钮排列方式

enum Orientation {Horizontal = 0x1,Vertical = 0x2
};

说明：

2.2. QDialogButtonBox::ButtonRole

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

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

说明：

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_RUNFirstButton        = Ok,LastButton         = RestoreDefaults
#endif
};

说明：

3. 成员函数与信号

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

QDialogButtonBox的成员函数如下：

3.1. 按钮排列方式

3.2. 添加与删除按钮

3.3. 按钮与角色

3.4. 标准按钮

3.5. 按钮居中