PyQt5 中的对话框

最后修改于 2023 年 10 月 18 日

对话框定义为两个人或更多人之间的对话。在计算机应用程序中，对话框是一个用于与应用程序“对话”的窗口。对话框用于获取用户数据或更改应用程序设置等。

PyQt5 QInputDialog

QInputDialog 提供一个简单的便捷对话框，用于从用户那里获取单个值。输入值可以是字符串、数字或列表中的项目。

input_dialog.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we receive data from
a QInputDialog dialog.

Aauthor: Jan Bodnar
Website: zetcode.com
"""

from PyQt5.QtWidgets import (QWidget, QPushButton, QLineEdit,
                             QInputDialog, QApplication)
import sys


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        self.btn = QPushButton('Dialog', self)
        self.btn.move(20, 20)
        self.btn.clicked.connect(self.showDialog)

        self.le = QLineEdit(self)
        self.le.move(130, 22)

        self.setGeometry(300, 300, 450, 350)
        self.setWindowTitle('Input dialog')
        self.show()

    def showDialog(self):
        text, ok = QInputDialog.getText(self, 'Input Dialog',
                                        'Enter your name:')

        if ok:
            self.le.setText(str(text))


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

该示例有一个按钮和一个行编辑控件。该按钮显示用于获取文本值的输入对话框。输入的文本将显示在行编辑控件中。

text, ok = QInputDialog.getText(self, 'Input Dialog',
    'Enter your name:')

此行显示输入对话框。第一个字符串是对话框标题，第二个字符串是对话框中的消息。对话框返回输入的文本和一个布尔值。如果我们点击确定按钮，布尔值为真。

if ok:
    self.le.setText(str(text))

我们从对话框中收到的文本通过 setText 设置到 line edit 小部件。

PyQt5 QColorDialog

QColorDialog 提供一个用于选择颜色值的对话框小部件。

color_dialog.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we select a color value
from the QColorDialog and change the background
color of a QFrame widget.

Author: Jan Bodnar
Website: zetcode.com
"""

from PyQt5.QtWidgets import (QWidget, QPushButton, QFrame,
                             QColorDialog, QApplication)
from PyQt5.QtGui import QColor
import sys


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        col = QColor(0, 0, 0)

        self.btn = QPushButton('Dialog', self)
        self.btn.move(20, 20)

        self.btn.clicked.connect(self.showDialog)

        self.frm = QFrame(self)
        self.frm.setStyleSheet("QWidget { background-color: %s }"
                               % col.name())
        self.frm.setGeometry(130, 22, 200, 200)

        self.setGeometry(300, 300, 450, 350)
        self.setWindowTitle('Color dialog')
        self.show()

    def showDialog(self):
        col = QColorDialog.getColor()

        if col.isValid():
            self.frm.setStyleSheet('QWidget { background-color: %s }'
                                   % col.name())


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

应用程序示例显示了一个按钮和一个 QFrame。小部件的背景设置为黑色。使用 QColorDialog，我们可以更改其背景。

col = QColor(0, 0, 0)

这是 QFrame 背景的初始颜色。

col = QColorDialog.getColor()

这行代码弹出 QColorDialog。

if col.isValid():
    self.frm.setStyleSheet("QWidget { background-color: %s }"
        % col.name())

我们检查颜色是否有效。如果我们单击“取消”按钮，则不会返回有效的颜色。如果颜色有效，我们使用样式表更改背景颜色。

PyQt5 QFontDialog

QFontDialog 是一个用于选择字体的对话框小部件。

font_dialog.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we select a font name
and change the font of a label.

Author: Jan Bodnar
Website: zetcode.com
"""

from PyQt5.QtWidgets import (QWidget, QVBoxLayout, QPushButton,
                             QSizePolicy, QLabel, QFontDialog, QApplication)
import sys


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        vbox = QVBoxLayout()

        btn = QPushButton('Dialog', self)
        btn.setSizePolicy(QSizePolicy.Fixed, QSizePolicy.Fixed)
        btn.move(20, 20)

        vbox.addWidget(btn)

        btn.clicked.connect(self.showDialog)

        self.lbl = QLabel('Knowledge only matters', self)
        self.lbl.move(130, 20)

        vbox.addWidget(self.lbl)
        self.setLayout(vbox)

        self.setGeometry(300, 300, 450, 350)
        self.setWindowTitle('Font dialog')
        self.show()

    def showDialog(self):

        font, ok = QFontDialog.getFont()
        if ok:
            self.lbl.setFont(font)


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在我们的例子中，我们有一个按钮和一个标签。使用 QFontDialog，我们更改标签的字体。

font, ok = QFontDialog.getFont()

在这里我们弹出字体对话框。 getFont 方法返回字体名称和 ok 参数。如果用户单击“确定”，则该值等于 True；否则为 False。

if ok:
    self.label.setFont(font)

如果我们单击“确定”，则标签的字体将使用 setFont 更改。

PyQt5 QFileDialog

QFileDialog 是一个允许用户选择文件或目录的对话框。可以选择文件进行打开和保存。

file_dialog.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we select a file with a
QFileDialog and display its contents
in a QTextEdit.

Author: Jan Bodnar
Website: zetcode.com
"""

from PyQt5.QtWidgets import (QMainWindow, QTextEdit,
                             QAction, QFileDialog, QApplication)
from PyQt5.QtGui import QIcon
import sys
from pathlib import Path


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        self.textEdit = QTextEdit()
        self.setCentralWidget(self.textEdit)
        self.statusBar()

        openFile = QAction(QIcon('open.png'), 'Open', self)
        openFile.setShortcut('Ctrl+O')
        openFile.setStatusTip('Open new File')
        openFile.triggered.connect(self.showDialog)

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(openFile)

        self.setGeometry(300, 300, 550, 450)
        self.setWindowTitle('File dialog')
        self.show()

    def showDialog(self):

        home_dir = str(Path.home())
        fname = QFileDialog.getOpenFileName(self, 'Open file', home_dir)

        if fname[0]:
            f = open(fname[0], 'r')

            with f:
                data = f.read()
                self.textEdit.setText(data)


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

该示例显示了一个菜单栏、一个居中设置的文本编辑小部件和一个状态栏。菜单项显示 QFileDialog，用于选择文件。文件的内容被加载到文本编辑小部件中。

class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()

该示例基于 QMainWindow 小部件，因为我们居中设置了一个文本编辑小部件。

home_dir = str(Path.home())
fname = QFileDialog.getOpenFileName(self, 'Open file', home_dir)

我们弹出 QFileDialog。 getOpenFileName 方法中的第一个字符串是标题。第二个字符串指定对话框的工作目录。我们使用 path 模块来确定用户的主目录。默认情况下，文件过滤器设置为所有文件 (*)。

if fname[0]:
    f = open(fname[0], 'r')

    with f:
        data = f.read()
        self.textEdit.setText(data)

读取选定的文件名，并将文件的内容设置到文本编辑小部件。

在本 PyQt5 教程的这一部分中，我们使用了对话框。

电子书

PyQt5 中的对话框

PyQt5 QInputDialog

PyQt5 QColorDialog

PyQt5 QFontDialog

PyQt5 QFileDialog