PyQt编程第5章对话框

2015-10-14 约 2425 字预计阅读 5 分钟次阅读

对话框以“智力”分类为：哑巴，标准和聪明，取决于对话框知道程序数据的多少。对话框以“模式”分类为：模式对话框和无模式对话框。

应用模式对话框一旦被调用，用户只能与其交互，不能使用程序其它部分。窗口模式对话框和应用模式对话框类似，只是它仅仅阻止与其父窗口交互。无模式对话框允许用户与程序其它部分交互。

编写对话框另一个重要方面是如何处理有效性检验。我们尽量挑选合适的部件并设置其属性来避免编写有效性检验代码。我们称应用到单个部件的检验为部件级确认。当部件之间有相互关系时，称为表级确认。

“哑巴”对话框

哑巴对话框不知道其部件使用的数据。哑巴对话框通常是带有accept和reject按钮的模式对话框。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


def setPenProperties(self):
    dialog = PenPropertiesDlg(self)
    dialog.widthSpinBox.setValue(self.width)
    dialog.beveledCheckBox.setChecked(self.beveled)
    dialog.styleComboBox.setCurrentIndex(
            dialog.styleComboBox.findText(self.style))
    if dialog.exec_():
        self.width = dialog.widthSpinBox.value()
        self.beveled = dialog.beveledCheckBox.isChecked()
        self.style = unicode(dialog.styleComboBox.currentText())
        self.updateData()

当我们调用一个对话框的exec_时，则以模式对话框显示。当用户点击accept，exec_返回True，否则返回False。

 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
27
28
29
30
31
32
33
34
35


class PenPropertiesDlg(QDialog):
    def __init__(self, parent=None):
        super(PenPropertiesDlg, self).__init__(parent)
        widthLabel = QLabel("&Width:")
        self.widthSpinBox = QSpinBox()
        widthLabel.setBuddy(self.widthSpinBox)
        self.widthSpinBox.setAlignment(Qt.AlignRight|Qt.AlignVCenter)
        self.widthSpinBox.setRange(0, 24)
        self.beveledCheckBox = QCheckBox("&Beveled edges")
        styleLabel = QLabel("&Style:")
        self.styleComboBox = QComboBox()
        styleLabel.setBuddy(self.styleComboBox)
        self.styleComboBox.addItems(["Solid", "Dashed", "Dotted",
                                     "DashDotted", "DashDotDotted"])
        okButton = QPushButton("&OK")
        cancelButton = QPushButton("Cancel")

        buttonLayout = QHBoxLayout()
        buttonLayout.addStretch()
        buttonLayout.addWidget(okButton)
        buttonLayout.addWidget(cancelButton)
        layout = QGridLayout()
        layout.addWidget(widthLabel, 0, 0)
        layout.addWidget(self.widthSpinBox, 0, 1)
        layout.addWidget(self.beveledCheckBox, 0, 2)
        layout.addWidget(styleLabel, 1, 0)
        layout.addWidget(self.styleComboBox, 1, 1, 1, 2)
        layout.addLayout(buttonLayout, 2, 0, 1, 3)
        self.setLayout(layout)

        self.connect(okButton, SIGNAL("clicked()"),
                     self, SLOT("accept()"))
        self.connect(cancelButton, SIGNAL("clicked()"),
                     self, SLOT("reject()"))
        self.setWindowTitle("Pen Properties")

在标签文字中的引号(&)有2个可能的含义，一个简单地为字符引号。另一个指示引号后面的字母为键盘加速键，可以使用Alt+字母快速定位。字符引号和加速键的区别是标签有没有一个“伙伴”。

对话框按钮布局

1
2
3
4
5
6
7
8


buttonBox = QDialogButtonBox(QDialogButtonBox.Ok
                             | QDialogButtonBox.Cancel)
buttonBox.button(QDialogButtonBox.Ok).setDefault(True)
layout.addWidget(buttonBox, 3, 0, 1, 3)
self.connect(buttonBox, SIGNAL("accepted()"),
             self, SLOT("accept()"))
self.connect(buttonBox, SIGNAL("rejected()"),
             self, SLOT("reject()"))

QDialogButtonBox自动处理不同平台的默认外观。 QDialogButtonBox默认是水平布局，可以传递Qt.Vertical给它构造器设置垂直布局，或者调用 setOrientation函数。

QGridLayout.addWidget方法的参数是部件，所在行，所在列，和可选的行扩展数，列扩展数。

语法	描述
b.addLayout(l)	添加QLayout l到QBoxLayout b中, b通常是QHBoxLayout或QVBoxLayout
b.addSpacing(i)	添加一个指定数量为i的QSpacerItem到QBoxLayout b中
b.addStretch(i)	添加一个最小为0且伸展系数为i的QSpacerItem到QBoxLayout b中
b.addWidget(w)	添加QWidget w到QBoxLayout b中
b.setStretchFactor(x, i)	设置QBoxLayout b的伸展系数或QWidget x为i
g.addLayout(l, r, c)	在行r列c添加QLayout l到QGridLayout g; 可以提供附加的行扩展和列扩展参数
g.addWidget(w, r, c)	在行r列c添加QWidget w到QGridLayout g; 可以提供附加的行扩展和列扩展参数
g.setRowStretch(r, i)	设置QGridLayout g行r的伸展为i
g.setColumnStretch(c, i)	设置QGridLayout g列c的伸展为i

标准对话框

我们认为一个对话框是标准对话框，如果它访问部件都是通过类方法，而不是部件本身。

模式OK/Cancel风格对话框

1
2
3
4
5


def setNumberFormat1(self):
    dialog = numberformatdlg1.NumberFormatDlg(self.format, self)
    if dialog.exec_():
        self.format = dialog.numberFormat()
        self.refreshTable()

