PyQt5中各种控件的功能及属性介绍

from PyQt5.QtCore import Qt, QCoreApplication, QSettings, QProcess
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QTextEdit, QVBoxLayout, QHBoxLayout, QPushButton, QScrollArea, QListWidget, QComboBox, QListWidgetItem, QLineEdit, QFileDialog, QProgressBar, QSpacerItem, QSizePolicy, QPlainTextEdit, QTextBrowser, QMenu, QAction, QMessageBox, QInputDialog, QDialog, QDialogButtonBox, QCheckBox
from PyQt5.QtGui import QFont, QIcon, QColor, QPalette

三、控件功能及属性介绍

1. 应用程序——`QApplication`

`QApplication`是 PyQt 应用程序的核心组件之一。它管理应用程序的生命周期、事件循环以及窗口系统集成。在创建 PyQt 应用程序时，通常会先创建一个 `QApplication` 对象，并使用它来配置应用程序的全局设置，然后调用 `exec_()` 启动事件循环，使应用程序进入运行状态。应用程序的窗口和交互都建立在 `QApplication` 的基础之上。

以下是一些常用的 `QApplication` 方法和属性：

1. 构造函数：

`QApplication(sys.argv)`: 创建一个 `QApplication` 对象。`sys.argv` 是命令行参数的列表，通常传递给应用程序以处理命令行选项。

2. 设置应用程序信息：

`setApplicationName(name)`: 设置应用程序的名称。

`setApplicationVersion(version)`: 设置应用程序的版本号。

`setOrganizationName(organization)`: 设置组织的名称，通常用于存储应用程序设置。

`setOrganizationDomain(domain)`: 设置组织的域名。

3. 启动事件循环：

`exec_()`: 启动应用程序的事件循环，使应用程序进入运行状态。注意，`exec_()` 后面有下划线，这是因为 `exec` 是 Python 中的保留关键字。

4. 退出应用程序：

`exit(returnCode)`: 退出应用程序并返回指定的退出码。

5. 全局事件过滤器：

`installEventFilter(QObject)`: 安装全局事件过滤器，用于捕获和处理应用程序中的所有事件。

6. 获取主窗口：

`activeWindow()`: 获取当前激活的窗口，通常是主窗口。

`topLevelWidgets()`: 获取应用程序中的所有顶级窗口。

7. 单例模式：

`instance()`: 获取 `QApplication` 的单例实例。通常在应用程序中只有一个 `QApplication` 实例。

8. 应用程序退出信号：

`aboutToQuit.connect(slot)`: 连接应用程序即将退出的信号到一个槽函数，可用于执行清理操作。

2. 基本窗口——`QWidget`

`QWidget` 是构建用户界面的基础。它提供了构建用户界面的基本功能。可以创建自定义的窗口小部件，可包含其他小部件，如按钮、标签、文本框等，用于构建应用程序的用户界面。或者使用 `QWidget` 作为其他小部件的容器，构建复杂的用户界面。在 PyQt 应用程序中，通常会创建一个或多个 `QWidget` 对象来构建应用程序的窗口和界面。

以下是一些常用的 `QWidget` 方法和属性：

1. 构造函数：

`QWidget(parent=None)`: 创建一个 `QWidget` 对象。`parent` 参数是可选的，用于指定父窗口。

2. 设置窗口标题：

`setWindowTitle(title)`: 设置窗口的标题。

3. 设置窗口大小：

`setFixedSize(width, height)`: 设置窗口的固定大小。

`resize(width, height)`: 动态设置窗口的大小。

4. 设置窗口位置：

`move(x, y)`: 设置窗口的位置。

5. 显示和隐藏窗口：

`show()`: 显示窗口。

`hide()`: 隐藏窗口。

6. 设置窗口图标：

`setWindowIcon(icon)`: 设置窗口的图标。

7. 窗口最大化和最小化：

`showMaximized()`: 最大化窗口。

`showMinimized()`: 最小化窗口。

`showNormal()`: 恢复窗口正常状态。

8. 设置背景颜色：

`setStyleSheet(styleSheet)`: 设置窗口的样式表，以自定义背景颜色和外观。

9. 设置窗口关闭行为：

`setWindowFlag(Qt.WindowType)`: 设置窗口的关闭行为，如 `Qt.WindowCloseButtonHint`。

10. 设置窗口模态：

`setWindowModality(modality)`: 设置窗口的模态性，可以是非模态、应用程序模态等。

11. 接受和处理事件：

`event(event)`: 处理窗口事件，可以重写此方法来自定义事件处理。

12. 获取父窗口和子窗口：

`parentWidget()`: 获取父窗口。

`findChild(QObject, name)`: 查找指定名称的子窗口。

13. 布局管理器：

`setLayout(layout)`: 设置窗口的布局管理器，用于管理子部件的位置和大小。

14. 信号和槽：

`connect(sender, signal, slot)`: 连接信号与槽，以响应事件或用户交互。

3. 多行文本编辑——`QTextEdit`

`QTextEdit`是 PyQt 中的一个多行文本编辑小部件，它用于显示和编辑富文本或纯文本。`QTextEdit` 允许用户输入和编辑文本，支持格式化文本、插入图像、处理剪贴板等功能。

以下是一些常用的 `QTextEdit` 方法和属性：

1. 文本属性：

`setPlainText(text)`: 设置文本编辑框中显示的纯文本。

`toPlainText()`: 获取文本编辑框中的纯文本。

2. 文本样式：

`setFont(QFont)`: 设置文本的字体。

`setTextColor(QColor)`: 设置文本的颜色。

`setTextBackgroundColor(QColor)`: 设置文本的背景颜色。

3. 文本对齐：

`setAlignment(Qt.AlignmentFlag)`: 设置文本在文本编辑框内的对齐方式，如 `Qt.AlignLeft`、`Qt.AlignCenter`、`Qt.AlignRight` 等。

4. 自动滚动：

`setVerticalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置垂直滚动条的显示策略。

`setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置水平滚动条的显示策略。

5. 光标和选择：

`textCursor()`: 获取文本编辑框中的文本光标，可以用于操作文本光标的位置和选择。

`setCursorPosition(pos)`: 设置文本光标的位置。

`selectAll()`: 选择文本编辑框中的所有文本。

6. 编辑模式：

`setReadOnly(True/False)`: 设置文本编辑框为只读模式，禁止用户编辑文本。

7. 自动换行：

`setWordWrapMode(QTextOption.WrapMode)`: 启用或禁用文本自动换行。

8. 滚动和定位：

`verticalScrollBar()`: 获取垂直滚动条部件，可用于滚动文本。

`horizontalScrollBar()`: 获取水平滚动条部件，可用于滚动文本。

9. 信号和槽：

`textChanged.connect(slot)`: 连接文本编辑框文本变化的信号到一个槽函数，当文本发生变化时槽函数会被调用。

10. 清空文本：

`clear()`: 清空文本编辑框中的文本。

11. 插入文本和图像：

`insertPlainText(text)`: 在文本光标的位置插入纯文本。

`insertHtml(html)`: 在文本光标的位置插入富文本或 HTML 内容。

`insertImage(image)`: 在文本光标的位置插入图像。

12. 复制和粘贴：

`cut()`: 剪切选定的文本。

`copy()`: 复制选定的文本。

`paste()`: 粘贴剪贴板中的内容。

4. 垂直布局——`QVBoxLayout`（`QHoxLayout`为水平）

`QVBoxLayout` 用于管理窗口或容器中的子部件，使它们按垂直方向进行布局。垂直布局管理器将子部件垂直排列，从上到下依次摆放。

以下是一些常用的 `QVBoxLayout` 方法和属性：

1. 构造函数：

`QVBoxLayout()`: 创建一个垂直布局管理器对象。

2. 添加子部件：

`addWidget(widget)`: 将一个子部件添加到布局中，子部件会按照添加的顺序垂直排列。

3. 插入子部件：

`insertWidget(index, widget)`: 在布局中的特定位置插入一个子部件。

4. 删除子部件：

`removeWidget(widget)`: 从布局中移除一个子部件，但不会销毁该子部件。

`takeAt(index)`: 从布局中移除指定位置的子部件并返回该子部件的引用。

5. 子部件的伸展和对齐：

`setStretch(index, stretch)`: 设置子部件在垂直方向上的伸展因子，决定了子部件在可用空间中的占比。

`setAlignment(widget, alignment)`: 设置子部件的垂直对齐方式。

6. 布局控制：

`addSpacing(spacing)`: 在布局中添加一段固定的垂直空间。

`addStretch(stretch)`: 在布局中添加一段可伸展的垂直空间，将子部件推到布局的底部。

7. 设置间距：

`setSpacing(spacing)`: 设置子部件之间的垂直间距。

8. 清空布局：

`clear()`: 清空布局中的所有子部件。

9. 计算布局大小：

`minimumSize()`: 返回布局所需的最小尺寸。

`sizeHint()`: 返回布局的推荐尺寸。

5. 可滚动视区——`QScrollArea`

`QScrollArea` 提供了一个可滚动的视区，允许用户在视区中显示超出视口大小的内容。通常，`QScrollArea` 用于容纳大型的、超出显示区域的小部件或图像，并允许用户滚动以查看全部内容。

以下是一些常用的 `QScrollArea` 方法和属性：

1. 构造函数：

`QScrollArea(parent=None)`: 创建一个滚动区域对象。`parent` 参数是可选的，用于指定父窗口。

2. 设置滚动内容：

`setWidget(widget)`: 将一个小部件设置为滚动区域的内容。通常是 `QWidget` 或其子类的对象。

3. 获取滚动内容：

`widget()`: 返回当前设置为滚动区域内容的小部件。

4. 水平和垂直滚动条：

`setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置水平滚动条的显示策略，可以是 `Qt.ScrollBarAlwaysOn`、`Qt.ScrollBarAlwaysOff`、`Qt.ScrollBarAsNeeded`。

`setVerticalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置垂直滚动条的显示策略，同样可以是上述值。

5. 滚动到指定位置：

`verticalScrollBar()`: 获取垂直滚动条对象，可以用于滚动或查询滚动位置。

`horizontalScrollBar()`: 获取水平滚动条对象。

`ensureVisible(x, y, xMargin, yMargin)`: 将指定位置的内容滚动到视口中心。

6. 设置滚动速度：

`setScrollRate(xStep, yStep)`: 设置滚动区域的速度。

7. 自动调整滚动区域大小：

`setWidgetResizable(resizable)`: 设置是否允许滚动区域自动调整大小以适应内容的大小。

8. 视口边界：

`setViewportMargins(left, top, right, bottom)`: 设置视口的边界，用于控制内容与视口之间的间距。

9. 滚动事件：

`wheelEvent(event)`: 处理鼠标滚轮事件，实现滚动。

10. 获取滚动位置：

`horizontalScrollBar().value()`: 获取水平滚动条的当前位置。

`verticalScrollBar().value()`: 获取垂直滚动条的当前位置。

11. 信号和槽：

`verticalScrollBar().valueChanged.connect(slot)`: 连接垂直滚动条值变化的信号到一个槽函数，以响应滚动。

6. 项目列表——`QListWidget`

`QListWidget` 用于显示项目列表，每个项目可以包含文本、图标等信息。用户可以通过单击项目选择项目，也可以使用键盘上的方向键和回车键来选择和操作项目。

以下是一些常用的 `QListWidget` 方法和属性：

1. 构造函数：

`QListWidget(parent=None)`: 创建一个列表小部件对象。`parent` 参数是可选的，用于指定父窗口。

2. 添加项目：

`addItem(item)`: 向列表中添加一个项目。

