PyQt6/PySide6 的 QLabel 类-EW帮帮网

QLabel 是 PyQt6 或 PySide6 库中用于显示文本或图像的控件。它是最基本和最常用的控件之一，可以用来显示静态文本、富文本、图像以及动画等。QLabel 提供了丰富的功能和灵活性，使得开发者可以轻松地创建各种类型的标签。下面我将详细介绍 QLabel 的主要特性及其使用方法。

1. 基本概念

标签：一种用户界面元素，用于显示文本或图像。
文本标签：显示纯文本或富文本（支持HTML）。
图像标签：显示图像。
动画标签：显示动画（如GIF）。

2. 创建 QLabel 实例

要使用 QLabel，首先需要导入相应的库：

from PyQt6.QtWidgets import QApplication, QLabel, QVBoxLayout, QWidget
# 或者
from PySide6.QtWidgets import QApplication, QLabel, QVBoxLayout, QWidget

接着创建一个窗口，并在其中添加 QLabel 控件：

class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("我的应用程序")
        self.setGeometry(100, 100, 400, 300)
      
        # 初始化UI
        self.initUI()
  
    def initUI(self):
        layout = QVBoxLayout()
      
        # 创建文本标签
        text_label = QLabel("这是一个文本标签", self)
      
        # 创建富文本标签
        rich_text_label = QLabel("<h1>这是一个富文本标签</h1><p>支持HTML格式</p>", self)
      
        # 创建图像标签
        image_label = QLabel(self)
        pixmap = QPixmap("image.png")
        image_label.setPixmap(pixmap)
      
        # 添加标签到布局
        layout.addWidget(text_label)
        layout.addWidget(rich_text_label)
        layout.addWidget(image_label)
      
        self.setLayout(layout)

if __name__ == "__main__":
    app = QApplication([])
    window = MyWindow()
    window.show()
    app.exec()

3. QLabel 的常用属性和方法

属性

text：设置或获取标签的文本内容。
pixmap：设置或获取标签的图像内容。
alignment：设置或获取文本对齐方式。
wordWrap：设置或获取是否启用自动换行。
openExternalLinks：设置或获取是否允许打开外部链接。
scaledContents：设置或获取是否缩放图像以适应标签大小。
toolTip：设置或获取标签的工具提示文本。
statusTip：设置或获取标签的状态栏提示文本。
minimumSizeHint 和 sizeHint：获取标签的最小建议大小和建议大小。

方法

setText(str)：设置标签的文本内容。
setTextFormat(Qt.TextFormat)：设置文本格式（普通文本或富文本）。
setPixmap(QPixmap)：设置标签的图像内容。
setAlignment(Qt.AlignmentFlag)：设置文本对齐方式。
setWordWrap(bool)：设置是否启用自动换行。
setOpenExternalLinks(bool)：设置是否允许打开外部链接。
setScaledContents(bool)：设置是否缩放图像以适应标签大小。
setToolTip(str)：设置标签的工具提示文本。
setStatusTip(str)：设置标签的状态栏提示文本。
clear()：清除标签的内容。
setTextInteractionFlags(Qt.TextInteractionFlags)：设置文本交互标志（例如选择文本、复制文本等）。

4. 详细示例

设置文本

label = QLabel("这是一个文本标签", self)

设置富文本

label = QLabel("<h1>这是一个富文本标签</h1><p>支持HTML格式</p>", self)
label.setTextFormat(Qt.TextFormat.RichText)  # 设置为富文本格式

设置图像

label = QLabel(self)
pixmap = QPixmap("image.png")
label.setPixmap(pixmap)

设置文本对齐方式

label = QLabel("居中文本", self)
label.setAlignment(Qt.AlignmentFlag.AlignCenter)

启用自动换行

label = QLabel("这是一段很长的文本，会自动换行", self)
label.setWordWrap(True)

允许打开外部链接

label = QLabel("<a href='https://www.example.com'>访问网站</a>", self)
label.setTextFormat(Qt.TextFormat.RichText)
label.setOpenExternalLinks(True)

缩放图像以适应标签大小

label = QLabel(self)
pixmap = QPixmap("image.png")
label.setPixmap(pixmap)
label.setScaledContents(True)

设置工具提示和状态栏提示

label = QLabel("帮助", self)
label.setToolTip("点击以获取帮助")
label.setStatusTip("显示帮助信息")

清除标签内容

label.clear()

设置文本交互标志

label = QLabel("可以选择和复制的文本", self)
label.setTextInteractionFlags(Qt.TextInteractionFlag.TextSelectableByMouse | Qt.TextInteractionFlag.TextSelectableByKeyboard)

5. 信号与槽机制

QLabel 支持一些信号，这些信号可以在用户交互时发射。常见的信号包括 linkActivated 和 linkHovered。你可以通过连接这些信号到槽函数来处理用户的交互事件。

def on_link_activated(url):
    print(f"链接被激活: {url}")

def on_link_hovered(url):
    print(f"鼠标悬停在链接上: {url}")

label = QLabel("<a href='https://www.example.com'>访问网站</a>", self)
label.setTextFormat(Qt.TextFormat.RichText)
label.linkActivated.connect(on_link_activated)
label.linkHovered.connect(on_link_hovered)

6. 自定义样式

除了使用内置的样式设置外，你还可以通过样式表（QSS）来自定义标签的外观。样式表类似于CSS，提供了强大的样式控制能力。

label = QLabel("自定义样式标签", self)
label.setStyleSheet("""
    QLabel {
        background-color: #f0f0f0;
        border: 1px solid #cccccc;
        padding: 10px;
        font-size: 16px;
        color: #333333;
    }
""")

7. 动态更新标签内容

你可以动态地更新 QLabel 的内容，例如在定时器或其他事件触发时更新标签的文本或图像。

import time
from PyQt6.QtCore import QTimer

class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("我的应用程序")
        self.setGeometry(100, 100, 400, 300)
      
        # 初始化UI
        self.initUI()
      
        # 创建定时器
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.update_label)
        self.timer.start(1000)  # 每秒触发一次
  
    def initUI(self):
        layout = QVBoxLayout()
      
        # 创建文本标签
        self.text_label = QLabel("时间: 00:00:00", self)
      
        # 添加标签到布局
        layout.addWidget(self.text_label)
      
        self.setLayout(layout)
  
    def update_label(self):
        current_time = time.strftime("%H:%M:%S", time.localtime())
        self.text_label.setText(f"时间: {current_time}")

if __name__ == "__main__":
    app = QApplication([])
    window = MyWindow()
    window.show()
    app.exec()

总结

QLabel 是 PyQt6/PySide6 中非常基础且灵活的控件，适用于显示文本、图像、富文本以及动画等多种内容。通过设置不同的属性和使用样式表，你可以创建出丰富多样的标签样式。同时，通过信号与槽机制，你可以方便地处理用户的交互事件。希望以上内容能帮助你更好地理解和运用 QLabel，并能够根据具体需求创建出功能丰富且用户友好的标签控件。

PyQt6/PySide6 的 QLabel 类