PyQt5 快速指南

---

---

PyQt5 - 简介

PyQt 是一个 GUI 控件工具包。它是Qt 的 Python 接口，Qt 是一个最强大和流行的跨平台 GUI 库之一。PyQt 由 RiverBank Computing Ltd. 开发。最新版本的 PyQt 可从其官方网站下载 - riverbankcomputing.com

PyQt API 是一组包含大量类和函数的模块。QtCore 模块包含用于处理文件和目录等的非 GUI 功能，而QtGui 模块包含所有图形控件。此外，还有用于处理 XML (QtXml)、SVG (QtSvg) 和 SQL (QtSql) 等的模块。

以下是常用模块的列表：

• QtCore - 其他模块使用的核心非 GUI 类

• QtGui - 图形用户界面组件

• QtMultimedia - 用于低级别多媒体编程的类

• QtNetwork - 用于网络编程的类

• QtOpenGL - OpenGL 支持类

• QtScript - 用于评估 Qt 脚本的类

• QtSql - 使用 SQL 进行数据库集成的类

• QtSvg - 用于显示 SVG 文件内容的类

• QtWebKit - 用于渲染和编辑 HTML 的类

• QtXml - 用于处理 XML 的类

• QtWidgets - 用于创建经典桌面式 UI 的类

• QtDesigner - 用于扩展 Qt Designer 的类

支持环境

PyQt 兼容所有流行的操作系统，包括 Windows、Linux 和 Mac OS。它具有双重许可，可在 GPL 和商业许可下使用。最新稳定版本为PyQt5-5.13.2。

Windows

提供与 Python 3.5 或更高版本兼容的 32 位或 64 位架构的轮子。推荐的安装方法是使用PIP实用程序：

pip3 install PyQt5

要安装诸如 Qt Designer 之类的开发工具以支持 PyQt5 轮子，以下是命令：

pip3 install pyqt5-tools

您也可以从源代码在 Linux/macOS 上构建 PyQt5 www.riverbankcomputing.com/static/Downloads/PyQt5

PyQt5 - 最新动态

PyQt5 API 不自动兼容早期版本。因此，涉及 PyQt4 模块的 Python 代码应通过进行相关更改手动升级。本章列出了 PyQt4 和 PyQt5 之间的主要区别。

PyQt5 不支持早于 v2.6 的 Python 版本。

PyQt5 不支持 QObject 类的 connect() 方法来连接信号和槽。因此，用法不再能实现：

QObject.connect(widget, QtCore.SIGNAL(‘signalname’), slot_function)

仅定义以下语法：

widget.signal.connect(slot_function)

早期 QtGui 模块中定义的类已分布在QtGui、QtPrintSupport和QtWidgets模块中。

在新 QFileDialog 类中，getOpenFileNameAndFilter() 方法被getOpenFileName()替换，getOpenFileNamesAndFilter()被getOpenFileNames()替换，getSaveFileNameAndFilter()被getSaveFileName()替换。这些方法的旧签名也已更改。

PyQt5 没有规定定义从多个 Qt 类子类化的类。

pyuic5 实用程序（用于从 Designer 的 XML 文件生成 Python 代码）不支持 --pyqt3-wrapper 标志。

pyrcc5 不支持 -py2 和 -py3 标志。pyrcc5 的输出与所有 Python v2.6 及更高版本兼容。

PyQt5 始终自动调用sip.setdestroyonexit()并调用其拥有的所有包装实例的 C++ 析构函数。

PyQt5 - Hello World

使用 PyQt 创建简单的 GUI 应用程序涉及以下步骤：

• 从 PyQt5 包导入 QtCore、QtGui 和 QtWidgets 模块。

• 创建 QApplication 类的应用程序对象。

• QWidget 对象创建一个顶级窗口。在其中添加 QLabel 对象。

• 将标签的标题设置为“hello world”。

• 使用 setGeometry() 方法定义窗口的大小和位置。

• 通过app.exec_()方法进入应用程序的主循环。

以下是使用 PyQt 执行 Hello World 程序的代码：

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
def window():
   app = QApplication(sys.argv)
   w = QWidget()
   b = QLabel(w)
   b.setText("Hello World!")
   w.setGeometry(100,100,200,50)
   b.move(50,20)
   w.setWindowTitle("PyQt5")
   w.show()
   sys.exit(app.exec_())
if __name__ == '__main__':
   window()

上述代码产生以下输出：

也可以开发上述代码的面向对象解决方案。

• 从 PyQt5 包导入 QtCore、QtGui 和 QtWidgets 模块。

• 创建 QApplication 类的应用程序对象。

• 基于 QWidget 类声明窗口类

• 添加 QLabel 对象并将标签的标题设置为“hello world”。

• 使用 setGeometry() 方法定义窗口的大小和位置。

• 通过app.exec_()方法进入应用程序的主循环。

以下是面向对象解决方案的完整代码：

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class window(QWidget):
   def __init__(self, parent = None):
      super(window, self).__init__(parent)
      self.resize(200,50)
      self.setWindowTitle("PyQt5")
      self.label = QLabel(self)
      self.label.setText("Hello World")
      font = QFont()
      font.setFamily("Arial")
      font.setPointSize(16)
      self.label.setFont(font)
      self.label.move(50,20)
def main():
   app = QApplication(sys.argv)
   ex = window()
   ex.show()
   sys.exit(app.exec_())
if __name__ == '__main__':
   main()

PyQt5 - 主要类

PyQt API 是一个大型的类和方法集合。这些类在 20 多个模块中定义。

以下是一些常用模块：

PyQt5 开发工具是用于 Qt 开发的实用程序集合。以下是一些此类实用程序的选择列表：

PyQt API 包含 400 多个类。QObject 类位于类层次结构的顶部。它是所有 Qt 对象的基类。此外，QPaintDevice 类是所有可以绘制的对象的基类。

QApplication 类管理 GUI 应用程序的主要设置和控制流程。它包含主事件循环，在该循环中处理和分派由窗口元素和其他来源生成的事件。它还处理系统范围和应用程序范围的设置。

QWidget 类派生自 QObject 和 QPaintDevice 类，是所有用户界面对象的基类。QDialog 和QFrame 类也派生自 QWidget 类。它们有自己的子类系统。

以下是一些常用控件的选择列表

典型的基于 GUI 的应用程序的顶级窗口是由QMainWindow控件对象创建的。上面列出的一些控件占据其指定位置在这个主窗口中，而其他控件则使用各种布局管理器放置在中央控件区域中。

下图显示了 QMainWindow 框架：

PyQt5 - 使用 Qt Designer

PyQt 安装程序附带一个名为Qt Designer的 GUI 构建器工具。使用其简单的拖放界面，可以快速构建 GUI 界面而无需编写代码。然而，它不是像 Visual Studio 这样的 IDE。因此，Qt Designer 没有调试和构建应用程序的功能。

启动 Qt Designer 应用程序，它是开发工具的一部分，安装在虚拟环境的 scripts 文件夹中。

通过选择“文件”→“新建”菜单开始设计 GUI 界面。

然后，您可以将所需的控件从左侧窗格的控件框中拖放到表单上。您还可以为放在表单上的控件的属性赋值。

设计的表单保存为 demo.ui。此 ui 文件包含设计中控件及其属性的 XML 表示。此设计通过使用 pyuic5 命令行实用程序转换为 Python 等效项。此实用程序是 Qt 工具包 uic 模块的包装器。pyuic5 的用法如下：

pyuic5 -x demo.ui -o demo.py

在上述命令中，-x 开关向生成的 Python 脚本（来自 XML）添加少量附加代码，以便它成为一个自执行的独立应用程序。

if __name__ == "__main__":
   import sys
   app = QtGui.QApplication(sys.argv)
   Dialog = QtGui.QDialog()
   ui = Ui_Dialog()
   ui.setupUi(Dialog)
   Dialog.show()
   sys.exit(app.exec_())

执行生成的 Python 脚本将显示以下对话框：

python demo.py

用户可以在输入字段中输入数据，但是点击“添加”按钮不会产生任何操作，因为它没有与任何函数关联。对用户生成的响应做出反应被称为**事件处理**。

PyQt5 - 信号与槽

与以顺序方式执行的控制台模式应用程序不同，基于 GUI 的应用程序是事件驱动的。函数或方法是响应用户操作（例如单击按钮、从集合中选择项目或鼠标单击等，称为**事件**）而执行的。

用于构建 GUI 界面的小部件充当此类事件的来源。每个从 QObject 类派生的 PyQt 小部件都设计为响应一个或多个事件发出**“信号”**。信号本身不执行任何操作。相反，它“连接”到一个**“槽”**。槽可以是任何**可调用的 Python 函数**。

使用 Qt Designer 的信号/槽编辑器

首先设计一个带有 LineEdit 控件和 PushButton 的简单窗体。

如果按下按钮，希望文本框的内容被清除。QLineEdit 小部件为此目的提供了一个 clear() 方法。因此，按钮的**clicked**信号需要连接到文本框的**clear()**方法。

首先，从“编辑”菜单中选择“编辑信号/槽”（或按 F4）。然后用鼠标突出显示按钮并将光标拖动到文本框。

释放鼠标后，将显示一个对话框，显示按钮的信号和小部件的方法。选择 clicked 信号和 clear() 方法。

右下角的信号/槽编辑器窗口将显示结果。

保存 ui 文件，并根据以下代码所示从 ui 文件构建和生成 Python 代码。

pyuic5 -x signalslot.ui -o signalslot.py

生成的 Python 代码将通过以下语句显示信号和槽之间的连接。

self.pushButton.clicked.connect(self.lineEdit.clear)

运行 signalslot.py，并在 LineEdit 中输入一些文本。如果按下按钮，文本将被清除。

构建信号-槽连接

无需使用 Designer，您可以通过以下语法直接建立信号-槽连接。

widget.signal.connect(slot_function)

假设单击按钮时要调用一个函数。这里，clicked 信号需要连接到一个可调用函数。可以使用以下任何一种技术来实现。

button.clicked.connect(slot_function)

示例

在下面的示例中，两个 QPushButton 对象（b1 和 b2）被添加到 QDialog 窗口中。我们希望在分别单击 b1 和 b2 时调用函数 b1_clicked() 和 b2_clicked()。

当单击 b1 时，clicked() 信号连接到 b1_clicked() 函数。

b1.clicked.connect(b1_clicked())

当单击 b2 时，clicked() 信号连接到 b2_clicked() 函数。

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

def window():
   app = QApplication(sys.argv)
   win = QDialog()
   b1 = QPushButton(win)
   b1.setText("Button1")
   b1.move(50,20)
   b1.clicked.connect(b1_clicked)
   
   b2 = QPushButton(win)
   b2.setText("Button2")
   b2.move(50,50)
   b2.clicked.connect(b2_clicked)
   
   win.setGeometry(100,100,200,100)

   win.setWindowTitle("PyQt5")
   win.show()
   sys.exit(app.exec_())

def b1_clicked():
   print ("Button 1 clicked")

def b2_clicked():
   print ("Button 2 clicked")

if __name__ == '__main__':
   window()

上述代码产生以下输出：

输出

Button 1 clicked
Button 2 clicked

PyQt5 - 布局管理

可以通过指定以像素为单位测量的绝对坐标，将 GUI 小部件放置在容器窗口内。坐标相对于 setGeometry() 方法定义的窗口尺寸。

setGeometry() 语法

QWidget.setGeometry(xpos, ypos, width, height)

在下面的代码片段中，尺寸为 300x200 像素的顶级窗口显示在显示器上的 (10, 10) 位置。

import sys
from PyQt4 import QtGui

def window():
   app = QtGui.QApplication(sys.argv)
   w = QtGui.QWidget()
	
   b = QtGui.QPushButton(w)
   b.setText("Hello World!")
   b.move(50,20)
	
   w.setGeometry(10,10,300,200)
   w.setWindowTitle(“PyQt”)
   w.show()
   sys.exit(app.exec_())
	
if __name__ == '__main__':
   window()

一个**PushButton**小部件添加到窗口中，并放置在窗口左上角位置向右 50 像素，向下 20 像素的位置。