`addItems(items)`: 向列表中添加多个项目。

3. 插入项目：

`insertItem(index, item)`: 在指定位置插入一个项目。

`insertItems(index, items)`: 在指定位置插入多个项目。

4. 移除项目：

`takeItem(row)`: 移除并返回指定行的项目。

`clear()`: 清空列表中的所有项目。

5. 获取项目：

`currentItem()`: 返回当前选择的项目。

`currentRow()`: 返回当前选择项目的行号。

`item(row)`: 返回指定行的项目。

`count()`: 返回列表中项目的数量。

6. 选择项目：

`setCurrentRow(row)`: 设置当前选择的行。

`setSelectionMode(QAbstractItemView.SelectionMode)`: 设置项目选择模式，可以是 `QAbstractItemView.SingleSelection`（单选）或 `QAbstractItemView.MultiSelection`（多选）等。

7. 项目属性：

`itemWidget(item, column)`: 获取指定项目的小部件。

`setItemWidget(item, column, widget)`: 在指定项目的指定列中设置小部件。

8. 信号和槽：

`itemClicked.connect(slot)`: 连接项目单击事件的信号到一个槽函数，以响应项目的单击。

`itemDoubleClicked.connect(slot)`: 连接项目双击事件的信号到一个槽函数，以响应项目的双击。

9. 排序：

`sortItems(order)`: 对项目进行排序，可以指定升序或降序排序。

7. 项目列表的项——`QListWidgetItem`

`QListWidgetItem` 表示 `QListWidget` 中的项目的类。每个 `QListWidgetItem` 实例代表列表中的一个项目，可以设置项目的文本、图标、状态等属性，并将其添加到 `QListWidget` 中。

以下是一些常用的 `QListWidgetItem` 方法和属性：

1. 构造函数：

`QListWidgetItem(text, parent=None, type=Type)`: 创建一个列表项目对象。`text` 参数是项目的文本标签，`parent` 是可选的父部件，`type` 是项目的类型。

2. 设置和获取文本：

`setText(text)`: 设置项目的文本标签。

`text()`: 获取项目的文本标签。

3. 设置和获取图标：

`setIcon(icon)`: 设置项目的图标。

`icon()`: 获取项目的图标。

4. 设置和获取状态：

`setCheckState(state)`: 设置项目的检查状态，用于创建带有复选框的项目。

`checkState()`: 获取项目的检查状态。

5. 设置和获取数据：

`setData(role, value)`: 设置项目的自定义数据，`role` 可以是 `Qt.ItemDataRole` 中的一个值。

`data(role)`: 获取项目的自定义数据。

6. 设置和获取工具提示：

`setToolTip(tooltip)`: 设置项目的工具提示文本。

`toolTip()`: 获取项目的工具提示文本。

7. 设置和获取状态提示：

`setStatusTip(statusTip)`: 设置项目的状态提示文本。

`statusTip()`: 获取项目的状态提示文本。

8. 设置和获取用户数据：

`setData(userData)`: 设置项目的用户数据，通常用于存储与项目相关的任意数据。

`userData()`: 获取项目的用户数据。

9. 设置和获取字体：

`setFont(font)`: 设置项目的字体。

`font()`: 获取项目的字体。

10. 设置和获取前景色：

`setForeground(color)`: 设置项目的前景色，用于文本颜色。

`foreground()`: 获取项目的前景色。

11. 设置和获取背景色：

`setBackground(color)`: 设置项目的背景色。

`background()`: 获取项目的背景色。

12. 设置和获取对齐方式：

`setTextAlignment(alignment)`: 设置项目文本的对齐方式。

`textAlignment()`: 获取项目文本的对齐方式。

13. 设置和获取大小提示：

`setSizeHint(size)`: 设置项目的大小提示，用于控制项目的大小。

`sizeHint()`: 获取项目的大小提示。

8. 创建可伸缩的空白空间——`QSpacerItem`

`QSpacerItem` 是 PyQt 中的一个小部件布局管理器中的特殊小部件，用于在布局中创建可伸缩的空白空间。通常，`QSpacerItem` 用于控制布局中小部件的间距、对齐和大小。

以下是一些 `QSpacerItem` 的常用方法和属性：

1. 构造函数：

`QSpacerItem(width,height,hPolicy=QSizePolicy.Expanding,vPolicy=QSizePolicy.Expanding)`: 创建一个可伸缩的空白空间小部件。`width` 和 `height` 参数指定了空间的初始大小，而 `hPolicy` 和 `vPolicy` 参数分别指定了水平和垂直方向上的策略，如 `QSizePolicy.Expanding` 表示可伸缩。

2. 设置策略：

`setSizePolicy(QSizePolicy)`: 设置空间的大小策略，可设置水平和垂直方向上的大小策略。

3. 获取策略：

`sizePolicy()`: 获取当前的大小策略。

4. 设置大小：

`changeSize(width, height)`: 更改空白空间的大小。

5. 获取大小：

`sizeHint()`: 获取空白空间的大小提示。

6. 设置对齐：

`setAlignment(alignment)`: 设置空白空间的对齐方式。

7. 获取对齐：

`alignment()`: 获取当前的对齐方式。

9. 控制小部件大小策略——`QSizePolicy`

`QSizePolicy` 定义了小部件在布局中的行为，包括小部件的最小尺寸、最大尺寸、伸缩性等。`QSizePolicy` 主要用于管理小部件在父容器中的布局和大小分配。

以下是一些常用的 `QSizePolicy` 方法和属性：

1. 构造函数：

`QSizePolicy(hPolicy, vPolicy, controlType=QSizePolicy.DefaultType)`: 创建一个大小策略对象。`hPolicy` 和 `vPolicy` 参数分别指定了水平和垂直方向上的大小策略，如 `QSizePolicy.Expanding` 表示可伸缩，`controlType` 参数指定了大小策略的控制类型。

2. 设置大小策略：

