以下是 PySide6 中更多命名空間及其枚舉值的詳細(xì)說明，按照首字母排序并補(bǔ)充完整，涵蓋 Qt 框架的核心功能。所有說明均基于 PySide6 6.4+ 版本，確保參數(shù)類型和作用的準(zhǔn)確性。

A

Alignment

作用：控制控件或文本的對(duì)齊方式，支持水平和垂直組合。
枚舉值：

• Qt.AlignLeft：左對(duì)齊
• Qt.AlignRight：右對(duì)齊
• Qt.AlignTop：頂部對(duì)齊
• Qt.AlignBottom：底部對(duì)齊
• Qt.AlignHCenter：水平居中
• Qt.AlignVCenter：垂直居中
• Qt.AlignCenter：水平 + 垂直居中
• Qt.AlignBaseline：與文本基線對(duì)齊（常用于文本混排）

示例：

label.setAlignment(Qt.AlignRight | Qt.AlignVCenter)  # 右對(duì)齊且垂直居中

B

BrushStyle

作用：定義畫刷（填充圖形）的樣式。
枚舉值：

• Qt.NoBrush：無填充
• Qt.SolidPattern：純色填充
• Qt.Dense1Pattern ~ Qt.Dense7Pattern：密度遞增的交叉線填充
• Qt.HorPattern：水平線填充
• Qt.VerPattern：垂直線填充
• Qt.CrossPattern：網(wǎng)格線填充

示例：

painter.setBrush(Qt.Dense4Pattern)  # 設(shè)置畫刷為中等密度交叉線

C

CursorMoveStyle

作用：控制文本光標(biāo)的移動(dòng)邏輯。
枚舉值：

• Qt.LogicalMoveStyle：按文本邏輯順序移動(dòng)（如從左到右文本中，左箭頭向左移動(dòng)）
• Qt.VisualMoveStyle：按視覺位置移動(dòng)（適用于從右到左語言）

示例：

text_edit.setCursorMoveStyle(Qt.VisualMoveStyle)  # 光標(biāo)按視覺位置移動(dòng)

CursorShape

作用：定義鼠標(biāo)光標(biāo)的形狀。
枚舉值：

• Qt.ArrowCursor：默認(rèn)箭頭
• Qt.IBeamCursor：文本輸入光標(biāo)
• Qt.WaitCursor：等待（沙漏/旋轉(zhuǎn)圓圈）
• Qt.CrossCursor：十字準(zhǔn)星
• Qt.SizeAllCursor：移動(dòng)光標(biāo)（四個(gè)方向箭頭）
• Qt.PointingHandCursor：手型指針

示例：

button.setCursor(Qt.PointingHandCursor)  # 鼠標(biāo)懸停時(shí)顯示手型指針

D

Dialog

作用：窗口類型標(biāo)識(shí)，表示對(duì)話框（通常無最大化/最小化按鈕）。
示例：

dialog.setWindowFlags(Qt.Dialog)  # 設(shè)置為對(duì)話框類型

F

FocusPolicy

作用：控制控件如何接收鍵盤焦點(diǎn)。
枚舉值：

• Qt.NoFocus：不接受焦點(diǎn)
• Qt.TabFocus：通過 Tab 鍵獲取焦點(diǎn)
• Qt.ClickFocus：通過鼠標(biāo)點(diǎn)擊獲取焦點(diǎn)
• Qt.StrongFocus：支持 Tab 鍵和鼠標(biāo)點(diǎn)擊
• Qt.WheelFocus：在 StrongFocus 基礎(chǔ)上，支持鼠標(biāo)滾輪事件

示例：

line_edit.setFocusPolicy(Qt.StrongFocus)  # 允許 Tab 和點(diǎn)擊獲取焦點(diǎn)

K

Key

作用：定義鍵盤按鍵的枚舉值（如處理鍵盤事件）。
枚舉值：

• Qt.Key_Escape：Esc 鍵
• Qt.Key_Enter：回車鍵
• Qt.Key_Space：空格鍵
• Qt.Key_A ~ Qt.Key_Z：字母鍵
• Qt.Key_Up / Qt.Key_Down：上下方向鍵

示例：

def keyPressEvent(self, event):
    if event.key() == Qt.Key_Enter:
        self.submit_form()  # 按下回車鍵時(shí)提交表單

L

LayoutDirection

作用：控制布局和文本方向。
枚舉值：

