pyside中的显示组件
qingheluo2024-11-12清河洛290
在Qt的用于渲染显示的相关组件中,有显示组件和框架组件两种显示组件是用于不同信息渲染显示的组件框架组件是将若干组件组合起来以特殊形式显示的组件显示组件QLabel,文本或图像显示QLabel([text,]parent=None)
margin()、setMargin(int) 外边距(像素),默认为0
clear() 清除所有内容
文本相关
indent()、setIndent(int) 文本缩进(像素),默认为-1
wordWrap()、setWordWrap(bool)是否自动换行,默认False
alignment()、setAlignment() 文本对齐
...
在Qt的用于渲染显示的相关组件中,有显示组件和框架组件两种
显示组件是用于不同信息渲染显示的组件
框架组件是将若干组件组合起来以特殊形式显示的组件
显示组件
QLabel,文本或图像显示
QLabel([text,]parent=None)
margin()、setMargin(int) 外边距(像素),默认为0
clear() 清除所有内容
文本相关
indent()、setIndent(int) 文本缩进(像素),默认为-1
wordWrap()、setWordWrap(bool)是否自动换行,默认False
alignment()、setAlignment() 文本对齐
水平方向:Qt.AlignLeft、Qt.AlignRight、Qt.AlignHCenter、Qt.AlignJustify
垂直方向:Qt.AlignTop、Qt.AlignBottom、Qt.AlignVCenter、Qt.AlignBaseline
Qt.AlignCenter 水平和垂直都居中
默认为 Qt.AlignLeft|Qt.AlignVCenter
textInteractionFlags()、setTextInteractionFlags() 文本交互方式
Qt.NoTextInteraction 无法交互
Qt.TextSelectableByMouse 可用鼠标选择文本
Qt.TextSelectableByKeyboard 可使用键盘上的光标键选择文本,按住shift并使用左右键移动光标
Qt.LinksAccessibleByMouse 可使用鼠标突出显示和激活链接
Qt.LinksAccessibleByKeyboard 可使用Tab键聚焦链接,并使用Enter键激活链接
Qt.TextEditable 文本可编辑,需要配合鼠标选择或键盘选择使用
Qt.TextEditorInteraction 文本编辑器的默认值
Qt.TextBrowserInteraction QTextBrowser的默认值
openExternalLinks()、setOpenExternalLinks(bool)
是否自动打开链接,而不是发出 linkActivated()信号,默认False
text()、setText(str) 显示的文本
setNum(int|float) 以纯文本的形式显示数字
hasSelectedText() 是否选择了任何文本
selectedText() 选择的文本str
setSelection(start_index,length) 选择从指定索引开始的指定长度的文本
selectionStart() 选中文本中第一个字符的索引,未选中文本返回-1
图片相关
pixmap()、setPixmap(QPixmap) 显示像素图片
QtGui.QPixmap(fileName)
hasScaledContents()、setScaledContents(bool)
是否自动缩放以填充所有可用空间,默认False
其他显示
picture()、setPicture(QPicture) 显示矢量图片
QtGui.QPicture().load(fileName)
movie()、setMovie(QMovie) 显示的视频资源
QtGui.QMovie(fileName)
信号相关
linkHovered(link) 鼠标悬停在链接文本时,传递str格式的地址
linkActivated(link) 点击链接文本时
QLCDNumber,LCD格式显示数字
以方块形状来显示数字,类似于电子手表
QLCDNumber([numDigits,] parent=None)
numDigits指定数字位数
mode()、setMode() 显示指定的进制,值为常量
Hex 十六进制 Dec 十进制(默认)
Oct 八进制 Bin 二进制
还提供了一些便捷的方法,后台调用该函数
setHexMode()、setDecMode()、setOctMode()、setBinMode()
segmentStyle()、setSegmentStyle() 显示的外观,值为常量
Outline 填充背景色的凸起
Filled 填充前景色的凸起(默认)
Flat 填充有前景色的平面
digitCount()、setDigitCount(int) 数字位数,默认5
smallDecimalPoint()、setSmallDecimalPoint(bool)
小数点是否占据数字位,默认False
checkOverflow(num) 当前设置是否可以完整显示指定数字
value()、display(num|str) 显示的值,可以为str
intValue() 显示数字四舍五入后的int
信号相关
overflow() 数字或字符串长度超过最大数字位时
框架组件
QGroupBox,带有标题框架
QGroupBox([title,parent=None])
isFlat()、setFlat(bool) 框架整体是否仅渲染顶部边框,默认False
alignment()、setAlignment() 框架组标题的位置
水平方向:Qt.AlignLeft、Qt.AlignRight、Qt.AlignHCenter、Qt.AlignJustify
垂直方向:Qt.AlignTop、Qt.AlignBottom、Qt.AlignVCenter、Qt.AlignBaseline
默认为 Qt.AlignLeft|Qt.AlignTop
title()、setTitle(str) 标题
isCheckable()、setCheckable(bool) 标题是否设为复选框,默认False
为True,选中此复选框则启用组框的子项,否则,子项将被禁用
isChecked()、setChecked(bool) 标题是否选中
信号相关
clicked(bool) 点击复选框标题时
toggled(bool) 标题选中状态改变时
QProgressBar,进度条
用于向用户展示某个操作的进度
指定最小、最大值后,后续指定当前值时,将显示百分比
orientation()、setOrientation() 进度条的方向
Qt.Horizontal、Qt.Vertical
textDirection()、setTextDirection() 垂直进度条显示文本的旋转方向
TopToBottom 顺时针旋转90度
BottomToTop 逆时针旋转90度
invertedAppearance()、setInvertedAppearance(bool)
是否反转进度条的两端
isTextVisible()、setTextVisible(bool)
是否显示进度文本,默认True
alignment()、setAlignment() 进度文本的位置
format()、setFormat(str) 进度文本格式
%p 百分比数字(不含百分号%)
%v 当前值 %m 最大值
默认为"%p%"
textVisible() 当前显示的进度文本
resetFormat() 重置进度文本格式
value()、setValue(int) 当前进度值
text() 当前进度的百分比值
reset() 重置进度条
minimum()、setMinimum(int)
maximum()、setMaximum(int)
setRange(min, max)
最小和最大值都设置为 0,会显示一个表示忙碌信息的进度条而不是百分比
信号相关
valueChanged(int)
QStackedWidget,堆叠显示
堆叠显示是在放置多个组件的框架组件中同时仅能显示一个组件,该显示的组件会覆盖其他所有组件的显示
QStackedWidget(parent=None)
count() 堆叠框架中包含的组件总数量
增
insertWidget(index, w) 在指定索引位添加组件,返回w的索引
index超出最大子组件时,添加至末尾
addWidget(w) 将组件w添加至框架中,返回w的索引
添加组件时如果引起了当先显示组件索引的改变,当前显示组件不变,索引会改变
删
removeWidget(w) 删除指定组件
改
currentIndex()、setCurrentIndex(int) 当前显示组件的索引
当框架中没有任何组件时返回-1
currentWidget()、setCurrentWidget(w) 当前显示的组件
当框架中没有任何组件时返回None
查
indexOf(w) 获取指定组件的索引,如果w不在框架中返回-1
widget(index) 获取指定索引的组件实例对象,不存在返回None
信号相关
currentChanged(index) 显示组件发生改变时
widgetRemoved(index) 删除组件时
QTabWidget,选项卡(标签)
在选项卡(标签)相关组件中,QTabBar组件仅负责选项卡的显示和管理,不处理显示的内容区域,需要程序员手动管理
QTabWidget是在QTabBar的基础上增加了内容区域的显示和管理,是一个完整的选项卡界面
QTabWidget(parent=None)
整体相关
tabPosition()、setTabPosition() 标签区域的位置,使用预定义常量
North 上方(默认) South 下方
West 左侧 East 右侧
isMovable()、setMovable(bool) 标签是否可以通过拖动改变位置
iconSize()、setIconSize(QSize) 标签中图标大小
tabBarAutoHide()、setTabBarAutoHide(False) 当标签数量仅有1个时是否隐藏
tabsClosable()、setTabsClosable(False) 标签中是否添加删除按钮
documentMode()、setDocumentMode(bool) 是否修改标签的样式
usesScrollButtons()、setUsesScrollButtons(bool)
标签过多时是否显示上下翻动按钮
elideMode()、setElideMode() 当标签文本过长时省略号的位置
Qt.ElideLeft 文本开头
Qt.ElideRight 文本末尾
Qt.ElideMiddle文本中间
Qt.ElideNone 不显示
tabShape()、setTabShape() 标签形状,Rounded(圆角,默认)、Triangular(三角)
单独相关
isTabEnabled(index),setTabEnabled(index, enabled) 标签启用状态
cornerWidget([pos]),setCornerWidget(widget[,pos])
标签指定位置的小组件(如关闭按钮、图标按钮等),pos为常量
Qt.TopLeftCorner、Qt.TopRightCorner(默认)、
Qt.BottomLeftCorner、Qt.BottomRightCorner
一个标签中最多仅可显示一个小组件
添加一个小组件后原有的小组件将被隐藏
将widget设为None将隐藏该选项上的小组件
当前信息
count() 标签总数量
currentIndex()、setCurrentIndex(index) 当前显示的标签索引
currentWidget()、setCurrentWidget(widget)当前显示内容
tabIcon(index)、setTabIcon(index, QIcon) 标签图标
tabText(index)、setTabText(index, text) 标签文本
tabToolTip(index)、setTabToolTip(index, str) 标签提示文本
indexOf(widget) 获取指定内容对应的标签的索引
操作相关
clear() 删除所有标签
isTabVisible(index),setTabVisible(index, bool) 标签显示状态
addTab(widget, [QIcon,] text) 添加新标签,返回索引
insertTab(index, widget, [QIcon,] text) 添加新标签,返回索引
removeTab(index) 删除指定标签
事件函数
tabInserted(index) 添加新标签时
tabRemoved(index) 删除标签时
信号相关
currentChanged(index) 显示标签改变时
tabBarClicked(index) 点击标签时
tabBarDoubleClicked(index)双击标签时
tabCloseRequested(index) 点击标签上的关闭按钮时
tabBar:通过实例对象的tabBar()方法可以获取该组件中标签QTabBar实例对象
QTabBar实例对象独有的常用方法及信号
drawBase()、setDrawBase(bool) 标签下方是否绘制与内容的分割线
expanding()、setExpanding(bool) 标签是否自动加宽以填满整个区域
selectionBehaviorOnRemove()、setSelectionBehaviorOnRemove()
删除已选中标签时新的选中标签选择策略
SelectLeftTab 选择删除标签左侧的标签
SelectRightTab 选择删除标签右侧的标签(默认)
SelectPreviousTab 选择之前选择的标签
moveTab(fromi, toi) 移动标签到指定索引位置
事件函数
tabLayoutChange() 标签排序改变时
信号相关
tabMoved(fromi, toi) 标签移动位置时
QSplashScreen,启动画面
QSplashScreen(pixmap=None)
pixmap()、setPixmap(QPixmap) 显示的像素图
showMessage(msg[, alignment=Qt.AlignLeft[, color=Qt.black]])
在启动画面上显示信息
message() str,初始屏幕上显示的消息
clearMessage() 删除初始屏幕上显示的消息
finish(w) 在组件w显示后调用自身close()
信号相关
messageChanged(msg) 初始屏幕上的消息发生变化时