以下是 pyside6 中更多命名空间及其枚举值的详细说明,按照首字母排序并补充完整,涵盖 qt 框架的核心功能。所有说明均基于 pyside6 6.4+ 版本,确保参数类型和作用的准确性。
a
alignment
作用:控制控件或文本的对齐方式,支持水平和垂直组合。
枚举值:
qt.alignleft:左对齐qt.alignright:右对齐qt.aligntop:顶部对齐qt.alignbottom:底部对齐qt.alignhcenter:水平居中qt.alignvcenter:垂直居中qt.aligncenter:水平 + 垂直居中qt.alignbaseline:与文本基线对齐(常用于文本混排)
示例:
label.setalignment(qt.alignright | qt.alignvcenter) # 右对齐且垂直居中
b
brushstyle
作用:定义画刷(填充图形)的样式。
枚举值:
qt.nobrush:无填充qt.solidpattern:纯色填充qt.dense1pattern~qt.dense7pattern:密度递增的交叉线填充qt.horpattern:水平线填充qt.verpattern:垂直线填充qt.crosspattern:网格线填充
示例:
painter.setbrush(qt.dense4pattern) # 设置画刷为中等密度交叉线
c
cursormovestyle
作用:控制文本光标的移动逻辑。
枚举值:
qt.logicalmovestyle:按文本逻辑顺序移动(如从左到右文本中,左箭头向左移动)qt.visualmovestyle:按视觉位置移动(适用于从右到左语言)
示例:
text_edit.setcursormovestyle(qt.visualmovestyle) # 光标按视觉位置移动
cursorshape
作用:定义鼠标光标的形状。
枚举值:
qt.arrowcursor:默认箭头qt.ibeamcursor:文本输入光标qt.waitcursor:等待(沙漏/旋转圆圈)qt.crosscursor:十字准星qt.sizeallcursor:移动光标(四个方向箭头)qt.pointinghandcursor:手型指针
示例:
button.setcursor(qt.pointinghandcursor) # 鼠标悬停时显示手型指针
d
dialog
作用:窗口类型标识,表示对话框(通常无最大化/最小化按钮)。
示例:
dialog.setwindowflags(qt.dialog) # 设置为对话框类型
f
focuspolicy
作用:控制控件如何接收键盘焦点。
枚举值:
qt.nofocus:不接受焦点qt.tabfocus:通过 tab 键获取焦点qt.clickfocus:通过鼠标点击获取焦点qt.strongfocus:支持 tab 键和鼠标点击qt.wheelfocus:在 strongfocus 基础上,支持鼠标滚轮事件
示例:
line_edit.setfocuspolicy(qt.strongfocus) # 允许 tab 和点击获取焦点
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() # 按下回车键时提交表单
l
layoutdirection
作用:控制布局和文本方向。
枚举值:
qt.lefttoright:从左到右布局(默认)qt.righttoleft:从右到左布局(适用于阿拉伯语等)qt.layoutdirectionauto:根据系统语言自动选择
示例:
app.setlayoutdirection(qt.righttoleft) # 全局从右到左布局
o
orientation
作用:定义方向(水平或垂直)。
枚举值:
qt.horizontal:水平方向qt.vertical:垂直方向
示例:
slider = qslider(qt.horizontal) # 创建水平滑动条
p
penstyle
作用:定义画笔(线条)的样式。
枚举值:
qt.nopen:无线条qt.solidline:实线qt.dashline:虚线qt.dotline:点线qt.dashdotline:点划线
示例:
painter.setpen(qt.dashdotline) # 设置画笔为点划线
s
scrollbarpolicy
作用:控制滚动条的显示策略。
枚举值:
qt.scrollbarasneeded:按需显示qt.scrollbaralwaysoff:始终隐藏qt.scrollbaralwayson:始终显示
示例:
scroll_area.setverticalscrollbarpolicy(qt.scrollbaralwayson) # 强制显示垂直滚动条
t
textelidemode
作用:定义文本过长时省略号的位置。
枚举值:
qt.elideleft:左侧显示省略号qt.elideright:右侧显示省略号qt.elidemiddle:中间显示省略号qt.elidenone:不显示省略号
示例:
label.setelidemode(qt.elidemiddle) # 长文本中间显示省略号
textformat
作用:定义文本解析格式。
枚举值:
qt.plaintext:纯文本qt.richtext:富文本(html)qt.markdowntext:markdown 格式qt.autotext:自动检测格式
示例:
label.settextformat(qt.markdowntext) # 解析文本为 markdown
w
windowstate
作用:定义窗口的显示状态。
枚举值:
qt.windownostate:正常状态qt.windowminimized:最小化qt.windowmaximized:最大化qt.windowfullscreen:全屏qt.windowactive:窗口处于活动状态
示例:
window.setwindowstate(qt.windowfullscreen) # 全屏显示窗口
windowtype
作用:定义窗口的类型和特性。
枚举值:
qt.widget:默认窗口类型qt.window:独立窗口qt.dialog:对话框窗口qt.popup:弹出窗口(无边框)qt.tooltip:工具提示窗口qt.splashscreen:启动闪屏
示例:
self.setwindowflags(qt.popup) # 设置为弹出式窗口
其他命名空间
itemdatarole(用于模型/视图架构)
作用:定义数据项(如列表项、表格项)的角色。
枚举值:
qt.displayrole:显示文本qt.decorationrole:图标或装饰qt.editrole:可编辑数据qt.tooltiprole:悬停提示
示例:
model.setdata(index, "hello", qt.displayrole) # 设置列表项的显示文本
总结
pyside6 的命名空间通过逻辑分类和清晰的枚举值设计,极大提高了代码可读性和维护性。开发者应熟悉以下核心原则:
- 按需导入:仅导入需要的命名空间(如
from pyside6.qtcore import qt)。 - 组合使用:枚举值可通过
|运算符组合(如qt.alignleft | qt.aligntop)。 - 类型安全:避免直接使用整数值,始终使用命名空间中的枚举。
通过合理利用这些命名空间,可以编写出高效、跨平台且易于维护的 pyside6 应用程序。
到此这篇关于pyside6 命名空间的使用小结的文章就介绍到这了,更多相关pyside6 命名空间内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论