`setHeightForWidth(enable)`: 启用或禁用小部件的宽度影响高度。

`setWidthForHeight(enable)`: 启用或禁用小部件的高度影响宽度。

`setPolicy(hPolicy, vPolicy, controlType=QSizePolicy.DefaultType)`: 设置水平和垂直方向上的大小策略。

3. 获取大小策略：

`horizontalPolicy()`: 获取水平方向上的大小策略。

`verticalPolicy()`: 获取垂直方向上的大小策略。

4. 设置最小尺寸和最大尺寸：

`setMinimumSize(minimumSize)`: 设置小部件的最小尺寸。

`setMaximumSize(maximumSize)`: 设置小部件的最大尺寸。

5. 获取最小尺寸和最大尺寸：

`minimumSize()`: 获取小部件的最小尺寸。

`maximumSize()`: 获取小部件的最大尺寸。

6. 设置伸缩因子：

`setHorizontalStretch(stretch)`: 设置水平方向上的伸缩因子。

`setVerticalStretch(stretch)`: 设置垂直方向上的伸缩因子。

7. 获取伸缩因子：

`horizontalStretch()`: 获取水平方向上的伸缩因子。

`verticalStretch()`: 获取垂直方向上的伸缩因子。

8. 设置控制类型：

`setControlType(controlType)`: 设置大小策略的控制类型。

9. 获取控制类型：

`controlType()`: 获取大小策略的控制类型。

10. 菜单——`QMenu`

`QMenu`用于创建可以用于创建应用程序的主菜单、上下文菜单、工具栏菜单等。`QMenu` 可以包含多个菜单项（`QAction`）和子菜单，用于实现各种菜单功能，`QMenu` 通常与 `QAction` 一起使用，以便为菜单项设置操作和图标等属性。这使得创建交互性强、功能丰富的菜单界面变得非常方便。

以下是一些 `QMenu` 常用的方法和属性：

1. 构造函数：

`QMenu(title, parent=None)`: 创建一个菜单对象。`title` 参数用于设置菜单的标题，`parent` 参数是可选的，用于指定父窗口。

2. 添加菜单项：

`addAction(action)`: 向菜单中添加一个菜单项（`QAction`）。

`addSeparator()`: 在菜单中添加一个分隔符。

3. 插入菜单项：

`insertAction(before, action)`: 在指定菜单项之前插入一个菜单项。

`insertSeparator(before)`: 在指定菜单项之前插入一个分隔符。

4. 移除菜单项：

`removeAction(action)`: 从菜单中移除一个菜单项。

5. 添加子菜单：

`addMenu(menu)`: 向菜单中添加一个子菜单，可以创建多级嵌套菜单。

6. 获取菜单项：

`actions()`: 返回菜单中包含的所有菜单项（`QAction`）。

7. 显示菜单：

`exec(pos)`: 在指定位置显示菜单，通常用于弹出式菜单。`pos` 参数是显示菜单的位置。

8. 信号和槽：

`triggered[QAction]`: 菜单项被触发时发出的信号，可以连接到槽函数以响应菜单项的操作。

9. 设置快捷键：

`setShortcut(QKeySequence)`: 设置菜单的快捷键，用户可以通过键盘快捷键触发菜单。

10. 禁用和启用菜单项：

`setEnabled(True/False)`: 启用或禁用菜单。

11. 输入对话框——`QInputDialog`

`QInputDialog` 是一个对话框小部件，用于显示输入对话框，允许用户输入文本或数字等信息。它通常用于获取用户输入并返回输入的结果。

以下是一些 `QInputDialog` 常用的方法和属性：

1. 获取文本输入：

`getText(parent, title, label, echo=QLineEdit.Normal, text='', flags=Qt.WindowFlags, inputMethodHints=Qt.ImhNone)`: 显示文本输入对话框，用户可以输入文本。参数包括父窗口、对话框标题、标签（提示用户输入的文本）、输入掩码（如 `QLineEdit.Normal` 表示普通文本输入）、默认文本、窗口标志和输入法提示。

返回一个包含用户输入文本的元组 `(text, ok)`，其中 `text` 是用户输入的文本，`ok` 是一个布尔值，表示用户是否点击了对话框中的“OK”按钮。

2. 获取整数输入：

`getInt(parent, title, label, value=0, minValue=2147483647, maxValue=2147483647, step=1, flags=Qt.WindowFlags, inputMethodHints=Qt.ImhNone)`: 显示整数输入对话框，用户可以输入整数。

返回一个包含用户输入整数的元组 `(value, ok)`，其中 `value` 是用户输入的整数，`ok` 是一个布尔值，表示用户是否点击了对话框中的“OK”按钮。

3. 获取浮点数输入：

`getDouble(parent,title,label,value=0.00,minValue=2147483647.00,maxValue=2147483647.00, decimals=1,flags=Qt.WindowFlags,inputMethodHints=Qt.ImhNone)`: 显示浮点数输入对话框，用户可以输入浮点数。

返回一个包含用户输入浮点数的元组 `(value, ok)`，其中 `value` 是用户输入的浮点数，`ok` 是一个布尔值，表示用户是否点击了对话框中的“OK”按钮。

4. 获取条目选择：

`getItem(parent, title, label, items, current=0, editable=False, flags=Qt.WindowFlags, inputMethodHints=Qt.ImhNone)`: 显示一个下拉列表，用户可以选择一个条目。

返回一个包含用户选择的条目的元组 `(item, ok)`，其中 `item` 是用户选择的条目，`ok` 是一个布尔值，表示用户是否点击了对话框中的“OK”按钮。

12. 创建复选框——`QCheckBox`

`QCheckBox` 用于创建复选框。复选框是一种用户界面元素，允许用户在选中和取消选中之间进行切换。通过连接 `stateChanged` 信号，可以在复选框的状态发生变化时执行自定义操作，以便根据用户的选择来进行相应的处理。`QCheckBox` 可以用于让用户进行二进制选择，例如启用或禁用某个选项。

