第15.48节、PyQt显示部件:TextBrowser、CalendarWidget、LCDNumber、ProgressBar、Label和Horizontal/VerticaLine简介
一、概述
在Designer中,显示部件有Label、Text Browser、Calendar Widget、LCD Number、Progress Bar、Horizontal Line和Vertical Line、graphics View、OpenGL Widget。在前两章节已经将最复杂的graphics View、OpenGL Widget进行了介绍,本部分将剩余的显示部件进行一个简单介绍,重点介绍一些特色功能,普通的属性、方法和信号就不介绍了,请大家参考官方文档。
二、Label标签功能简介
Label标签对应类为QLabel,在整个PyQt界面设计中使用非常多,有几个功能需要在此重点说明一下:
- QLabel不但能显示文本,而且能显示图片和视频以及富文本,但需要注意,显示富文本时必须是标准HTML4的富文本才能识别,并且建议是短的文本,且不能有不能识别的标记内容,如果有哪怕是textFormat设置为富文本也会导致所有文本内容都不能识别,就将整个html原文完整展示;
- 关注一下buddy属性,这个是可以将QLabel和一个其他可以操作的部件进行关联,用户通过输入ALT+QLabel的文档由与符号(&)指定的快捷键就会自动将焦点跳转到关联部件;
- 关注一下textInteractionFlags属性,这个属性可以指定对QLabel中文本的操作响应方式;
- html富文本中的链接点击或鼠标悬停上会触发信号linkActivated、linkHovered。
三、TextBrowser富文本浏览窗
TextBrowser显示部件对应类为 QTextBrowser,可以理解为是一个HTML浏览器部件,QTextBrowser是 QTextEdit的子类,是一种增加了导航功能的QTextEdit的只读模式。
如下几个功能在此重点说一下:
- 除了使用QTextEdit的文本操作功能外,还可以通过source属性来指定文本来源一个文件,文件的路径由searchPaths和当前路径来决定;
- 对文本中超链可以控制是否可以直接用鼠标和键盘点击打开;
- 对于非文件和qrc资源的内容可以控制是否作为外部链接调用web浏览器打开;
- 有几个类似浏览器导航的操作触发的信号,包括:anchorClicked、backwardAvailable、forwardAvailable、highlighted、historyChanged、sourceChanged;
- 有几个导航历史数据的访问方法,包括:backwardHistoryCount、clearHistory、forwardHistoryCount、historyTitle、historyUrl。
四、Calendar Widget
Calendar Widget部件是一个以月为视图来选择日期的部件,并且默认选中当前日期,可以访问当前展示月的年和月,对应类为QCalendarWidget。
在此说明几点:
- 日历的很多外观可以设置,如实现显示星期以及怎么显示,第一列日期从哪个星期日期开始、是否显示每行日期在当年内的周序(取值为:1-53)、周末是否红色标记、年月是否有快速选择栏、是否显示网格等
- 获取日期数据时可以通过dateTextFormat、weekdayTextFormat属性设置日期数据的格式
- 可以通过翻页信号currentPageChanged获取当前显示的年和月
五、LCD Number
LCD Number部件是个类似数字液晶显示器的部件,功能就是显示数字相关内容,使用非常方便和简单,具体功能请参考官方文档。在此有二点说明如下:
- 显示的字符支持0/O、1、2、3、4、5/S、6、7、8、9/g、减号、小数点、A、B、C、D、E、F、h、h、L、O、P、r、u、u、Y、冒号、度数°(在代码中字符串指定其为单引号)和空格。其他字符都不支持,如果某个字母的大小写中只支持一种,要显示字母大小写都会转换成可以支持的大小写形式的相同字母,如R会转成r,a会转成A,其他无法支持的字符QLCDNumber用空格替换
注:上面用反斜杠分隔的字符在展示时是一样的,如展示时5和S实际上都展示的5 - 显示的字符无法通过value属性获取,value只能获取对应的数字值,如果要获取对应显示的字符串,可以通过重写display()槽方法来实现。
六、Progress Bar
Progress Bar进度条部件可以用于给用户提示操作处理的进度,可以设置最大值和最小值以及当前值,具体功能请参考官方文档。在此只有一点需要说明:
- 如果最大值和最小值设置为0,则进度条的进度指示循环移动表示一种忙的状态
七、Horizontal Line和Vertical Line
Horizontal Line和Vertical Line用于在界面上显示一条横线或竖线,实际上这两个部件对应的类就是QFrame(请参考《第15.36节 PyQt(Python+Qt)入门学习:containers容器类部件QFrame框架部件介绍》),只是将QFrame的frameShape属性固定为VLine或HLine。因此在此就不再介绍了。