学习文档

https://mp.weixin.qq.com/s/QiAW-NVfbpZqZxp1L632RA

http://code.py40.com/pyqt5/16.html

信号和槽 https://blog.csdn.net/qq_40243295/article/details/105633221

https://blog.csdn.net/weixin_44593822/article/details/112199746

mac配置 https://blog.csdn.net/weixin_42567622/article/details/123899386

简介

Qt5应用于gui 编程，pyqt5是一套Python绑定Digia QT5应用的框架

QtCore: 包含了核心的非GUI功能。此模块用于处理时间、文件和目录、各种数据类型、流、URL、MIME类型、线程或进程。
QtGui 包含类窗口系统集成、事件处理、二维图形、基本成像、字体和文本。
Qtwidgets 模块包含创造经典桌面风格的用户界面提供了一套UI元素的类。
QtMultimedia 包含的类来处理多媒体内容和API来访问相机和收音机的功能。
Qtbluetooth 模块包含类的扫描设备和连接并与他们互动。描述模块包含了网络编程的类。这些类便于TCP和IP和UDP客户端和服务器的编码，使网络编程更容易和更便携。
Qtpositioning 包含类的利用各种可能的来源，确定位置，包括卫星、Wi-Fi、或一个文本文件。 Enginio模块实现了客户端库访问Qt云服务托管的应用程序运行时。
Qtwebsockets模块包含实现WebSocket协议类。
QtWebKit包含一个基于Webkit2图书馆Web浏览器实现类。
Qtwebkitwidgets包含的类的基础webkit1一用于qtwidgets应用Web浏览器的实现。
QtXml包含与XML文件的类。这个模块为SAX和DOM API提供了实现。
QtSvg模块提供了显示SVG文件内容的类。可伸缩矢量图形（SVG）是一种描述二维图形和图形应用的语言。
QtSql模块提供操作数据库的类。
QtTest包含的功能，使pyqt5应用程序的单元测试

基本功能

QApplication

app = (sys.argv)

每一pyqt5应用程序必须创建一个应用程序对象。sys.argv参数是一个列表，从命令行输入参数。

QWidget

QWidget部件是pyqt5所有用户界面对象的基类。

app.exec_()

sys.exit(app.exec_())

app.exec_()方法有下划线。exec_()方法的作用是“进入程序的主循环直到exit()被调用”，最后一个窗口关闭后，程序才停止，停止后返回0

sys.exit()方法确保应用程序干净的退出，退出后杀掉进程，等于一个命令行命令

三个窗口基类

QmainWindow

QMainWindow 类经常被继承，可以包含菜单栏，工具栏，状态栏，标题栏等，是 GUI 程序的主窗口。如果我们需要创建主窗口程序，就使用该类。

addToolBar() 添加工具栏
setCentralWidget() 设置窗口中心的控件
centralWidget() 返回窗口中心的控件，未设置返回 NULL
menuBar() 返回主窗口的菜单栏
setStatusBar() 设置状态栏
statusBar() 获取状态栏对象

QDialog

QDialog 是对话框窗口的基类，对话框一般用来执行短期任务，或者与用户进行互动，它可以是模态的也可以是非模态的。QDialog 没有菜单栏，工具栏，状态栏等。如果我们需要的是对话框，就选择该类。 QDialog 类的子类主要有 QMessageBox、QFileDialog、QFontDialog、QInputDialog、QColorDialog、QErrorMessage、QProgressDialog、QTabDialog、QWizard 等

QWidget

该类作为 QMainWindow 的父类，并未细化到主窗口或者对话框，作为通用窗口类，如果不确定具体使用哪种窗口类，就可以使用该类。 QWidget 类是所有用户界面对象的基类，窗口部件是用户界面的一个基本单元，它从窗口系统接收鼠标、键盘和其他消息，并在屏幕上绘制自己。一个窗口部件可以被它的父窗口或其他窗口挡住一部分。 QWidget 类中的 frameGeometry( ) 方法提供的成员函数：x( )、y( ) 用于获取客户区左上角的坐标，width（）、height( ) 用于获取客户区的宽度和高度。

