PyQt5 基礎知識（六）：展示控制元件

Kun發表於2022-04-06

QT控制元件

3、展示控制元件

3.1 QLabel

3.1.1 描述

提供了文字或影像的顯示

可以展示普通文字、數字、富文字、圖片和動畫

但是沒有提供使用者互動功能，繼承自QFrame

3.1.2 功能作用

3.1.2.1 基本功能

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
# @author: kun
from PyQt5.Qt import *
import sys

app = QApplication(sys.argv)
w = QWidget()
w.resize(500, 500)

l = QLabel("標籤哦", w)  # 建立一個標籤
"""
l.adjustSize()  # 根據內容適應標籤大小
l.setStyleSheet("background-color: skyblue;")

對齊
l.setAlignment(Qt.AlignLeft | Qt.AlignVCenter)

縮排和邊距
l.setIndent(20)
l.setMargin(20)

文字格式
l.setTextFormat(Qt.TextFormat)  # PlainText/ RichText/ AutoText/ MarkdownText

小夥伴
l.setBuddy(QWidget)  # 引數是要關聯的輸入框，當點選快捷鍵是可以快速定位到相應的文字框上面
內容縮放
l.setScaledContents(True)  # 設定圖片內容的縮放，適應控制元件大小，僅限於圖片

開啟文字連結
l.setOpenExternalLinks(True)  # 使得可以開啟超連結

單詞換行
l.setWordWrap(True)  # 設定單詞換行，同時也可以使用 \n 換行
"""

w.show()
sys.exit(app.exec_())

3.1.2.2 文字互動

# 設定互動模式
setTextInteractionFlags(Qt.TextInteractionFlags)
textInteractionFlags()

# 選中文字
setSelection(int start, int length)
hasSelection()
selectedText()
selectionStart()  # 返回開始位置的索引

Qt.TextInteractionFlags：

Qt.NoTextInteraction：不可能進行互動

Qt.TextSelectableByMouse：可以使用滑鼠選擇文字並使用上下文選單或標準鍵盤快捷鍵將其複製到剪下板

Qt.TextSelectionByKeyboard：可以使用鍵盤上的游標鍵選擇文字，顯示文字游標

Qt.LinksAccessibleByMouse：可以使用滑鼠突出顯示和啟用連結

Qt.LinksAccessibleByKeyborad：可以使用選項卡聚焦連結並使用enter啟用

Qt.TextEditable：改文字完全可以編輯

Qt.TextEditiorInteraction：文字編輯器的預設值；TextSelectableByMouse | TextSelectionByKeyboard | TextEditable

Qt.TextBrowserInteraction：文字瀏覽器的預設值； TextSelectableByMouse | TextSelectionByKeyboard | LinksAccessibleByMouse | LinksAccessibleByKeyborad

3.1.2.3 內容操作

3.1.2.3.1 文字字串

text()
setText(QString)  # 裡面可以新增富文字

3.1.2.3.2 數值資料

setNum(int / float)  # 設定數值

3.1.2.3.3 圖形影像

setPicture(QPicture)  # 主要用於繪畫裝置 
setPixmap(QPixmap)

3.1.2.3.4 動圖

setMovie(QMovie)  # 注意不是新增視訊，而是新增一個動圖
movie()

此類用於顯示沒有聲音的簡單動畫

常用操作：
setScaledSize(QSize)
setPaused(bool)
setSpeed(int)  # setSpeed(200)  兩倍速播放
start()  # 開始播放

3.1.2.3.5 清空

clear()  # 清空所有內容

3.1.3 訊號

# 超連結有關的訊號
linkActivated(link_str)
linkHovered(link_str)

3.2 QLCDNumber

3.2.1 描述

展示LCD樣式的數字，它可以展示幾乎任何大小的數字；它可以顯示十進位制、十六進位制、八進位制或二進位制

繼承自QFrame

3.2.2 功能作用

3.2.2.1 基本使用

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
# @author: kun
from PyQt5.Qt import *
import sys

app = QApplication(sys.argv)
w = QWidget()
w.resize(500, 500)

ql = QLCDNumber(w)  # 建構函式，還可以傳入一個數字，限制要展示的內容的位數
ql.resize(100, 50)
ql.display("12345")  # 設定展示的內容，裡面可以傳入字串，浮點資料，整型資料
print(ql.value())  # 獲取ql裡面的值，返回浮點型別資料
ql.setDigitCount(5)  # 限制5位數字
w.show()
sys.exit(app.exec_())

3.2.2.2 模式設定

setMode(QLCDNumber.Mode)
mode()
# 快速設定方法
setHexMode()  # 十六進位制
setDecMode()  # 十進位制
setOctMode()  # 八進位制
setBinMode()  # 二進位制

3.2.2.3 溢位判定

checkOverflower(float/ int)  # 判斷資料是否溢位，如果溢位會傳送一個溢位訊號