然而，这种绝对定位并不合适，原因如下：

• 即使调整窗口大小，小部件的位置也不会改变。

• 在具有不同分辨率的不同显示设备上，外观可能不一致。

• 布局的修改很困难，因为它可能需要重新设计整个窗体。

PyQt API 提供布局类，用于更优雅地管理容器内小部件的位置。布局管理器相对于绝对定位的优点是：

• 窗口内的小部件会自动调整大小。

• 确保在具有不同分辨率的显示设备上外观一致。

• 可以动态添加或删除小部件，而无需重新设计。

Qt 工具包定义了各种可以与 Qt Designer 实用程序一起使用的布局。

以下是我们将在这章中逐一讨论的类的列表。

PyQt5 - 基本控件

以下是我们将在这章中逐一讨论的小部件列表。

PyQt5 - QDialog 类

**QDialog** 小部件呈现一个顶级窗口，主要用于收集用户的响应。它可以配置为**模态**（它会阻止其父窗口）或**非模态**（可以绕过对话框窗口）。

PyQt API 有许多预配置的对话框小部件，例如 InputDialog、FileDialog、FontDialog 等。

示例

在下面的示例中，对话框窗口的**WindowModality**属性决定它是模态还是非模态。可以将对话框上的任何一个按钮设置为默认按钮。当用户按下 Escape 键时，对话框将被**QDialog.reject()**方法丢弃。

顶级 QWidget 窗口上的 PushButton 单击后会产生一个对话框窗口。对话框框的标题栏上没有最小化和最大化控件。

用户无法将此对话框框置于后台，因为它的 WindowModality 设置为**ApplicationModal**。

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

def window():
   app = QApplication(sys.argv)
   w = QWidget()
   btn = QPushButton(w)
   btn.setText("Hello World!")
   btn.move(100,50)
   btn.clicked.connect(showdialog)
   w.setWindowTitle("PyQt Dialog demo")
   w.show()
   sys.exit(app.exec_())

def showdialog():
   dlg = QDialog()
   b1 = QPushButton("ok",dlg)
   b1.move(50,50)
   dlg.setWindowTitle("Dialog") 9. PyQt5 — QDialog Class
   dlg.setWindowModality(Qt.ApplicationModal)
   dlg.exec_()

if __name__ == '__main__':
   window()

上面的代码产生以下输出。单击主窗口中的按钮，对话框弹出。

PyQt5 - QMessageBox

**QMessageBox** 是一个常用的模态对话框，用于显示一些信息消息，并可以选择要求用户通过单击其上的任何一个标准按钮来响应。每个标准按钮都有一个预定义的标题、一个角色并返回一个预定义的十六进制数字。

与 QMessageBox 类关联的重要方法和枚举在以下表格中给出：

示例

在下面的示例中，顶级窗口上按钮的 clicked 信号，连接的函数显示 messagebox 对话框。

msg = QMessageBox()
msg.setIcon(QMessageBox.Information)
msg.setText("This is a message box")
msg.setInformativeText("This is additional information")
msg.setWindowTitle("MessageBox demo")
msg.setDetailedText("The details are as follows:")

setStandardButton() 函数显示所需的按钮。

msg.setStandardButtons(QMessageBox.Ok | QMessageBox.Cancel)

buttonClicked() 信号连接到一个槽函数，该函数识别信号源的标题。

msg.buttonClicked.connect(msgbtn)

示例的完整代码如下：

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

def window():
   app = QApplication(sys.argv)
   w = QWidget()
   b = QPushButton(w)
   b.setText("Show message!")
   
   b.move(100,50)
   b.clicked.connect(showdialog)
   w.setWindowTitle("PyQt MessageBox demo")
   w.show()
   sys.exit(app.exec_())

def showdialog():
   msg = QMessageBox()
   msg.setIcon(QMessageBox.Information)
   
   msg.setText("This is a message box")
   msg.setInformativeText("This is additional information")
   msg.setWindowTitle("MessageBox demo")
   msg.setDetailedText("The details are as follows:")
   msg.setStandardButtons(QMessageBox.Ok | QMessageBox.Cancel)
   msg.buttonClicked.connect(msgbtn)

   retval = msg.exec_()