pyqt5 常用组件

按钮类

QPushButton 普通按钮
QToolButton 工具按钮：通常在工具栏使用
QRadioButton 单选框
QCheckBox 复选框
QCommanLinkButton Vista 风格的命令链接按钮
QDialogButtonBox 对话框按钮组：确定、取消

显示组件

QLabel 标签
QTextBrowser 文本区域
QGraphicsView 图像显示
QCalendarWidget 日历组件
QProgressBar 进度条
QLCDNumber 液晶数字显示
QWebView Web 浏览器视图
QDeclarativeView 显示 Qt 声明的用户接口

输入组件

QComboBox 下拉选框
QFontComboBox 字体选择
QLineEdit 单行文本框
QTextEdit 多行文本框（富文本）
QPlainTextEdit 多行文本框（纯文本）
QSpinBox 整数范围调节器
QDoubleSpinBox 实型范围调节器
QDial 环形范围调节器
QSlider 滑动调节器
QTimeEdit 时间输入框
QDateEdit 日期输入框
QDateTimeEdit 时间日期输入框

容器类

QFrame 帧窗口
QWidget 界面部件，所有界面对象类的基类
QToolBox 工具栏容器
QTabWidget 多标签容器
QStackedWidget 层次容器，一次只有一个可见
QScollArea 滚动区域
QGroupBox 对象组容器
QMdiArea 多文档容器
QDockWidget 悬浮容器
QDail, QSpinBox 的使用

组件常用方法

文本类控件

Label 标签控件
- lb.setAlignment 设置对齐方式
- lb.setWordWrap(True) 设置文本换行显示
- lb.setOpenExternlLinks(True) 设置允许访问超链接
- 为标签设置图片：首先要导入 QPixmap，lb.setPixmap(QPixmap('图片路径'))
LineEdit 单行文本框
- setPlaceholderText() 设置文本框浮现文字
- setManLength() 设置允许文本框内输入字符的最大长度
- setAlignment() 设置文本对齐方式
- setReadOnly() 设置文本框只读
- setEchoMode 设置文本框显示字符的模式
  - le.NoEcho 不显示任何输入的字符
  - le.password 显示与平台相关的密码掩码字符，而不是实际输入的字
  - le.PasswordEchoOnEdit 在编辑时显示字符，失去焦点后显示密码掩码字符
- setValidator
  - QIntValidatoe ：限制输入整数
  - QDoubleValidator: 限制输入小数
  - QEegExpValidator: 检查输入是否符合设置的正则表达式
- clear() 清除文本框内容
TextEdit 多行文本框
- setPlainText() 设置文本内容
- toPlainText() 获取文本内容
- setTextColor(QtGui.QColor) 设置文本颜色
- setTextBackgroundColor() 设置文本的背景颜色
- setWordWrapMode() 设置自动换行
SpinBox 整数数字选择控件
- setValue() 设置控件的当前值
- setMaximum() 设置最大值
- setMinimum() 设置最小值
- setRange() 设置取值范围
- setSingleStep() 单机上下箭头的步长值
DoubleSpinBox 小数数字选择控件
LCDNumber 液晶数字显示控件

按钮类控件

setIcon() 设置按钮上的图标，可以将参数设置为 QtGui.QIcon('图标路径')
setIconSize() 参数可以设置为 QtCore.QSize(width,height)
setEnabled()
setShortcut()

选择列表类控件

comboBox 下拉组合框
- addItem() 添加一个下拉列表框
- addItems() 从列表中添加下拉选项
- currentText() 获取选中项的文本
- currentIndex() 获取选中项的索引
- itemText(index) 获取索引为 index 的项的文本
- setItemText(index,text) 设置索引为 index 的项的文本
- count() 获取所有选项的数量
- clear() 删除所有选项
- 常用信号：actived 和 currentIndexChanged
  - actived 信号在选中一个下拉选项时发射
  - currentIndexChanged 信号在下拉选项的索引发生改变时发射
