实战PyQt5: 032-按钮盒控件QDialogButtonBox_pyqt buttonbox

QDialogButtonBox简介

通常情况下，对话框和消息框都有一组标准布局的按钮，QDialogButtonBox部件以当前部件的布局风格提供一系列标准按钮，并自动根据用户的桌面环境使用适当的布局，QDialogButtonBox允许开发人员向其添加按钮，这些按钮都遵循一定的角色(其角色定义见QDialogButtonBox.ButtonRole 取值表)。

QDialogButtonBox.StandardButton标准按钮：

• QDialogButtonBox.NoButton： 没按钮存在；
• QDialogButtonBox.Ok： Ok；
• QDialogButtonBox.Save： 保存；
• QDialogButtonBox.SaveAll： 保存所有；
• QDialogButtonBox.Open： 打开；
• QDialogButtonBox.Yes： 确定；
• QDialogButtonBox.YesToAll： 确定所有；
• QDialogButtonBox.No： 否定；
• QDialogButtonBox.NoToAll： 否定所有；
• QDialogButtonBox.Abort： 终止；
• QDialogButtonBox.Retry： 重试；
• QDialogButtonBox.Ignore： 忽略；
• QDialogButtonBox.Close： 关闭；
• QDialogButtonBox.Cancel： 取消；
• QDialogButtonBox.Discard： 放弃；
• QDialogButtonBox.Help： 帮助；
• QDialogButtonBox.Apply： 应用；
• QDialogButtonBox.Reset： 重置；
• QDialogButtonBox.RestoreDefaults： 重置到缺省状态。

QDialogButtonBox.ButtonRole 按钮角色：

• QDialogButtonBox.InValidRole： 无效按钮；
• QDialogButtonBox.AcceptRole： 点击该按钮，触发一个接受信息（如Ok按钮）；
• QDialogButtonBox.RejectRole： 点击该按钮，触发 一个拒绝信息(如Cancel按钮)；
• QDialogButtonBox.DestructiveRole： 点击该按钮触发一个破坏性的信息（如放弃修改）并关闭窗口；
• QDialogButtonBox.ActionRole： 点击按钮将更改对话框中的元素（例如重置参数）；
• QDialogButtonBox.HelpRole： 点击按钮，请求帮助；
• QDialogButtonBox.YesRole： 类似“Yes”的按钮；
• QDialogButtonBox.NoRole： 类似“No”的按钮；
• QDialogButtonBox.RestRole： 点击按钮，应用当前修改；
• QDialogButtonBox.ApplyRole： 将对话框中的各种控件的值设置为默认值

ButtonRole与StandardButton标准按钮对应关系：

• AcceptRole <==> Ignore, Ok, Open, Retry, Save, SaveAll, Apply
• DestructiveRole <==> Discard
• HelpRole <==> Help
• NoRole <==> No, NoToAll
• RejectRole <==> Cancel, Close, Abort
• ResetRole <==> Reset, RestoreDefaults
• YesRole <==> Yes, YesToAll

QDialogButtonBox常用方法：

• addButton()： 添加一个按钮；
• removeButton()： 删除一个按钮；
• setOrientation()： 设置按钮排列方式，水平或者垂直；
• orientation()： 获得按钮的排列方式；
• clear()： 清除所有按钮。

QDialogButtonBox常用信号：

• accepted： 发射一个接受信息；
• rejected： 发射一个拒绝信息；
• clicked： 发射按钮点击信息 。

QDialogButtonBox类继承关系：

 

测试QDialogButtonBox

创建文件qdialogbuttonbox.py，演示添加两组标准按钮，和添加一组自定义按钮。完整代码如下:

import sys
from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import (QApplication, QWidget, QDialogButtonBox, 
                             QMessageBox, QPushButton, QVBoxLayout)
 
class DemoDialogButtonBox(QWidget):
    def __init__(self, parent=None):
        super(DemoDialogButtonBox, self).__init__(parent)       
        
        # 设置窗口标题
        self.setWindowTitle('实战PyQt5: QDialogButtonBox Demo!')      
        # 设置窗口大小
        self.resize(400, 240)
        
        bbOkCancel = QDialogButtonBox(QDialogButtonBox.Ok|QDialogButtonBox.Cancel, self) 
        bbOkCancel.button(QDialogButtonBox.Ok).setDefault(True)
        bbOkCancel.accepted.connect(self.onAccepted)
        bbOkCancel.rejected.connect(self.onRejected)     
        
        bbARI = QDialogButtonBox(QDialogButtonBox.Abort|QDialogButtonBox.Retry|QDialogButtonBox.Ignore, self)
        bbARI.accepted.connect(self.onAccepted)
        bbARI.rejected.connect(self.onRejected)
        
        #添加按钮
        bbVert = QDialogButtonBox(Qt.Vertical, self) 
        btnAdd = QPushButton('加法', self)
        btnSub = QPushButton('减法', self)
        btnMul = QPushButton('乘法', self)
        btnDiv = QPushButton('除法', self)
        
        bbVert.addButton(btnAdd, QDialogButtonBox.AcceptRole)
        bbVert.addButton(btnSub, QDialogButtonBox.AcceptRole)
        bbVert.addButton(btnMul, QDialogButtonBox.AcceptRole)
        bbVert.addButton(btnDiv, QDialogButtonBox.AcceptRole)
        bbVert.accepted.connect(self.onAccepted)
        bbVert.rejected.connect(self.onRejected)
        
        vLayout = QVBoxLayout(self)
        vLayout.setSpacing(16)
        vLayout.addStretch()
        vLayout.addWidget(bbOkCancel)
        vLayout.addWidget(bbARI)
        vLayout.addWidget(bbVert)
        vLayout.addStretch()
       
        self.setLayout(vLayout)
        
    def onAccepted(self):
        QMessageBox.information(self, '信息',  'accepted!!!')
        
    def onRejected(self):
        QMessageBox.information(self, '信息', 'rejected!!!')
        
        
        
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = DemoDialogButtonBox()
    window.show()
    sys.exit(app.exec())

运行结果如下图：

测试QDialogButtonBox

本文知识点

• QDialogButtonBox标准按钮及按钮角色的指定；
• 向QDialogButtonBox添加自定义按钮。

前一篇： 实战PyQt5：031-命令连接按钮控件QCommandLinkButton