语法	描述
d.addButton(b, r)	添加具有QDialogButtonBox.ButtonRole r的QPushButton b到QDialogButtonBox d中
d.addButton(t, r)	添加具有QDialogButtonBox.ButtonRole r且名字为t的QPushButton到QDialogButtonBox d中，返回所添加的按钮
d.addButton(s)	添加由QDialogButtonBox.StandardButton s指定的按钮QDialogButtonBox d中，返回所添加的按钮
d.setOrientation(o)	设置QDialogButtonBox d的方向为Qt.Orientation o(垂直或水平)
d.button(s)	返回QDialogButtonBox d中由StandardButton s指定的按钮，或None
d.accepted()	当角色为QDialogButtonBox.Accept的按钮被点击，发射该信号
d.rejected()	当角色为QDialogButtonBox.Reject的按钮被点击，发射该信号

1
2
3
4
5


def accept(self):
    class ThousandsError(Exception): pass
    class DecimalError(Exception): pass
    QMessageBox.warning(self, "Decimal Marker Error", unicode(e))
    QDialog.accept(self)

为什么这里不使用super来调用基类的accept而是显式使用QDialog？因为在这个环境下使用super 不起作用。PyQt为了尽可能效率高，使用懒惰属性查找，结果就是此处的super在PyQt的子类中不会像预期那样工作。(见pyqt4ref.html文档，“super and PyQt classes”)

智能对话框

智能对话框通常是无模式的，带有apply和close按钮。

语法	描述
d.accept()	关闭(隐藏)QDialog d，停止事件循环，并导致exec_()返回True。如果设置了Qt.WA_DeleteOnClose，则对话框被删除
d.reject()	关闭(隐藏)QDialog d，停止事件循环，并导致exec_()返回False。
d.done(i)	关闭(隐藏)QDialog d，停止事件循环，并导致exec_()返回i。
d.exec_()	模式显示QDialog d，阻塞直到对话框关闭
d.show()	无模式显示QDialog d；继承自QWidget
d.setSizeGripEnabled(b)	显示或隐藏QDialog d的size grip，基于bool b

无模式Apply/Close风格对话框

1
2
3
4


def setNumberFormat2(self):
    dialog = numberformatdlg2.NumberFormatDlg(self.format, self)
    self.connect(dialog, SIGNAL("changed"), self.refreshTable)
    dialog.show()

尽管dialog超出范围，PyQt足够聪明地保存了一个无模式对话框的引用，因此dialog继续存在。可以设置 dialog的属性为Qt.WA_DeleteOnClose，则每次都删除对话框而不是隐藏。

 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
27
28
29
30
31


def __init__(self, format, parent=None):
    super(NumberFormatDlg, self).__init__(parent)
    self.setAttribute(Qt.WA_DeleteOnClose)
    punctuationRe = QRegExp(r"[ ,;:.]")
    thousandsLabel = QLabel("&Thousands separator")
    self.thousandsEdit = QLineEdit(format["thousandsseparator"])
    thousandsLabel.setBuddy(self.thousandsEdit)
    self.thousandsEdit.setMaxLength(1)
    self.thousandsEdit.setValidator(
            QRegExpValidator(punctuationRe, self))
    decimalMarkerLabel = QLabel("Decimal &marker")
    self.decimalMarkerEdit = QLineEdit(format["decimalmarker"])
    decimalMarkerLabel.setBuddy(self.decimalMarkerEdit)
    self.decimalMarkerEdit.setMaxLength(1)
    self.decimalMarkerEdit.setValidator(
            QRegExpValidator(punctuationRe, self))
    self.decimalMarkerEdit.setInputMask("X")
    decimalPlacesLabel = QLabel("&Decimal places")
    self.decimalPlacesSpinBox = QSpinBox()
    decimalPlacesLabel.setBuddy(self.decimalPlacesSpinBox)
    self.decimalPlacesSpinBox.setRange(0, 6)
    self.decimalPlacesSpinBox.setValue(format["decimalplaces"])
    self.redNegativesCheckBox = QCheckBox("&Red negative numbers")
    self.redNegativesCheckBox.setChecked(format["rednegatives"])
    buttonBox = QDialogButtonBox(QDialogButtonBox.Apply|
                                 QDialogButtonBox.Close)
    self.connect(buttonBox.button(QDialogButtonBox.Apply),
                 SIGNAL("clicked()"), self.apply)
    self.connect(buttonBox, SIGNAL("rejected()"),
                 self, SLOT("reject()"))
    self.setWindowTitle("Set Number Format (Modeless)")

QRegExpValidator初始化式需要一个正则表达式和一个parent。一个掩饰“X”说明需要任意一个字符，格式掩饰在QLineEdit.inputMask文档中说明。

无模式“Live”对话框

1
2
3
4
5
6
7


def setNumberFormat3(self):
    if self.numberFormatDlg is None:
        self.numberFormatDlg = numberformatdlg3.NumberFormatDlg(
                self.format, self.refreshTable, self)
    self.numberFormatDlg.show()
    self.numberFormatDlg.raise_()
    self.numberFormatDlg.activateWindow()

raise_将对话框置于其它窗口之上 activateWindow聚焦于对话框

1
2
3
4
5
6
7
8


self.connect(self.thousandsEdit,
             SIGNAL("textEdited(QString)"), self.checkAndFix)
self.connect(self.decimalMarkerEdit,
             SIGNAL("textEdited(QString)"), self.checkAndFix)
self.connect(self.decimalPlacesSpinBox,
             SIGNAL("valueChanged(int)"), self.apply)
self.connect(self.redNegativesCheckBox,
             SIGNAL("toggled(bool)"), self.apply)

目录

PyQt编程第5章 对话框