def msgbtn(i):
   print ("Button pressed is:",i.text())

if __name__ == '__main__':
   window()

以上代码产生以下输出。单击主窗口的按钮时，将弹出消息框：

如果单击消息框上的“确定”或“取消”按钮，则会在控制台中产生以下输出：

Button pressed is: OK
Button pressed is: Cancel

PyQt5 - 多文档界面

典型的GUI应用程序可能有多个窗口。选项卡式和小部件允许一次激活一个窗口。但是，很多时候这种方法可能不太有用，因为其他窗口的视图被隐藏了。

同时显示多个窗口的一种方法是将它们创建为独立窗口。这称为SDI **（单文档界面）**。这需要更多的内存资源，因为每个窗口可能都有自己的菜单系统、工具栏等。

MDI **（多文档界面）**应用程序消耗的内存资源较少。子窗口在主容器内相互关联地排列。容器小部件称为 **QMdiArea**。

QMdiArea 小部件通常占据 QMainWindow 对象的中心小部件。此区域中的子窗口是 **QMdiSubWindow** 类的实例。可以将任何 QWidget 设置为 subWindow 对象的内部小部件。MDI 区域中的子窗口可以以级联或平铺方式排列。

下表列出了 QMdiArea 类和 QMdiSubWindow 类的重要方法：

QMdiArea 对象发出 subWindowActivated() 信号，而 windowStateChanged() 信号由 QMdisubWindow 对象发出。

示例

在以下示例中，包含 QMainWindow 的顶级窗口具有菜单和 MdiArea。

self.mdi = QMdiArea()
self.setCentralWidget(self.mdi)
bar = self.menuBar()
file = bar.addMenu("File")

file.addAction("New")
file.addAction("cascade")
file.addAction("Tiled")

菜单的 Triggered() 信号连接到 windowaction() 函数。

file.triggered[QAction].connect(self.windowaction)

菜单的新操作在 MDI 区域中添加一个子窗口，其标题带有增量编号。

MainWindow.count = MainWindow.count+1
sub = QMdiSubWindow()
sub.setWidget(QTextEdit())
sub.setWindowTitle("subwindow"+str(MainWindow.count))
self.mdi.addSubWindow(sub)
sub.show()

菜单的级联和平铺按钮分别以级联和平铺方式排列当前显示的子窗口。

完整代码如下：

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class MainWindow(QMainWindow):
   count = 0

   def __init__(self, parent = None):
      super(MainWindow, self).__init__(parent)
      self.mdi = QMdiArea()
      self.setCentralWidget(self.mdi)
      bar = self.menuBar()

      file = bar.addMenu("File")
      file.addAction("New")
      file.addAction("cascade")
      file.addAction("Tiled")
      file.triggered[QAction].connect(self.windowaction)
      self.setWindowTitle("MDI demo")

   def windowaction(self, q):
      print ("triggered")
   
      if q.text() == "New":
         MainWindow.count = MainWindow.count+1
         sub = QMdiSubWindow()
         sub.setWidget(QTextEdit())
         sub.setWindowTitle("subwindow"+str(MainWindow.count))
         self.mdi.addSubWindow(sub)
         sub.show()

      if q.text() == "cascade":
         self.mdi.cascadeSubWindows()

      if q.text() == "Tiled":
         self.mdi.tileSubWindows()

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

if __name__ == '__main__':
   main()

运行以上代码，以级联和平铺形式显示三个窗口：

PyQt5 - 拖放

**拖放** 功能对于用户来说非常直观。它存在于许多桌面应用程序中，用户可以在其中将对象从一个窗口复制或移动到另一个窗口。

基于 MIME 的拖放数据传输基于 **QDrag** 类。**QMimeData** 对象将其数据与其对应的 MIME 类型关联。它存储在剪贴板中，然后用于拖放过程中。

以下 QMimeData 类函数允许方便地检测和使用 MIME 类型。

许多 QWidget 对象支持拖放操作。允许拖动其数据的对象已设置 setDragEnabled()，必须将其设置为 true。另一方面，小部件应该响应拖放事件以便存储拖入它们的数据。

• **DragEnterEvent** 提供一个事件，该事件在拖动操作进入目标小部件时发送到目标小部件。

• **DragMoveEvent** 用于拖放操作正在进行时。

• **DragLeaveEvent** 在拖放操作离开小部件时生成。

• 另一方面，**DropEvent** 在放下操作完成后发生。可以根据条件接受或拒绝事件的建议操作。

示例

在以下代码中，**DragEnterEvent** 验证事件的 MIME 数据是否包含文本。如果是，则接受事件的建议操作，并将文本作为新项目添加到 ComboBox 中。

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class combo(QComboBox):
   def __init__(self, title, parent):
      super(combo, self).__init__( parent)
      self.setAcceptDrops(True)

   def dragEnterEvent(self, e):
      print (e)

      if e.mimeData().hasText():
         e.accept()
      else:
         e.ignore()

   def dropEvent(self, e):
      self.addItem(e.mimeData().text())

class Example(QWidget):
   def __init__(self):
      super(Example, self).__init__()

      self.initUI()

   def initUI(self):
      lo = QFormLayout()
      lo.addRow(QLabel("Type some text in textbox and drag it into combo box"))
   
      edit = QLineEdit()
      edit.setDragEnabled(True)
      com = combo("Button", self)
      lo.addRow(edit,com)
      self.setLayout(lo)
      self.setWindowTitle('Simple drag and drop')
def main():
   app = QApplication(sys.argv)
   ex = Example()
   ex.show()
   app.exec_()

if __name__ == '__main__':
   main()

上述代码产生以下输出：

PyQt5 - 数据库处理

PyQt5 库包含 **QtSql** 模块。它是一个详尽的类系统，用于与许多基于 SQL 的数据库通信。它的 **QSqlDatabase** 通过连接对象提供访问权限。以下是当前可用的 SQL 驱动程序列表：

示例

在本节中，使用静态方法建立与 SQLite 数据库的连接：

db = QtSql.QSqlDatabase.addDatabase('QSQLITE')
db.setDatabaseName('sports.db')

QSqlDatabase 类的其他方法如下：

**QSqlQuery** 类具有执行和操作 SQL 命令的功能。可以执行 DDL 和 DML 类型的 SQL 查询。第一步是使用以下语句创建 SQlite 数据库：

db = QSqlDatabase.addDatabase('QSQLITE')
db.setDatabaseName('sportsdatabase.db')

接下来，使用 **QSqlQuery()** 方法获取 Query 对象，并调用其最重要的方法 exec_()，该方法将包含要执行的 SQL 语句的字符串作为参数。

query = QtSql.QSqlQuery()
query.exec_("create table sportsmen(id int primary key, " "firstname varchar(20), lastname varchar(20))")

以下脚本创建了一个 SQLite 数据库 sports.db，其中包含一个填充了五个记录的 sportsperson 表。

import sys
from PyQt5.QtSql import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

def createDB():
   db = QSqlDatabase.addDatabase('QSQLITE')
   db.setDatabaseName('sportsdatabase.db')

   if not db.open():
      msg = QMessageBox()
      msg.setIcon(QMessageBox.Critical)
      msg.setText("Error in Database Creation")
      retval = msg.exec_()
      return False
   query = QSqlQuery()

   query.exec_("create table sportsmen(
      id int primary key, ""firstname varchar(20), lastname varchar(20))")

   query.exec_("insert into sportsmen values(101, 'Roger', 'Federer')")
   query.exec_("insert into sportsmen values(102, 'Christiano', 'Ronaldo')")
   query.exec_("insert into sportsmen values(103, 'Ussain', 'Bolt')")
   query.exec_("insert into sportsmen values(104, 'Sachin', 'Tendulkar')")
   query.exec_("insert into sportsmen values(105, 'Saina', 'Nehwal')")
   return True

if __name__ == '__main__':
   app = QApplication(sys.argv)
   createDB()

要确认 SQLite 数据库已创建，并在其中的 sportsmen 表中添加了上述记录，请使用名为 **SQLiteStudio** 的 SQLite GUI 实用程序。