以下是一些 `QCheckBox` 常用的方法和属性：

1. 构造函数：

`QCheckBox(text, parent=None)`: 创建一个复选框对象。`text` 参数用于设置复选框旁边显示的文本，`parent` 参数是可选的，用于指定父窗口。

2. 获取和设置文本：

`text()`: 获取复选框旁边显示的文本。

`setText(text)`: 设置复选框旁边显示的文本。

3. 获取和设置选中状态：

`isChecked()`: 返回复选框的当前选中状态，返回值为布尔值。

`setChecked(checked)`: 设置复选框的选中状态，`checked` 为布尔值。

4. 信号和槽：

`stateChanged.connect(slot)`: 当复选框的选中状态发生变化时，触发 `stateChanged` 信号，可以连接到一个槽函数以响应状态变化。

5. 获取和设置三态：

`isTristate()`: 返回复选框是否为三态复选框。

`setTristate(tristate)`: 设置复选框是否为三态复选框，三态复选框可以表示选中、未选中和不确定三种状态。

6. 获取和设置快捷键：

`setShortcut(key)`: 设置复选框的快捷键，用户可以使用键盘快捷键来切换复选框的状态。

`shortcut()`: 获取复选框的快捷键。

13. 按钮类——`QpushButton`

可通过设置不同的属性来自定义按钮的外观和行为。

以下是一些常用的按钮属性：

1. 文本属性：

`setText(text)`: 设置按钮上显示的文本。

`text()`: 获取按钮上显示的文本。

2. 点击事件：

`clicked.connect(your_def)`: 连接按钮的点击事件到一个槽函数（函数或方法），当按钮被点击时，槽函数将被调用。

3. 启用/禁用：

`setEnabled(True/False)`: 启用或禁用按钮。

`isEnabled()`: 检查按钮是否启用。

4. 图标：

`setIcon(QIcon)`: 设置按钮的图标。

`setIconSize(QSize)`: 设置按钮图标的大小。

5. 工具提示：

`setToolTip(text)`: 设置按钮的工具提示，当鼠标悬停在按钮上时显示的文本。

6. 样式表：

`setStyleSheet(styleSheet)`: 设置按钮的样式表，以自定义按钮的外观。

7. 默认按钮：

`setDefault(True/False)`: 设置按钮为默认按钮，按下Enter键时激活。

8. 快捷键：

`setShortcut(QKeySequence)`: 设置按钮的快捷键，可以使用键盘快捷方式触发按钮。

9. 大小和位置：

`setGeometry(x, y, width, height)`: 设置按钮的位置和大小。

`move(x, y)`: 移动按钮到指定的坐标。

`resize(width, height)`: 调整按钮的大小。

10. 自动重复：

`setAutoRepeat(True/False)`: 启用或禁用按钮的自动重复，即按住按钮不放会多次触发点击事件。

14. 静态文本——`QLabel`

`QLabel`用于显示文本和图像的标签部件，可用于显示文本、图像或二者的组合。例如，可以在标签上显示说明文本、图标或者超链接等内容。可通过设置不同的属性来自定义 `QLabel` 的外观和行为。

以下是一些常用的 `QLabel` 属性和方法：

1. 文本属性：

`setText(text)`: 设置标签上显示的文本。

`text()`: 获取标签上显示的文本。

2. 图像属性：

`setPixmap(QPixmap)`: 设置标签上显示的图像。

`setScaledContents(True/False)`: 根据标签大小自动缩放图像。

3. 工具提示：

`setToolTip(text)`: 设置标签的工具提示，当鼠标悬停在标签上时显示的文本。

4. 样式表：

`setStyleSheet(styleSheet)`: 设置标签的样式表，以自定义标签的外观。

5. 文本对齐：

`setAlignment(Qt.AlignmentFlag)`: 设置文本在标签内的对齐方式，可以是 `Qt.AlignLeft`、`Qt.AlignCenter`、`Qt.AlignRight` 等。

6. 字体和颜色：

`setFont(QFont)`: 设置标签的字体。

`setForegroundRole(QPalette.ColorRole)`: 设置前景颜色，可以是 `QPalette.WindowText`、`QPalette.WindowText` 等。

7. 超链接：

`setOpenExternalLinks(True/False)`: 允许或禁止标签上的文本作为超链接打开外部网页。

8. 自动换行：

`setWordWrap(True/False)`: 启用或禁用文本的自动换行。

9. 大小和位置：

`setGeometry(x, y, width, height)`: 设置标签的位置和大小。

`move(x, y)`: 移动标签到指定的坐标。

`resize(width, height)`: 调整标签的大小。

15. 单行文本输入——`QLineEdit`

`QLineEdit`是一个用于接收单行文本输入的小部件。它通常用于获取用户的文本输入，例如用户名、密码、搜索关键字等。

以下是一些常用的 `QLineEdit` 属性和方法：

1. 文本属性：

`setText(text)`: 设置文本框中显示的文本。

`text()`: 获取文本框中的文本。

2. 占位符文本：

`setPlaceholderText(text)`: 设置文本框内的占位符文本。当文本框为空时，占位符文本显示在文本框内，用于提示用户输入内容。

3. 输入限制：

`setMaxLength(length)`: 设置文本框允许输入的最大字符数。

`setInputMask(mask)`: 设置文本框的输入掩码，用于限制输入格式，如电话号码、日期等。

4. 信号和槽：

`textChanged.connect(slot)`: 连接文本框文本变化的信号到一个槽函数，当文本发生变化时槽函数会被调用。

5. 验证器：

`setValidator(QValidator)`: 设置文本框的验证器，用于自定义文本输入的有效性验证。

6. 自动完成：

`setCompleter(QCompleter)`: 设置文本框的自动完成器，用于提供自动完成建议。

7. 清空文本：

`clear()`: 清空文本框中的文本。

8. 只读模式：

`setReadOnly(True/False)`: 设置文本框为只读模式，禁止用户编辑文本。

9. 密码模式：

`setEchoMode(QLineEdit.EchoMode)`: 设置文本框的回显模式，可以用于输入密码或其他敏感信息。

10. 获得焦点和失去焦点：

`setFocus()`: 使文本框获得焦点。

`clearFocus()`: 使文本框失去焦点。

16. 多行文本编辑——`QTextEdit`

`QTextEdit`可以使用它来创建多行文本输入框、文本查看器、富文本编辑器等各种应用程序。`QTextEdit` 提供了丰富的文本编辑功能，允许用户输入、编辑和格式化文本。

以下是一些常用的 `QTextEdit` 属性和方法：

1. 文本属性：

`setPlainText(text)`: 设置文本编辑框中显示的文本。

`toPlainText()`: 获取文本编辑框中的文本。

2. 文本样式：

`setFont(QFont)`: 设置文本的字体。

`setTextColor(QColor)`: 设置文本的颜色。

`setTextBackgroundColor(QColor)`: 设置文本的背景颜色。

3. 文本对齐：

`setAlignment(Qt.AlignmentFlag)`: 设置文本在文本编辑框内的对齐方式，可以是 `Qt.AlignLeft`、`Qt.AlignCenter`、`Qt.AlignRight` 等。

4. 自动滚动：

`setVerticalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置垂直滚动条的显示策略。

`setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置水平滚动条的显示策略。

5. 光标和选择：

`textCursor()`: 获取文本编辑框中的文本光标，可以用于操作文本光标的位置和选择。

`setCursorPosition(pos)`: 设置文本光标的位置。

`selectAll()`: 选择文本编辑框中的所有文本。

6. 编辑模式：

`setReadOnly(True/False)`: 设置文本编辑框为只读模式，禁止用户编辑文本。

`setAcceptRichText(True/False)`: 设置文本编辑框是否接受富文本（HTML）。

7. 自动换行：

`setWordWrapMode(QTextOption.WrapMode)`: 启用或禁用文本自动换行。

8. 滚动和定位：

`verticalScrollBar()`: 获取垂直滚动条部件，可用于滚动文本。

`horizontalScrollBar()`: 获取水平滚动条部件，可用于滚动文本。

9. 信号和槽：

`textChanged.connect(slot)`: 连接文本编辑框文本变化的信号到一个槽函数，当文本发生变化时槽函数会被调用。

10. 清空文本：

`clear()`: 清空文本编辑框中的文本。

17. 多行文本编辑——`QPlainTextEdit`

`QPlainTextEdit`类似于 `QTextEdit`，但更适合于显示和编辑纯文本。它通常用于显示和编辑大量文本数据，不支持富文本或 HTML 格式。

以下是一些常用的 `QPlainTextEdit` 方法和属性：

1. 文本属性：

`setPlainText(text)`: 设置文本编辑框中显示的纯文本。

`toPlainText()`: 获取文本编辑框中的纯文本。

2. 文本样式：

`setFont(QFont)`: 设置文本的字体。

`setTextColor(QColor)`: 设置文本的颜色。

3. 文本对齐：

`setAlignment(Qt.AlignmentFlag)`: 设置文本在文本编辑框内的对齐方式，可以是 `Qt.AlignLeft`、`Qt.AlignCenter`、`Qt.AlignRight` 等。

4. 自动滚动：

`setVerticalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置垂直滚动条的显示策略。

`setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy)`: 设置水平滚动条的显示策略。

5. 光标和选择：

`textCursor()`: 获取文本编辑框中的文本光标，可以用于操作文本光标的位置和选择。

`setCursorPosition(pos)`: 设置文本光标的位置。

`selectAll()`: 选择文本编辑框中的所有文本。

6. 编辑模式：

`setReadOnly(True/False)`: 设置文本编辑框为只读模式，禁止用户编辑文本。

7. 自动换行：

`setWordWrapMode(QTextOption.WrapMode)`: 启用或禁用文本自动换行。

8. 滚动和定位：

`verticalScrollBar()`: 获取垂直滚动条部件，可用于滚动文本。

`horizontalScrollBar()`: 获取水平滚动条部件，可用于滚动文本。

9. 信号和槽：

`textChanged.connect(slot)`: 连接文本编辑框文本变化的信号到一个槽函数，当文本发生变化时槽函数会被调用。

10. 清空文本：

`clear()`: 清空文本编辑框中的文本。

18. 多行文本显示——`QTextBrowser`

`QTextBrowser`用于显示富文本或 HTML 格式的文本内容。与 `QTextEdit` 和 `QPlainTextEdit` 不同，`QTextBrowser` 主要用于显示文本而不是编辑文本。

以下是一些常用的 `QTextBrowser` 方法和属性：

1. 文本内容：

`setPlainText(text)`: 设置文本浏览器中显示的纯文本。

`setHtml(html)`: 设置文本浏览器中显示的富文本或 HTML 内容。

`setSource(QUrl)`: 设置文本浏览器要显示的网页或外部资源。

`setOpenExternalLinks(True/False)`: 允许或禁止文本浏览器中的外部链接。

2. 获取文本内容：

`toPlainText()`: 获取文本浏览器中的纯文本内容。

`toHtml()`: 获取文本浏览器中的富文本或 HTML 内容。

3. 打开链接：

`anchorClicked.connect(slot)`: 连接链接点击事件的信号到一个槽函数，当用户点击链接时槽函数会被调用。

4. 文本查找和搜索：

`find(text, options)`: 在文本浏览器中查找指定文本，可以设置搜索选项。

`findNext()`: 查找下一个匹配项。

`findPrevious()`: 查找上一个匹配项。

5. 滚动和定位：

`verticalScrollBar()`: 获取垂直滚动条部件，可用于滚动文本。

`horizontalScrollBar()`: 获取水平滚动条部件，可用于滚动文本。

6. 清空内容：

`clear()`: 清空文本浏览器中的内容。

7. 样式和外观：

`setStyleSheet(styleSheet)`: 设置文本浏览器的样式表，以自定义外观。

`setTextInteractionFlags(flags)`: 设置文本浏览器的文本交互标志，例如允许复制文本、允许点击链接等。

8. 打印内容：

`print(QPrinter)`: 将文本浏览器的内容打印到指定的打印机。

19. 下拉框——`QComboBox`

`QComboBox`用于在一个下拉列表中显示可选择的项。用户可以从列表中选择一个项，或者输入文本来搜索并选择项。

以下是一些常用的 `QComboBox` 属性和方法：

1. 添加和移除项：

`addItem(text, userData=None)`: 向下拉框中添加一个文本项，并可选地附加用户数据。

`addItems(textList)`: 向下拉框中批量添加文本项。

`insertItem(index, text, userData=None)`: 在指定位置插入一个文本项。

`removeItem(index)`: 移除指定位置的文本项。

`clear()`: 清空下拉框中的所有项。

2. 获取和设置当前选择项：

`currentIndex()`: 获取当前选择项的索引。

`currentText()`: 获取当前选择项的文本。

`setCurrentIndex(index)`: 设置当前选择项的索引。

`setCurrentText(text)`: 设置当前选择项的文本。

3. 用户输入和搜索：

`setEditable(True/False)`: 设置下拉框是否可编辑，如果可编辑，用户可以手动输入文本。

`setCompleter(QCompleter)`: 设置自动完成器，用于自动匹配用户输入的文本。

4. 信号和槽：

`currentIndexChanged.connect(slot)`: 连接选择项发生变化的信号到一个槽函数，当用户选择不同的项时槽函数会被调用。

5. 样式和外观：

`setStyleSheet(styleSheet)`: 设置下拉框的样式表，以自定义外观。

`setView(QAbstractItemView)`: 设置下拉框中的项视图，用于自定义下拉框的显示方式。

6. 禁用和启用：

`setEnabled(True/False)`: 启用或禁用下拉框。

7. 下拉框尺寸：

`setSizeAdjustPolicy(QComboBox.SizeAdjustPolicy)`: 设置下拉框的尺寸调整策略，以自动调整大小以适应内容。

20. 文件对话框——`QFileDialog`

`QFileDialog` 允许用户选择文件或目录并返回所选文件的路径。`QFileDialog` 可以用于打开文件、保存文件、选择目录等操作。

以下是一些常用的 `QFileDialog` 方法和属性：

1. 打开文件对话框：

`getOpenFileName(parent, caption, directory, filter, options)`: 打开一个文件对话框，允许用户选择一个文件并返回文件的路径。参数包括对话框的父窗口、标题、默认目录、文件类型过滤器和选项。

2. 保存文件对话框：

`getSaveFileName(parent, caption, directory, filter, options)`: 打开一个保存文件对话框，允许用户选择文件的保存路径并返回路径。参数与 `getOpenFileName` 类似。

3. 选择目录对话框：

`getExistingDirectory(parent, caption, directory, options)`: 打开一个选择目录对话框，允许用户选择目录并返回目录路径。参数包括对话框的父窗口、标题、默认目录和选项。

4. 过滤文件类型：

`setNameFilter(filter)`: 设置文件类型过滤器，以限制用户选择的文件类型。例如，可以使用 `"Text Files (*.txt);;Python Files (*.py)"` 这样的过滤器。

5. 多选文件：

`setFileMode(QFileDialog.FileMode)`: 设置文件对话框的文件模式，可以是 `QFileDialog.ExistingFiles` 以允许选择多个文件。

6. 默认文件名：

`selectFile(filename)`: 设置文件对话框中的默认文件名。

7. 选项：

`setOption(QFileDialog.Option, on=True/False)`: 设置文件对话框的选项，例如显示隐藏文件、显示详细视图等。

8. 对话框结果：

`result()`: 获取用户的操作结果，例如选择的文件路径或目录路径。

21. 进度条——`QProgressBar`

`QProgressBar` 用于显示任务的进度。它可以用于表示任务的完成百分比或其他进度指示。

以下是一些常用的 `QProgressBar` 方法和属性：

1. 设置进度：

`setValue(value)`: 设置进度条的当前值，通常在任务执行时使用此方法更新进度。

2. 获取当前值：

`value()`: 获取进度条的当前值，表示任务的完成百分比。

3. 最小值和最大值：

`setMinimum(minimum)`: 设置进度条的最小值。

`setMaximum(maximum)`: 设置进度条的最大值。

`minimum()`: 获取进度条的最小值。

`maximum()`: 获取进度条的最大值。

4. 文本显示：

`setFormat(format)`: 设置进度条上显示的文本格式，可以包括百分比等信息。

`text()`: 获取当前进度条上显示的文本。

5. 样式和外观：

`setStyleSheet(styleSheet)`: 设置进度条的样式表，以自定义外观。

`setOrientation(Qt.Orientation)`: 设置进度条的方向，可以是水平或垂直。

6. 显示/隐藏文本：

`setTextVisible(True/False)`: 设置是否显示进度条上的文本。

7. 动画效果：

`setInvertedAppearance(True/False)`: 设置反向外观，可以创建动画效果。

8. 重置进度：

`reset()`: 重置进度条的当前值为最小值。

9. 信号和槽：

`valueChanged.connect(slot)`: 连接进度条值变化的信号到一个槽函数，可以实时响应进度变化。

22. 消息对话框——`QMessageBox`

`QMessageBox` 可以用于向用户显示不同类型的信息、警告、错误、提问等消息。

以下是一些常用的 `QMessageBox` 方法和属性：

1. 显示消息框：

`QMessageBox.information(parent, title, text, buttons, defaultButton)`: 显示信息消息框，通常用于显示一般信息。

`QMessageBox.warning(parent, title, text, buttons, defaultButton)`: 显示警告消息框，通常用于显示警告信息。

`QMessageBox.critical(parent, title, text, buttons, defaultButton)`: 显示严重错误消息框，通常用于显示错误信息。

`QMessageBox.question(parent, title, text, buttons, defaultButton)`: 显示问题消息框，通常用于询问用户的选择。

2. 消息文本：

`setText(text)`: 设置消息框中显示的文本。

`text()`: 获取消息框中的文本。

3. 标题：

`setWindowTitle(title)`: 设置消息框的标题。

`windowTitle()`: 获取消息框的标题。

4. 按钮：

`setStandardButtons(buttons)`: 设置消息框的标准按钮集合，例如 `QMessageBox.Ok | QMessageBox.Cancel`。

`setStandardButtons(QMessageBox.StandardButtons)`: 设置消息框的标准按钮集合。

`buttonClicked.connect(slot)`: 连接按钮点击事件的信号到一个槽函数，当用户点击按钮时槽函数会被调用。

5. 默认按钮：

`setDefaultButton(button)`: 设置消息框的默认按钮。

6. 图标：

`setIcon(icon)`: 设置消息框的图标，可以是信息、警告、错误、提问等类型。

7. 获取用户选择：

`exec()`: 显示消息框并等待用户的选择，返回用户选择的按钮。

8. 自定义按钮：

`addButton(text, role)`: 添加自定义按钮到消息框，可以为按钮指定角色，例如 `QMessageBox.YesRole`。

9. 返回按钮：

`clickedButton()`: 获取用户点击的按钮。

23. 动作类——`QAction`

`QAction`通常与菜单、工具栏、快捷键等用户界面元素一起使用，用于触发应用程序中的操作或命令。`QAction` 封装了要执行的操作、图标、文本、快捷键等信息，以及与执行操作相关联的槽函数。

以下是一些常用的 `QAction` 方法和属性：

1. 构造函数：

`QAction(parent=None)`: 创建一个 `QAction` 对象，可以指定父对象。

2. 设置文本和图标：

`setText(text)`: 设置操作的文本标签。

`setToolTip(toolTip)`: 设置操作的工具提示文本。

`setIcon(icon)`: 设置操作的图标。

`setIconText(text)`: 同时设置文本标签和图标。

3. 快捷键：

`setShortcut(key)`: 设置操作的快捷键，例如 "Ctrl+S"。

`setShortcutContext(Qt.ShortcutContext)`: 设置快捷键，可选值包括 `Qt.WindowShortcut` 和 `Qt.ApplicationShortcut`。

4. 状态和可用性：

`setDisabled(True/False)`: 禁用或启用操作。

`isEnabled()`: 检查操作是否可用。

5. 信号和槽：

`triggered.connect(slot)`: 连接操作触发信号到一个槽函数，当用户执行操作时槽函数会被调用。

6. 检查框和单选框：

`setCheckable(True/False)`: 设置操作为可检查的。

`setChecked(True/False)`: 设置操作的检查状态。

`isChecked()`: 检查操作的当前检查状态。

7. 关联对象：

`setData(data)`: 设置操作的关联数据，可以是任意类型的数据。

8. 上下文菜单：

`setMenu(QMenu)`: 将操作与一个菜单关联，用于创建上下文菜单。

9. 执行操作：

`trigger()`: 执行操作，触发操作的 `triggered` 信号。

24. 字体、图标、颜色和调色板——`QFont`、`QIcon`、`QColor` 和 `QPalette`

1. QFont（字体）：

`QFont` 类用于管理文本的字体属性，如字体类型、大小、加粗、斜体等。

常用方法：

`setFamily(family)`: 设置字体的家族。

`setPointSize(pointSize)`: 设置字体的点大小。

`setBold(bold)`: 设置字体是否加粗。

`setItalic(italic)`: 设置字体是否为斜体。

`setUnderline(underline)`: 设置字体是否带下划线。

`setStrikeOut(strikeOut)`: 设置字体是否带删除线。

`setWeight(weight)`: 设置字体的权重。

`setPixelSize(pixelSize)`: 设置字体的像素大小。

`setHintingPreference(hintingPreference)`: 设置字体的提示首选项。

`setKerning(kerning)`: 设置字体是否开启字距调整。

示例：

     font = QFont()
     font.setFamily("Arial")
     font.setPointSize(12)
     font.setBold(True)
     ```

2. QIcon（图标）：

`QIcon` 类用于表示图标，可以在应用程序中使用图标来表示操作、按钮或其他图形元素。

常用方法：

`QIcon(file_or_resource)`: 创建一个图标对象，可以使用文件路径或资源路径。

示例：

  icon = QIcon("icon.png")

3. QColor（颜色）：

`QColor` 类用于表示颜色，可以用于设置小部件的背景颜色、文本颜色等。

常用方法：

`setRgb(r, g, b)`: 设置颜色的红、绿、蓝分量。

`setAlpha(alpha)`: 设置颜色的透明度。

示例：

     color = QColor()
     color.setRgb(255, 0, 0)  # 设置为红色

4. QPalette（调色板）：

`QPalette` 类用于管理小部件的颜色组合，可以设置小部件的前景色、背景色等。

常用方法：

`setColor(QPalette.ColorGroup, QPalette.ColorRole, QColor)`: 设置调色板的颜色。

`color(QPalette.ColorGroup, QPalette.ColorRole)`: 获取调色板的颜色。

`setBrush(QPalette.ColorGroup, QPalette.ColorRole, QBrush)`: 设置调色板的画刷。

`brush(QPalette.ColorGroup, QPalette.ColorRole)`: 获取调色板的画刷。

示例：

     palette = widget.palette()
     palette.setColor(QPalette.Window, QPalette.WindowText, QColor(255, 0, 0))  # 设置窗口背景色和文本颜色
     widget.setPalette(palette)