QListWidget 列表框
- addItem() 向列表中添加项
- addItems() 一次向列表中添加多项
- insertItem() 在指定索引处插入项
- setCurrentItem() 设置当前选择项
- item.setToolTip() 设置提示内容
- item.isSelected() 判断项是否选中
- setWordWrap() 设置是否自动换行
- setViewMode() 设置显示模式
- item.text() 获取项的文本
- clear() 删除所有列表项

容器类控件

GroupBox
- setTitle() 设置分组标题
ToolBox
- addItem() 添加选项卡
- setCurrentIndex() 设置当前选中的选项卡索引
- setItemIcon() 设置选项卡的图标
- setItemText() 设置选项卡的标题文本
- setItemEnabled() 设置选项卡是否可用
- insertItem() 插入新选项卡
- removeItem() 移除选项卡
- itemText() 获取选项卡的文本
- currentIndex() 获取当前选项卡的索引

日期时间类控件

CalendarWidget
- setMinimumDate() 设置最小日期
- setMaximumDate 设置最大日期
- setFirstDayOfWeek 设置一周的第一天 Qt.Monday
- setGridVisible 设置是否显示网格线
- setSelectionMode 设置选择模式
  - QCalendarWidget.NoSelection:不能选中日期
  - QCalendarWidget.SingleSelection
- setHorizontallHeaderFormat 设置水平头部格式
  - QCalendarWidget.NoHorizontalHeader 不显示水平头部
  - QCalendarWidget.SingleLetterDayNames:"周"
  - QCalendarWidget.ShortDayNames：简短天的名称，如：周一
  - QCalendarWidget.LongDayNames: 完整天的名称如 “星期一”
- setNavigationBarVisible 设置是否显示导航栏
- setDateEditEnabled 设置是否可以编辑日期
- setDateEditAcceptDelay() 设置编辑日期的最长间隔
- selectedDate() 获取选择的日期，返回值而 QDate 类型
- 常用的信号时 selectionChanged,该信号的选择的日期发生改变时发射
QDateTimeEdit
- setTime 设置时间
- setMaximumTime() 设置最大时间
- setMinimumTime() 设置最小时间
- setTimeSpec() 获取显示的时间标准
  - LocalTime 本地时间
  - UTC 世界标准时间
- setDate() 设置日期
- setMaximumDate() 设置最大日期
- setMinimumDate() 设置最小日期
- setDisplayFormat() 设置日期时间显示样式
  - 日期样式：yyyy/MM/dd
  - 时间样式：HH:mm:ss
- date() 获取显示的日期，返回 QDate 类型
- time() 获取显示的时间，返回值为 QTime 类型
- dateTime() 获取显示的日期时间，返回值为 QDateTime 类型
常用信号
- timeChanged 时间发生改变时发射
- dateChanged 日期发生改变时发射
- dateTimeChanged 日期或者时间发生改变时发射

GUI 常用的两种布局方式

绝对位置布局

组件不放在布局管理器种，而通过函数 setGeometry(x, y, width, height) 来设定组件相对其父窗口的位置。其中 x, y 是组件左上角的坐标，width, height 是组件的宽和高。在绝对位置布局中，resize() 函数可以调整组件尺寸，setGeometry( ) 函数可以调整组件位置和尺寸，甚至重载 sizeHint( ) 函数也可以设定组件尺寸。采用绝对位置布局方式，组件的位置和尺寸固定，并不会随着父窗口位置和尺寸的改变而发生改变。

布局类简介

常用的布局类如下：

水平布局管理器（QHBoxLayout）可以把添加的控件以水平的顺序依次排开；
垂直布局管理器（QVBoxLayout）可以把添加的控件以垂直的顺序依次排开；
网格布局管理器（QGridLayout）可以以网格的形式把添加的控件以一定矩阵排列；
窗体布局管理器（QFormLayout）可以以两列的形式排列所添加的控件。

使用布局管理器的优点是，组件的布局根据用户设置和系统自行布局确定位置和尺寸，布局方式灵活，且组件的尺寸可以根据情况发生恰当的改变，布局美观。