3.2.2.4 分段樣式

setSegmentStyle(QLCDNumber.SegmentStyle)
segmentStyle()

QLCDNumber.SegmentStyle:

QLCDNumber.Outline：生成填充了背景顏色的凸起部分

QLCDNumber.Filled：預設值，生成填充前景色的凸起部分

QLCDNumber.Flat：生成填充前景色的平坦段

3.2.3 訊號

overflow()  # 當資料溢位時，傳送訊號

3.3 QProgressBar

3.3.1 描述

提供一個水平或垂直進度條；進度條用於向使用者提供操作進度提示，並向他們保證應用程式仍在執行

繼承自 QWidget

3.3.2 功能作用

3.3.2.1 基本功能

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
# @author: kun
from PyQt5.Qt import *
import sys

app = QApplication(sys.argv)
w = QWidget()
w.resize(500, 500)

qp = QProgressBar(w)  # 建立物件
qp.setMaximum(100)
qp.setMinimum(0)
# qp.setRange(0, 100)  # 設定取值範圍，最大值和最小值，當最大值和最小值相等時，處於繁忙狀態
qp.setValue(20)  # 設定當前的值
# qp.reset()  # 重置進度條
print(qp.value())  # 獲取當前進度條的值

# 設定進度條的方向
# pq.setOrientation(Qt.Orientation)

# 倒立外觀
# pq.setInvertedAppearance(bool)

w.show()
sys.exit(app.exec_())

3.3.2.2 格式設定

setFormat(str)  # %p 為百分比；%v 為當前值；%m 為總值
# 如 setFormat("已下載%p %")
resetFormat()  # 重置格式設定
setAlignment(Union[Qt.Alignment, Qt.AliginmentFlag])  # 格式化字元對齊方式

3.3.2.3 文字操作

setTextVisible(bool)  # 標籤是否可見
text()  # 獲取標籤文字內容
setTextDirection(QProcessBar.Direction)  # 控制文字的排列方向

3.3.3 訊號

valueChanged(int)

3.4 QErrorMessaage

3.4.1 描述

錯誤訊息小部件由文字標籤和核取方塊組成；該核取方塊允許使用者控制將來是否再次顯示相同的錯誤訊息

繼承自QDialog

3.4.2 功能作用

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
# @author: kun
from PyQt5.Qt import *
import sys

app = QApplication(sys.argv)
w = QWidget()
w.resize(500, 500)

qb = QErrorMessage(w)  # 建立物件
qb.setWindowTitle("錯誤提示")  # 修改視窗標題
qb.showMessage("你確定要繼續操作嗎？")  # 如果設定多個，會一次一次展示出來
qb.exec()  # 展示對話方塊

QErrorMessage.qtHandler()  # 通過靜態方法，展示級別資訊，使用此放你發後，後溪所有的返回均會使用對話方塊顯示
qDebug("xxx")  # 除錯資訊
qWarning("eee")  # 警告資訊

w.show()
sys.exit(app.exec_())

3.4.3 訊號

繼承父類

3.5 QProgressDialog

3.5.1 描述

提供一個緩慢的操作進度反饋，進度對話方塊用於向使用者指示操作符花費多長時間，並演示應用程式尚未凍結；它還可以為使用者提供中止操作的機會

繼承自 QDialog

3.5.2 功能作用

3.5.2.1 基礎

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
# @author: kun
from PyQt5.Qt import *
import sys

app = QApplication(sys.argv)
w = QWidget()
w.resize(500, 500)

qpd = QProgressDialog("進度條", "確定", 0, 100, w)  # 0 為進度條的最小值

# 自動選擇
qpd.setAutoClose(False)  # 設定對話方塊完成後是否關閉
qpd.setAutoReset(False)  # 進度條滿後是否重置資訊

# 彈出：最小展示時長——展示之前的等待時間：如果在等待時間內，進度條滿了，就不會彈出；否則彈出
# qpd.setMinimumDuration(int)  # 預設為 4 秒
# 或者直接使用 open(func_) 彈出

w.show()
sys.exit(app.exec_())

3.5.2.2 介面內容編輯

# 對話方塊標題
setWindowTitle(str)

# 標籤文字
setLabelText(str)

# 取消按鈕文字
setCancelButtonText(str)

# 子控制元件設定
setBar(QProgressBar)
setCancelButton(QPushButton)
setLabel(QLabel)

3.5.2.3 資料處理

# 最大值和最小值
setMinimum(int)
setMaximum(int)
setRange(int min, int max)

# 設定當前的進度
setValue(int) 

# 是否取消
cancel()  # 取消進度條
wasCanceled()

3.5.3 訊號

canceled()

3.6 QMessageBox

3.6.1 描述

用於通知使用者或請求使用者的提問和接收應答的一個模態視窗；無論其展示方式是什麼，都為模態視窗

對話方塊的構成：