PyQt 中的 **QSqlTableModel** 类是一个高级接口，它提供可编辑的数据模型，用于读取和写入单个表中的记录。此模型用于填充 **QTableView** 对象。它为用户提供了一个可滚动和可编辑的视图，可以将其放在任何顶级窗口上。

QSqlTableModel 对象的声明方式如下：

model = QtSql.QSqlTableModel()

其编辑策略可以设置为以下任何一种：

示例

在以下示例中，sportsperson 表用作模型，策略设置为：

model.setTable('sportsmen') 
model.setEditStrategy(QtSql.QSqlTableModel.OnFieldChange)
   model.select()

QTableView 类是 PyQt 中 Model/View 框架的一部分。QTableView 对象的创建方式如下：

view = QtGui.QTableView()
view.setModel(model)
view.setWindowTitle(title)
return view

此 QTableView 对象和两个 QPushButton 小部件被添加到顶级 QDialog 窗口。add 按钮的 clicked() 信号连接到 addrow()，该函数对模型表执行 insertRow()。

button.clicked.connect(addrow)
def addrow():
   print model.rowCount()
   ret = model.insertRows(model.rowCount(), 1)
   print ret

与 delete 按钮关联的槽执行一个 lambda 函数，该函数删除用户选择的行。

btn1.clicked.connect(lambda: model.removeRow(view1.currentIndex().row()))

完整代码如下：

import sys
from PyQt5.QtSql import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

def initializeModel(model):
   model.setTable('sportsmen')
   model.setEditStrategy(QSqlTableModel.OnFieldChange)
   model.select()
   model.setHeaderData(0, Qt.Horizontal, "ID")
   model.setHeaderData(1, Qt.Horizontal, "First name")
   model.setHeaderData(2, Qt.Horizontal, "Last name")

def createView(title, model):
   view = QTableView()
   view.setModel(model)
   view.setWindowTitle(title)
   return view

def addrow():
   print (model.rowCount())
   ret = model.insertRows(model.rowCount(), 1)
   print (ret)

def findrow(i):
   delrow = i.row()

if __name__ == '__main__':
   app = QApplication(sys.argv)
   db = QSqlDatabase.addDatabase('QSQLITE')
   db.setDatabaseName('sportsdatabase.db')
   model = QSqlTableModel()
   delrow = -1
   initializeModel(model)

   view1 = createView("Table Model (View 1)", model)
   view1.clicked.connect(findrow)

   dlg = QDialog()
   layout = QVBoxLayout()
   layout.addWidget(view1)

   button = QPushButton("Add a row")
   button.clicked.connect(addrow)
   layout.addWidget(button)

   btn1 = QPushButton("del a row")
   btn1.clicked.connect(lambda: model.removeRow(view1.currentIndex().row()))
   layout.addWidget(btn1)

   dlg.setLayout(layout)
   dlg.setWindowTitle("Database Demo")
   dlg.show()
   sys.exit(app.exec_())

上述代码产生以下输出：

尝试添加和删除一些记录，然后返回到 SQLiteStudio 以确认事务。

PyQt5 - 绘图 API

PyQt 中的所有 **QWidget** 类都是从 QPaintDevice 类派生的。**QPaintDevice** 是二维空间的抽象，可以使用 QPainter 在其上绘制。绘图设备的尺寸以像素为单位测量，从左上角开始。

**QPainter** 类在小部件和其他可绘制设备（如打印机）上执行低级绘图。通常，它用于小部件的绘图事件中。每当小部件的外观更新时，就会发生 **QPaintEvent**。

通过调用 **begin()** 方法激活绘图器，而 **end()** 方法则停用它。在这两者之间，通过以下表格中列出的适当方法绘制所需的图案。

示例