布局类进阶：

1. 水平（垂直）布局管理器 [QHBoxLayout（QVBoxLayout）]

QHBoxLayout：按照从左到右的顺序添加控件。
QVBoxLayout：按照从上到下的顺序添加控件。

QHBoxLayout 类中的常用方法如下:

addLayout(self, QLayout, stretch=0)：在窗口的右边添加布局，使用 stretch 进行伸缩，默认伸缩量为 0；
addWidget(self, QWidget, stretch, Qt.Alignment alignment)：在布局中添加控件，其中 stretch 只适用于 QBoxLayout，控件和窗口会随着伸缩量的变大而增大；alignment 用于指定对齐方式;
addSpacing(self, int)：设置各控件的上下间距。通过该方法可以增加额外的空间。

2. 网格布局管理器（QGridLayout）

QGridLayout 将窗口分隔成行和列的网格来进行排列。通常可以使用 addWidget( ) 函数将被管理的控件（Widget）添加到窗口中，或者使用 addLayout( ) 函数将布局（Layout）添加到窗口中。也可以使用 addWidget( ) 函数对所添加的控件设置行数和列数的跨越，最终实现网格占据多个窗格。 QGridLayout 类中的常用方法如下：

1) addWidget(QWidget widget, int row, int column, int alignment=0)：给网格布局添加控件，设置指定的行和列。起始位置的默认值为 (0，0)。其中，widget 表示所添加的控件；row 表示控件的行数，默认从 0 开始；column 表示控件的列数，默认从 0 开始；alignment 表示对齐方式。 2) addWidget(QWidget widget, int fromRow, int fromColumn, int rowSpan, int columnSpan, Qt.Alignment alignment=0)：当所添加的控件跨越很多行或列时，使用这个函数。其中，widget 表示所添加的控件，fromRow 表示控件的起始行数，fromColumn 表示控件的起始列数，rowSpan 表示控件跨越的行数，columnSpan 表示控件跨越的列数，alignment 表示对齐方式。该方法用于设置控件在水平和垂直方向的间隔。

setStyleSheet 用法

setStyleSheet 是遵循 CSS 的写法，它可以定义某个窗口基类全局的 CSS，也可以针对某个组件去定义。具体可以参考 css 的手册： https://css.doyoe.com/

窗口基类全局定义

给 QDialog 下所有按钮、文本输入、label 等组件，定义字体样式、边框样式等

QFrame 简介

QFrame 是一个继承制 QWidget 的控制框架外形的类，主要是用来控制一些边框样式，、例如凸起、凹下、阴影、线宽等，它既可以直接使用，也可以作为需要边框控制的控件的基类。 QFrame 常用方法：

setFrameShape()：设置 QFrame 类窗口的边框，其参数见 QFrame.Shape 枚举值
setFrameShade()：设置 QFrame 类窗口的阴影，其参数见 QFrame.Shade 枚举值
setFrameStyle()：同时设置边框和阴影，参数为 QFrame.Shape|QFrame.Shade 组合
setLineWidth()：设置外线宽度；
setMidLineWidth()：设置中线宽度；
frameShape()：获取边框类型；
frameShade()：获取边框阴影；
lineWidth()：获取外线宽度；
midLineWidth()：获取中线宽度；
frameWidth()：总宽度。

QFrame.Shape 枚举变量及含义:

QFrame.NoFrame：0，无边框；
QFrame.Box：1，矩形框；
QFrame.Panel：2，凸起或者凹下的面板；
QFrame.WinPanel：3，Windows 2000 风格的面板，可以是凸起或下沉。边框的宽度是 2 像素。此属性是为了与旧版本的 Qt 兼容而存在的；
QFrame.HLine：4，水平线 (用作分隔线)；
QFrame.VLine：5，垂直线 (用着分隔线)；
QFrame.StyledPanel：6，根据当前 GUI 类型，画一个矩形面板，可以凸起或者凹

QFrame.Shade 枚举变量及含义: