PyQt6/PySide6中QLabel類的使用

更新時間：2025年05月14日 10:37:40 作者：燃燈工作室

QLabel?是 PyQt6 或 PySide6 庫中用于顯示文本或圖像的控件,本文主要介紹了PyQt6/PySide6中QLabel類的使用,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

QLabel 是 PyQt6 或 PySide6 庫中用于顯示文本或圖像的控件。它是最基本和最常用的控件之一，可以用來顯示靜態(tài)文本、富文本、圖像以及動畫等。QLabel 提供了豐富的功能和靈活性，使得開發(fā)者可以輕松地創(chuàng)建各種類型的標簽。下面我將詳細介紹 QLabel 的主要特性及其使用方法。

1. 基本概念

標簽：一種用戶界面元素，用于顯示文本或圖像。
文本標簽：顯示純文本或富文本（支持HTML）。
圖像標簽：顯示圖像。
動畫標簽：顯示動畫（如GIF）。

2. 創(chuàng)建 QLabel 實例

要使用 QLabel，首先需要導入相應的庫：

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

接著創(chuàng)建一個窗口，并在其中添加 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()
      
        # 創(chuàng)建文本標簽
        text_label = QLabel("這是一個文本標簽", self)
      
        # 創(chuàng)建富文本標簽
        rich_text_label = QLabel("<h1>這是一個富文本標簽</h1><p>支持HTML格式</p>", self)
      
        # 創(chuàng)建圖像標簽
        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：設置或獲取標簽的文本內(nèi)容。
pixmap：設置或獲取標簽的圖像內(nèi)容。
alignment：設置或獲取文本對齊方式。
wordWrap：設置或獲取是否啟用自動換行。
openExternalLinks：設置或獲取是否允許打開外部鏈接。
scaledContents：設置或獲取是否縮放圖像以適應標簽大小。
toolTip：設置或獲取標簽的工具提示文本。
statusTip：設置或獲取標簽的狀態(tài)欄提示文本。
minimumSizeHint 和 sizeHint：獲取標簽的最小建議大小和建議大小。

方法

setText(str)：設置標簽的文本內(nèi)容。
setTextFormat(Qt.TextFormat)：設置文本格式（普通文本或富文本）。
setPixmap(QPixmap)：設置標簽的圖像內(nèi)容。
setAlignment(Qt.AlignmentFlag)：設置文本對齊方式。
setWordWrap(bool)：設置是否啟用自動換行。
setOpenExternalLinks(bool)：設置是否允許打開外部鏈接。
setScaledContents(bool)：設置是否縮放圖像以適應標簽大小。
setToolTip(str)：設置標簽的工具提示文本。
setStatusTip(str)：設置標簽的狀態(tài)欄提示文本。
clear()：清除標簽的內(nèi)容。
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 , self)
label.setTextFormat(Qt.TextFormat.RichText)
label.setOpenExternalLinks(True)

縮放圖像以適應標簽大小

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

設置工具提示和狀態(tài)欄提示

label = QLabel("幫助", self)
label.setToolTip("點擊以獲取幫助")
label.setStatusTip("顯示幫助信息")

清除標簽內(nèi)容

label.clear()

設置文本交互標志

label = QLabel("可以選擇和復制的文本", self)
label.setTextInteractionFlags(Qt.TextInteractionFlag.TextSelectableByMouse | Qt.TextInteractionFlag.TextSelectableByKeyboard)

5. 信號與槽機制

QLabel 支持一些信號，這些信號可以在用戶交互時發(fā)射。常見的信號包括 linkActivated 和 linkHovered。你可以通過連接這些信號到槽函數(shù)來處理用戶的交互事件。

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

def on_link_hovered(url):
    print(f"鼠標懸停在鏈接上: {url}")

label = QLabel("<a , self)
label.setTextFormat(Qt.TextFormat.RichText)
label.linkActivated.connect(on_link_activated)
label.linkHovered.connect(on_link_hovered)

6. 自定義樣式

除了使用內(nèi)置的樣式設置外，你還可以通過樣式表（QSS）來自定義標簽的外觀。樣式表類似于CSS，提供了強大的樣式控制能力。

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

7. 動態(tài)更新標簽內(nèi)容

你可以動態(tài)地更新 QLabel 的內(nèi)容，例如在定時器或其他事件觸發(fā)時更新標簽的文本或圖像。

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()
      
        # 創(chuàng)建定時器
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.update_label)
        self.timer.start(1000)  # 每秒觸發(fā)一次
  
    def initUI(self):
        layout = QVBoxLayout()
      
        # 創(chuàng)建文本標簽
        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 中非常基礎且靈活的控件，適用于顯示文本、圖像、富文本以及動畫等多種內(nèi)容。通過設置不同的屬性和使用樣式表，你可以創(chuàng)建出豐富多樣的標簽樣式。同時，通過信號與槽機制，你可以方便地處理用戶的交互事件。希望以上內(nèi)容能幫助你更好地理解和運用 QLabel，并能夠根據(jù)具體需求創(chuàng)建出功能豐富且用戶友好的標簽控件。

到此這篇關于PyQt6/PySide6中QLabel類的使用的文章就介紹到這了,更多相關PyQt6/PySide6 QLabel類內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: