PyQt5常用控件

控件命名规范

控件名称	说明	控件名称	说明
Layouts ---- 布局管理
VerticalLayout	垂直布局	HorizontalLayout	水平布局
GridLayout	网络布局	FormLayout	表单布局
Spacer---- 弹簧
HorizontalSpacer	水平弹簧	VerticalSpacer	垂直弹簧
Buttons---- 按钮
PushButton	按钮	ToolBullton	工具按钮
RadionButton	单选按钮	CheckButton	复选框
CommandLinkButton	命令链接按钮	DialogButtonBox	对话框按钮
Item Views(Model-Based)---- 项目试图
ListView	列表视图	TreeView	树视图
TableView	表格视图	ColumnView	列视图
UndoView	撤销命令显示视图
Item Widgets(Item-Based)---- 项目控件
ListWidget	列表控件	TreeWidget	树控件
TableWidget	表格控件
Containers---- 容器
GroupBox	分组容器	ScrollArea	滚动区域
ToolBox	工具箱	TabWidget	选项卡
StackedWidget	堆栈窗口	Frame	帧
Widget	小部件	MDIArea	MDI区域
DockWidget	停靠窗口
Input Widget ---- 输入控件
ComboBox	下拉组合框	FontComboBox	字体组合框
LineEdit	单行文本框	TextEdit	多行文本框
PlainTextEdit	纯文本编辑框	SpinBox	数字选择控件
DoubleSpinBox	小数选择控件	TimeEdit	时间编辑框
DateEdit	日期编辑框	DateTimeEdit	日期时间编辑框
Dial	旋钮	HorizontalScrollBar	横向滚动条
VerticalScrollBar	垂直滚动条	HorizontalSlider	横向滑块
VerticalSlider	垂直滑块	KeySequenceEdit	按键编辑框
Display Widgets---- 显示控件
Label	标签控件	TextBrowser	文本浏览器
GraphicsView	图形视图	CalendarWidget	日期控件
LCDNumber	液晶数字显示	ProgressBar	进度条
HorizontalLine	水平线	VerticalLine	垂直线
OpenGLWidget	开放式图形库工具

设置标签文本的对齐方式

Horizontal

值	说明
AlignLeft	左对齐
AlignHCenter	水平居中
AlignRight	右对齐
AlignJustify	两端对齐

Vertical

值	说明
AlignTop	顶部对齐
AlignVCenter	垂直居中对齐
AlignBottom	底部对齐

使用代码设置Label标签的对齐方式，需要用到QLabel类的setAlignment()方法。

self.label.setAlignment(QtCore.Qt.AlignLeft|QtCore.Qt.AlignVCenter)

单行文本框

LineEdit是单行文本框，该控件只能输入单行字符串。
QLineEdit类的常用方法及说明

方法	说明
setText()	设置文本框内容
text()	获取文本框内容
setPlaceholderText()	设置文本框浮显文字
setMaxLength()	设置允许文本框输入字符串的最大长度
setAlignment()	设置文本对齐方式
setReadOnly()	设置文本框只读
setFocus()	使文本框得到焦点
setEchoMode()	设置文本框显示字符的模式： QLineEdit.Normal:正常显示输入的字符，默认 QLineEdit.NoEcho:不显示任何输入的字符 QLineEdit.Password:显示与平台相关的密码掩码字符 QLineEdit.PasswordEchoOnEdit：在编辑时显示密码，失去焦点时显示掩码
setValidator()	设置文本框验证器： QIntValidator:限制输入整数 QDoubleValidator:限制输入小数 QregExpValidator:检查输入是否符合设置的正则表达式
setInputMask()	设置掩码： 日期掩码:0000-00-00 时间掩码： 00:00:00 序列号掩码 >AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#
clear()	清除文本框内容

QLineEdit类常用的信号及说明

信号	说明
textChanged	当更改文本框种的内容时发射该信号
editingFinished	当文本框中的内容编辑结束时发射该信号，以按下Enter为编辑结束标志

多行文本框

QTextEdit类的常用方法及说明

方法	说明
setPlainText()	设置文本内容
toPlainText()	获取文本内容
setTextColor()	设置文本颜色，参数设置为QtGui.QColor(255,0,0)
setTextBackgroundColor()	设置文本的背景颜色，参数同setTextColor()
setHtml()	设置HTML文档内容
toHtml()	获取HTML文档内容
wordWrapMode()	设置自动换行
clear()	清除所有内容

SpinBox

QSpinBox类的常用方法及说明

方法	说明
setValue()	设置控件的当前值
setMaximum()	设置最大值
setMinimum()	设置最小值
setRange()	设置取值范围（包括最大值和最小值）
setSingleStep()	单击上下箭头时的步长值
value()	获取控件中的值

液晶数字显示控件

QLCDNumber类的常用方法及说明

方法	说明
setDigiCount()	设置可以显示的数字数量
setProperty()	设置
setMode()	设置显示数字的模式：Bin、Oct、Dec、Hex
setSegmentStyle()	设置显示样式：OutLine、Filled、Flat
value()	获取显示的数值

按钮

QPushButton类的常用方法及说明

方法	说明
setText()	设置按钮所显示的文本
text()	获取按钮所显示的文本
setIcon()	设置按钮上的图标
setIconSize()	设置按钮图标大小
setEnabled()	设置按钮是否可用
setShortcut()	设置按钮的快捷键

单选按钮

QRadioButton类的常用方法及说明

方法	说明
setText()	设置单选按钮显示文本
text()	获取单选按钮显示的文本
setChecked()或者setCheckable()	设置单选按钮是否为选中状态，True为选中
isChecked()	返回单选按钮的状态，True为选中

复选框

CheckBox控件的三种状态值及说明

方法	说明
QT.Checked	选中
QT.PartiallyChecked	半选中
QT.Unchecked	未选中

下拉组合框

QComboBox类的常用方法及说明

方法	说明
addItem()	添加一个下拉列表项
addItems()	从列表中添加下拉选项
currentText()	获取选中项的文本
currentIndex()	获取选中项的索引
itemText(index)	获取索引为index的项的文本
setItemText(index,text)	设置索引为index的项的文本
count()	获取所有选项的数量
clear()	删除所有选项

列表

QListWidget类的常用方法及说明

方法	说明
addItem()	向列表中添加项
addItems()	一次向列表中添加多项
insertItem()	在指定索引处插入项
setCurrentItem()	设置当前选择项
item.setToolTip()	设置提示内容
item.isSelected()	判断项是否选中
setSelectionMode()	设置列表的选择模式： QAbstractItemView.NoSelection:不能选择 QAbstractItemView.SingleSelection:单选 QAbstractItemView.MultiSelection:多选 QAbstractItemView.ExtendeSelection:正常单选，按Ctrl或Shift后可以多选 QAbstractItemView.ContiguousSelection:与ExtendeSelection类似
setSelectionBchavior()	设置选择项的方式： QAbstractItemView.SelectItems:选中当前项 QAbstractItemView.SelectRows:选中整行 QAbstractItemView.SelectColumns:选中整列
setWordWrap()	设置是否自动换行，True表示自动换行
setViewMode()	设置显示模式： QListView.ListMode:以列表形式显示 QListView.IconMode:以图表形式显示
item.text()	获取项的文本
clear()	删除所有列表项

选项卡

QTabWidget类的常用方法及说明

方法	说明
addTab()	添加选项卡
inserTab()	插入选项卡
removeTab()	删除选项卡
currentWidget()	获取当前选项卡
currentIndex()	获取当前选项卡的索引
setCurrentIndex()	设置当前选项卡的索引
setCurrentWidget()	设置当前选项卡
setTabPosition()	设置选项卡的标题位置： QTabWidget.North:标题在北方，即上方 QTabWidget.South:标题在南方，即下方 QTabWidget.West:标题在西方，即左边, QTabWidget.East:标题在东方，即右边
setTabsClosable()	设置是否可以独立关闭选项卡，True为可以
setTabText()	设置选项卡标题文本
tabText()	获取指定选项卡的标题文本

工具盒

QToolBox类的常用方法及说明

方法	说明
addItem()	添加选项卡
setCurrentIndex()	设置当前选中的选项卡索引
setItemIcon()	设置选项卡的图标
setItemText()	设置选项卡的标题文本
setItemEnabled()	设置选项卡是否可用
inserItem()	插入新的选项卡
removeItem()	移除选项卡
itemText()	获取选项卡的文本
currentIndex()	获取当前选项卡的索引

日期时间控件

QDateTimeEdit类的常用方法及说明

方法	说明
setTime()	设置时间，默认为：00:00:00
setMaximumTime()	设置最大时间，默认为23:59:59
setMinimumTime()	设置最小时间，默认为00:00:00
setTimeSpec()	获取显示时间标准： LocalTime:本地时间 UTC:世界标准时间 OffsetFromUTC:与UTC等效的时间 TimeZone:时区
setDateTime()	设置日期时间，默认为2000/1/1 00:00:00
setDate()	设置日期，默认为2000/1/1
setMaximumDate()	设置最大日期，默认为9999/12/31
setMinimumDate()	设置最小日期，默认为1752/9/4
setDisplayFormat()	设置日期、时间格式： yyyy/MM/dd、yyyy/M/d、yy/MM/dd、yy/M/d、yy/MM和Mm/dd HH:mm:ss、HH:mm、mm:ss、H:m和m:s
date()	获取显示的日期，返回值为QDate类型，如QDate(2000,1,1)
time()	获取显示时间，返回值为QTime类型，如QTime(0,0)
dataTime()	获取显示的日期时间，返回值为QDateTime类型，如QDateTime(2000,1,1,0,0)

QDateTimeEdit类的常用方法及说明

信号	说明
timeChanged	时间发生改变时发射
dateChanged	日期发生改变时发射
dataTimeChanged	日期或时间发射改变时发射