• Qt.LeftToRight：從左到右布局（默認(rèn)）
• Qt.RightToLeft：從右到左布局（適用于阿拉伯語等）
• Qt.LayoutDirectionAuto：根據(jù)系統(tǒng)語言自動(dòng)選擇

示例：

app.setLayoutDirection(Qt.RightToLeft)  # 全局從右到左布局

O

Orientation

作用：定義方向（水平或垂直）。
枚舉值：

• Qt.Horizontal：水平方向
• Qt.Vertical：垂直方向

示例：

slider = QSlider(Qt.Horizontal)  # 創(chuàng)建水平滑動(dòng)條

P

PenStyle

作用：定義畫筆（線條）的樣式。
枚舉值：

• Qt.NoPen：無線條
• Qt.SolidLine：實(shí)線
• Qt.DashLine：虛線
• Qt.DotLine：點(diǎn)線
• Qt.DashDotLine：點(diǎn)劃線

示例：

painter.setPen(Qt.DashDotLine)  # 設(shè)置畫筆為點(diǎn)劃線

S

ScrollBarPolicy

作用：控制滾動(dòng)條的顯示策略。
枚舉值：

• Qt.ScrollBarAsNeeded：按需顯示
• Qt.ScrollBarAlwaysOff：始終隱藏
• Qt.ScrollBarAlwaysOn：始終顯示

示例：

scroll_area.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOn)  # 強(qiáng)制顯示垂直滾動(dòng)條

T

TextElideMode

作用：定義文本過長時(shí)省略號(hào)的位置。
枚舉值：

• Qt.ElideLeft：左側(cè)顯示省略號(hào)
• Qt.ElideRight：右側(cè)顯示省略號(hào)
• Qt.ElideMiddle：中間顯示省略號(hào)
• Qt.ElideNone：不顯示省略號(hào)

示例：

label.setElideMode(Qt.ElideMiddle)  # 長文本中間顯示省略號(hào)

TextFormat

作用：定義文本解析格式。
枚舉值：

• Qt.PlainText：純文本
• Qt.RichText：富文本（HTML）
• Qt.MarkdownText：Markdown 格式
• Qt.AutoText：自動(dòng)檢測(cè)格式

示例：

label.setTextFormat(Qt.MarkdownText)  # 解析文本為 Markdown

W

WindowState

作用：定義窗口的顯示狀態(tài)。
枚舉值：

• Qt.WindowNoState：正常狀態(tài)
• Qt.WindowMinimized：最小化
• Qt.WindowMaximized：最大化
• Qt.WindowFullScreen：全屏
• Qt.WindowActive：窗口處于活動(dòng)狀態(tài)

示例：

window.setWindowState(Qt.WindowFullScreen)  # 全屏顯示窗口

WindowType

作用：定義窗口的類型和特性。
枚舉值：

• Qt.Widget：默認(rèn)窗口類型
• Qt.Window：獨(dú)立窗口
• Qt.Dialog：對(duì)話框窗口
• Qt.Popup：彈出窗口（無邊框）
• Qt.ToolTip：工具提示窗口
• Qt.SplashScreen：?jiǎn)?dòng)閃屏

示例：

self.setWindowFlags(Qt.Popup)  # 設(shè)置為彈出式窗口

其他命名空間

ItemDataRole（用于模型/視圖架構(gòu)）

作用：定義數(shù)據(jù)項(xiàng)（如列表項(xiàng)、表格項(xiàng)）的角色。
枚舉值：

• Qt.DisplayRole：顯示文本
• Qt.DecorationRole：圖標(biāo)或裝飾
• Qt.EditRole：可編輯數(shù)據(jù)
• Qt.ToolTipRole：懸停提示

示例：

model.setData(index, "Hello", Qt.DisplayRole)  # 設(shè)置列表項(xiàng)的顯示文本

總結(jié)

PySide6 的命名空間通過邏輯分類和清晰的枚舉值設(shè)計(jì)，極大提高了代碼可讀性和維護(hù)性。開發(fā)者應(yīng)熟悉以下核心原則：

1. 按需導(dǎo)入：僅導(dǎo)入需要的命名空間（如 from PySide6.QtCore import Qt）。
2. 組合使用：枚舉值可通過 | 運(yùn)算符組合（如 Qt.AlignLeft | Qt.AlignTop）。
3. 類型安全：避免直接使用整數(shù)值，始終使用命名空間中的枚舉。

通過合理利用這些命名空間，可以編寫出高效、跨平臺(tái)且易于維護(hù)的 PySide6 應(yīng)用程序。

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

最新評(píng)論