在以下代码中，使用了 PyQt 的各种绘图方法。

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class Example(QWidget):
   def __init__(self):
      super(Example, self).__init__()
      self.initUI()

   def initUI(self):
      self.text = "hello world"
      self.setGeometry(100,100, 400,300)
      self.setWindowTitle('Draw Demo')
      self.show()

   def paintEvent(self, event):
      qp = QPainter()
      qp.begin(self)
      qp.setPen(QColor(Qt.red))
      qp.setFont(QFont('Arial', 20))
      qp.drawText(10,50, "hello Python")
      qp.setPen(QColor(Qt.blue))
      qp.drawLine(10,100,100,100)
      qp.drawRect(10,150,150,100)
      qp.setPen(QColor(Qt.yellow))
      qp.drawEllipse(100,50,100,50)
      qp.drawPixmap(220,10,QPixmap("pythonlogo.png"))
      qp.fillRect(20,175,130,70,QBrush(Qt.SolidPattern))
      qp.end()

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

if __name__ == '__main__':
   main()

上述代码产生以下输出：

PyQt5 - BrushStyle 常量

在本节中，我们将学习画笔样式常量。

画笔样式常量

以下是画笔样式常量：

预定义的 QColor 样式

以下是预定义的 QColor 样式：

预定义的 QColor 对象

以下是预定义的 QColor 对象：

PyQt5 - QClipboard

**QClipboard** 类提供对系统范围的剪贴板的访问，该剪贴板提供了一种简单的机制，可以在应用程序之间复制和粘贴数据。它的作用类似于 **QDrag** 类，并使用类似的数据类型。

QApplication 类具有一个静态方法 **clipboard()**，它返回对剪贴板对象的引用。任何类型的 MimeData 都可以复制到剪贴板或从剪贴板粘贴。

以下是常用剪贴板类方法：

与剪贴板对象关联的信号是：

示例

在以下示例中，两个 TextEdit 对象和两个 Pushbuttons 被添加到顶级窗口。

首先，实例化剪贴板对象。textedit 对象的 Copy() 方法将数据复制到系统剪贴板。单击“粘贴”按钮时，它会获取剪贴板数据并将其粘贴到另一个 textedit 对象中。

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class Example(QWidget):
   def __init__(self):
      super(Example, self).__init__()

      self.initUI()

   def initUI(self):
      hbox = QVBoxLayout()
      self.edit1=QTextEdit()
      hbox.addWidget(self.edit1)
      self.btn1=QPushButton("Copy")
      hbox.addWidget(self.btn1)
      self.edit2=QTextEdit()
      self.btn2=QPushButton("Paste")
      hbox.addWidget(self.edit2)
      hbox.addWidget(self.btn2)
      self.btn1.clicked.connect(self.copytext)
      self.btn2.clicked.connect(self.pastetext)
      self.setLayout(hbox)
      
      self.setGeometry(300, 300, 300, 200)
      self.setWindowTitle('Clipboard')
      self.show()
      
   def copytext(self):

      #clipboard.setText(self.edit1.copy())
      self.edit1.copy()
      print (clipboard.text())

      msg=QMessageBox()
      msg.setText(clipboard.text()+" copied on clipboard")
      msg.exec_()

   def pastetext(self):
      self.edit2.setText(clipboard.text())

app = QApplication(sys.argv)
clipboard=app.clipboard()
ex = Example()
ex.setWindowTitle("clipboard Example")
sys.exit(app.exec_())

上述代码产生以下输出：

PyQt5 - QPixmap 类

QPixmap 类提供图像的屏幕外表示。它可以用作 QPaintDevice 对象，也可以加载到另一个小部件中，通常是标签或按钮。

Qt API 还有另一个类似的类QImage，它针对 I/O 和其他像素操作进行了优化。另一方面，Pixmap 针对屏幕显示进行了优化。这两种格式可以相互转换。

可以读取到 QPixmap 对象中的图像文件类型如下：

以下方法可用于处理 QPixmap 对象：

QPixmap 最常见的用途是在标签/按钮上显示图像。

示例

以下示例演示了使用setPixmap()方法在 QLabel 上显示图像。

完整代码如下：

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

def window():
   app = QApplication(sys.argv)
   win = QWidget()
   l1 = QLabel()
   l1.setPixmap(QPixmap("python.png"))

   vbox = QVBoxLayout()
   vbox.addWidget(l1)
   win.setLayout(vbox)
   win.setWindowTitle("QPixmap Demo")
   win.show()
   sys.exit(app.exec_())

if __name__ == '__main__':
   window()

上述代码产生以下输出：