快捷導(dǎo)航

PyQt6/PySide6中QLabel類(lèi)的使用

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

QLabel?是 PyQt6 或 PySide6 庫(kù)中用于顯示文本或圖像的控件,本文主要介紹了PyQt6/PySide6中QLabel類(lèi)的使用,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

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

1. 基本概念

標(biāo)簽：一種用戶(hù)界面元素，用于顯示文本或圖像。
文本標(biāo)簽：顯示純文本或富文本（支持HTML）。
圖像標(biāo)簽：顯示圖像。
動(dòng)畫(huà)標(biāo)簽：顯示動(dòng)畫(huà)（如GIF）。

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

要使用 QLabel，首先需要導(dǎo)入相應(yīng)的庫(kù)：

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

接著創(chuàng)建一個(gè)窗口，并在其中添加 QLabel 控件：

class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("我的應(yīng)用程序")
        self.setGeometry(100, 100, 400, 300)
      
        # 初始化UI
        self.initUI()
  
    def initUI(self):
        layout = QVBoxLayout()
      
        # 創(chuàng)建文本標(biāo)簽
        text_label = QLabel("這是一個(gè)文本標(biāo)簽", self)
      
        # 創(chuàng)建富文本標(biāo)簽
        rich_text_label = QLabel("<h1>這是一個(gè)富文本標(biāo)簽</h1><p>支持HTML格式</p>", self)
      
        # 創(chuàng)建圖像標(biāo)簽
        image_label = QLabel(self)
        pixmap = QPixmap("image.png")
        image_label.setPixmap(pixmap)
      
        # 添加標(biāo)簽到布局
        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：設(shè)置或獲取標(biāo)簽的文本內(nèi)容。
pixmap：設(shè)置或獲取標(biāo)簽的圖像內(nèi)容。
alignment：設(shè)置或獲取文本對(duì)齊方式。
wordWrap：設(shè)置或獲取是否啟用自動(dòng)換行。
openExternalLinks：設(shè)置或獲取是否允許打開(kāi)外部鏈接。
scaledContents：設(shè)置或獲取是否縮放圖像以適應(yīng)標(biāo)簽大小。
toolTip：設(shè)置或獲取標(biāo)簽的工具提示文本。
statusTip：設(shè)置或獲取標(biāo)簽的狀態(tài)欄提示文本。
minimumSizeHint 和 sizeHint：獲取標(biāo)簽的最小建議大小和建議大小。

方法

setText(str)：設(shè)置標(biāo)簽的文本內(nèi)容。
setTextFormat(Qt.TextFormat)：設(shè)置文本格式（普通文本或富文本）。
setPixmap(QPixmap)：設(shè)置標(biāo)簽的圖像內(nèi)容。
setAlignment(Qt.AlignmentFlag)：設(shè)置文本對(duì)齊方式。
setWordWrap(bool)：設(shè)置是否啟用自動(dòng)換行。
setOpenExternalLinks(bool)：設(shè)置是否允許打開(kāi)外部鏈接。
setScaledContents(bool)：設(shè)置是否縮放圖像以適應(yīng)標(biāo)簽大小。
setToolTip(str)：設(shè)置標(biāo)簽的工具提示文本。
setStatusTip(str)：設(shè)置標(biāo)簽的狀態(tài)欄提示文本。
clear()：清除標(biāo)簽的內(nèi)容。
setTextInteractionFlags(Qt.TextInteractionFlags)：設(shè)置文本交互標(biāo)志（例如選擇文本、復(fù)制文本等）。

4. 詳細(xì)示例

設(shè)置文本

label = QLabel("這是一個(gè)文本標(biāo)簽", self)

設(shè)置富文本

label = QLabel("<h1>這是一個(gè)富文本標(biāo)簽</h1><p>支持HTML格式</p>", self)
label.setTextFormat(Qt.TextFormat.RichText)  # 設(shè)置為富文本格式

設(shè)置圖像

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

設(shè)置文本對(duì)齊方式

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

啟用自動(dòng)換行

label = QLabel("這是一段很長(zhǎng)的文本，會(huì)自動(dòng)換行", self)
label.setWordWrap(True)

允許打開(kāi)外部鏈接

label = QLabel("<a , self)
label.setTextFormat(Qt.TextFormat.RichText)
label.setOpenExternalLinks(True)

縮放圖像以適應(yīng)標(biāo)簽大小

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

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

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

清除標(biāo)簽內(nèi)容

label.clear()

設(shè)置文本交互標(biāo)志

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

5. 信號(hào)與槽機(jī)制

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

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

def on_link_hovered(url):
    print(f"鼠標(biāo)懸停在鏈接上: {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)置的樣式設(shè)置外，你還可以通過(guò)樣式表（QSS）來(lái)自定義標(biāo)簽的外觀。樣式表類(lèi)似于CSS，提供了強(qiáng)大的樣式控制能力。

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

7. 動(dòng)態(tài)更新標(biāo)簽內(nèi)容

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

import time
from PyQt6.QtCore import QTimer

class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("我的應(yīng)用程序")
        self.setGeometry(100, 100, 400, 300)
      
        # 初始化UI
        self.initUI()
      
        # 創(chuàng)建定時(shí)器
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.update_label)
        self.timer.start(1000)  # 每秒觸發(fā)一次
  
    def initUI(self):
        layout = QVBoxLayout()
      
        # 創(chuàng)建文本標(biāo)簽
        self.text_label = QLabel("時(shí)間: 00:00:00", self)
      
        # 添加標(biāo)簽到布局
        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"時(shí)間: {current_time}")

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

總結(jié)

QLabel 是 PyQt6/PySide6 中非?；A(chǔ)且靈活的控件，適用于顯示文本、圖像、富文本以及動(dòng)畫(huà)等多種內(nèi)容。通過(guò)設(shè)置不同的屬性和使用樣式表，你可以創(chuàng)建出豐富多樣的標(biāo)簽樣式。同時(shí)，通過(guò)信號(hào)與槽機(jī)制，你可以方便地處理用戶(hù)的交互事件。希望以上內(nèi)容能幫助你更好地理解和運(yùn)用 QLabel，并能夠根據(jù)具體需求創(chuàng)建出功能豐富且用戶(hù)友好的標(biāo)簽控件。

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

您可能感興趣的文章: