Qt控件精讲五：输入组件

Qt Creator有15种Input Widgets，如下图：

Input Widgets的Qt类和名称介绍如下表

控件类	控件名	中文名	控件类	控件名	中文名
QComboBox	ComboBox	不可编辑组合框	QDateEdit	DateEdit	日期编辑框
QFontComboBox	FontComboBox	可编辑组合框	QDateTimeEdit	Date/TimeEdit	日期时间编辑框
QLineEdit	LineEdit	行编辑	QDial	Dial	表盘
QTextEdit	TextEdit	文本编辑	QScrollBar	Horizontal ScrollBar	水平滚动条
QPlainTextEdit	PlainTextEdit	无格式的文本编辑	QScrollBar	Vertical ScrollBar	垂直滚动条
QSpinBox	SpinBox	整数旋转框	QSlider	Horizontal Slider	水平滑动条
QDoubleSpinBox	DoubleSpinBox	小数旋转框	QSlider	Vertical Slider	垂直滑动条
QTimeEdit	TimeEdit	时间编辑框

一、ComboBox控件

1.控件位置：Input Widgets->ComboBox

2.控件介绍：略

3.控件属性设置选项

（1）name：该控件对应源代码中的名称

（2）font：设置显示的字体

（3）editable：用来获取或设置一个值，以确定ComboBox的编辑框是否可编辑，值为true是为可编辑，值为false时只读

（4）currentIndex：当前选项的索引

（5）maxVisibleItems：ComboBox可见的最大项目数

（6）maxCount：ComboBox的最大项目数

4.常用成员函数：

（1）QComboBox：：QComboBox（QWidget *parent = 0，const char *name = 0）

构造一个名称为name，父对象为parent的ComboBox

（2）QComboBox：：QComboBox（bool rw，QWidget *parent = 0，const char * name = 0）

构造一个名称为name，父对象为parent的ComboBox，如果rw是true，则编辑栏可编辑，否则只能选择ComboBox项目之一

（3）void QComboBox：：clear（）const

删除ComboBox中的所有项目

（4）int QComboBox：：count（）const

返回ComboBox中的项目数

（5）int QComboBox：：currentItem（）const

返回ComboBox中当前项目的索引

（6）QString QComboBox：：currentText（）const

返回组合框的当前项目文本

（7）void QComboBox：：insertItem（const QString &t，int index = -1）

在索引index处插入一个文本为t的项目，如果index是负数，该项目将被追加到末尾

（8）void QComboBox；：insertItem（const QPixmap &pixmap，int index = -1）

在索引index处插入一个图标为pixmap的项目，如果index为负数，该项目将被追加到末尾

（9）void QComboBox：：insertItem（const QPixmap &pixmap，const QString &text，int index = -1）

在索引index处，插入一个文本为text和图标为pixmap的项目，如果index为负数，该项目将被追加到末尾

（10）QString QComboBox：：currentText（）const

返回组合框当前项目文本

（11）void QComboBox：：removeItem（int index）

删除索引为index处项目

（12）void QComboBox：：setCurrentItem（int index）[virtual]

把索引index处的项目设为当前项目

二、Font ComboBox控件

1.控件位置：Input Widgets->Font ComboBox

2.控件介绍：字体组合框继承于QComboBox类，Font ComboBox组合框分为两部分显示：顶部是一个允许输入文本的文本框，下面的列表框则显示列表项，Font ConboBox就是文本框与列表框的组合，但是不能选择多项，只能选择其中一项，专门用于字体选择

3.控件属性设置选项

（1）name：同上

（2）font：同上

（3）editable：用来获取或设置一个值，以确定ComboBox的编辑框是否可编辑，值为true时为可编辑，值为false时为只读

（4）currentIndex：当前选项的索引

（5）currentFont：当前字体

（6）maxVisibleItems：ComboBox可见的最大项目数

（7）maxCOunt：ComboBox的最大项目数

4.常用成员函数

（1）QFontComboBox：：QFontComboBox（QWidget *parent = 0）

构造一个父对象为parent的Font ComboBox

三、LineEdit控件

1.控件位置：Input Widgets->LineEdit

2.控件介绍：行编辑是一种常用且比较容易掌握的控件，应用程序主要用它来接收输入文字信息。

3.控件属性设置选项

（1）name：同上

（2）text：同上

（3）font：同上

（4）ReadOnly：用来获取或设置一个值，该值指示文本框中的文本是否为只读，值为true时为只读，值为false为可读写

4.常用成员函数

（1）QLineEidt：：QLineEdit（QWidget *parent，const char *name = 0）

构造一个名称为name，父对象为parent的LineEdit

（2）QLineEdit：：QLineEdit（const QString &contents,QWidget *parent，const char *name = 0）

构造一个名称为name，父对象为parent和内容为contents的LineEdit

（3）void QLineEdit：：clear（）[virtual slot]

清除行编辑的内容

（4）bool QLineEdit：：isReadOnly（）const

如果行编辑室只读则返回true，否则返回false

（5）void QLineEdit：：setReadOnly（bool）[virtual slot]

设置行编辑的读写属性

（6）void QLineEdit：：setText（const QString &）[virtual slot]

设置行编辑的文本

（7）QString QLineEdit：：text（）const

返回行编辑的文本

四、TextEdit控件

1.控件位置：Input Widgets->TextEdit

2.控件介绍：文本编辑控件主要用它输入文本信息或显示文本信息，TextEdit的属性和成员函数与LineEdit基本相同。

五、PlainTextEdit控件

1.控件位置：Input Widgets->PlainTextEdit

2.控件介绍：PlainTextEdit控件中文称作“文本编辑“，PlainTextEdit和TextEdit控件只是样式不同，可以通过设置属性来改变样式

3.常用成员函数

（1）QPlainTextEdit：：QPlainTextEdit（QWidget *parent = 0）

（2）QPlainTextEdit：：QPlainTextEdit（const QString &text，QWidget *parent = 0）

六、SpinBox控件

1.控件位置：Input Widgets->SpinBox

2.控件介绍：整数旋转框允许用户通过单击向上/向下按钮来增加/减少当前显示的值，也可以直接输入旋转框的值，如果该值是直接输入选择框，一般需要按Enter键确认新值。有的版本不需要，该值通常是一个整数。

3.控件属性设置选项

（1）name：同上

（2）font：同上

（3）value：SpinBox默认值

（4）lineStep；使用箭头来改变选择框的值的递增/递减量

（5）minValue：SpinBox的最小值

（6）maxValue：SpinBox的最大值

（7）prefix：SpinBox的前缀字符串

（8）Suffix：SpinBox的后缀字符串

4.常用成员函数

（1）QSpinBox：：QSpinBox（QWidget *parent = 0，const char *name = 0）

构造一个名称为name，父对象为parent的SpinBox

（2）QSpinBox：：QSpinBox（int intValue，int maxValue，int step = 1，QWidget *parent = 0，const char *name = 0）

构造一个名称为name，父对象为parent，最小值为minValue，最大值为maxValue和增/减量为step的SpinBox

（3）void QSpinBox：：stepDown（）[virtural slot]

把旋转框的值减少一个lineStep，等同于单击向下按钮

（4）void QSpinBox：：stepUp（）[virtual slot]

把旋转框的值增加一个lineStep，等于单击向上按钮

（5）QString QSpinBox：：text（）const

返回旋转框的文本，包括前缀和后缀

（6）int QSpinBox：：value（）const

返回旋转框的值

（7）void QSpinBox：：setValue（int value）[virtual slot]

设置旋转框的值

（8）void QSpinBox：：setLineStep（int）

设置旋转框的增/减量

（9）void QSpinBox：：setMaxValue（int）

设置旋转框的最大值

（10）void QSpinBox：：setMinValue（int）

设置旋转框的最小值

（11）void QSpinBox：：setPrefix（const QString &text）[virtual slot]

设置旋转框的前缀字符

（12）void QSpinBox：：setSuffix（const QString &text）[virtual slot]

设置旋转框的后缀字符

七、Double SpinBox

1.控件位置：Input->Double SpinBox

2.控件介绍：小数旋转框，继承与QSpinBox，可以表示小数，其他与QSpinBox功能相同

3.控件属性设置选项

（1）name：同上

（2）font：同上

（3）value：SpinBox默认值

（4）lineStep：同上

（5）minValue：同上

（6）maxValue：同上

（7）prefix：SpinBox的前缀字符

（8）Suffix：SpinBox的后缀字符

（9）decimals：SpinBox的小数位数

4.常用成员函数

（1）QDoubleSpinBox：：QDoubleSpinBox（QWidget *parent = 0）

构造一个父对象为parent的Double SpinBox

八、Slider控件

1.控件位置：Input Widgets->Horizontal/Vertical Slider

2.控件介绍：滑动条分为Horizontal/Vertical Slider两个控件，但功能相同，两种滑动条之间可以相互转换，只需改变orientation属性即可

3.控件属性设置选项

（1）name：同上

（2）font：同上

（3）lineStep：滑动条值的最小跨度

（4）value：滑动条的值

（5）minValue；滑动条的最小值

（6）maxValue：滑动条的最大值

（7）orientation：滑动条的布局方向，Qt提供Horizontal/Vertical Slider两种选择

4.常用成员函数

（1）QSlider：：QSlider（QWidget *parent，const char *name =0）

构造一个名称为name，父对象为parent的Slider

（2）QSlider：：QSlider（Qrientation orientation，QWidget *parent，const char *name = 0）

构造一个名称为name，父对象为parent，布局方向为orientation的Slider

（3）QSlider：：QSlider（int minValue，int maxValue，int pageStep，int value，Orientation orientation，QWidget *parent，const char *name = 0）

构造一个名称为name，父对象为parent，布局方向为orientation，最大值为maxValue，最小值为minValue，页步长为pageStep和值为value的Slider

（4）void QSlider：：setValue（int v）[virtual slot]

设置该滑动条的值为v

（5）int QSlider：：value（）const

返回滑动条的值

九、Dial控件

1.控件位置：Input Widgets->Dial

2.控件介绍：表盘控件可用来描述各式各样的仪表盘样式

3.控件属性设置选项

（1）name：同上

（2）font：同上

（3）lineStep：表盘值的最小跨度

（4）value：表盘的值

（5）minValue：表盘的最小值

（6）maxValue：表盘的最大值

（7）notchTarget：表盘的刻度

（8）notchesVisible：是否显示表盘刻度，值为true时显示，否则不显示

4.常用成员函数

（1）QDial：：QDial（QWidget *parent = 0，cosnt char *name = 0，WFlags f = 0）

构造一个名称为name，父对象为parent的Dial

（2）QDial：：QDial（int minValue，int maxValue，int pageStep，int value，QWidget *parent = 0，cosnt char *name = 0

构造一个名称为name，父对象为parent，最大值为maxValue，最小值为minValue，步长为pageStep，值为value的Dial

（3）void QDial：：setValue（int v）[virtual slot]

设置该仪表盘的值为v

（4）int QDial：：value（）const

返回该表盘的值

十、ScrollBar控件

1.控件位置：Input Widgets->Horizontal/Vertical ScrollBar

2.控件介绍：滚动条ScrollBar和Slider相同。

3.控件属性设置选项

（1）name：同上

（2）font：设置滑动条上的字体

（3）lineStep：滑动条的最小跨度

（4）value：滑动条的值

（5）minValue：滑动条的最小值

（6）maxValue：滑动条的最大值

（7）orientation：滑动条的布局方向，Qt提供Horizontal/Vertical两种

4.常用成员函数

（1）QScrollBar：：QScrollBar（QWidget *parent，const char *name = 0）

构造一个名称为name，父对象为parent的ScrollBar

（2）QScrollBar：：QScrollBar（Orientation orientation，QWidget *parent，const char *name = 0）

构造一个名称为name，父对象为parent，布局为orientation的ScrollBar

（3）void QScrollBar：：setValue（int v）[slot]

设置该滚动条的值为v

（4）int QScrollBar：：value（）const

返回滚动条的值

十一、DateEdit控件

1.控件位置：Input Widgets->DateEdit

2.控件介绍：日期编辑框用于编辑和显示日期的控件

3.控件属性设置选项

（1）name：同上

（2）font：同上

（3）date：显示的日期

（4）minValue：日期的最小值

（5）maxValue：日期的最大字画

（6）order：设置日期显示格式，Qt提供的格式有YMD、YDM、DMY

4.常用成员函数

（1）QDateEdit：：QDateEdit（QWidget *parent = 0，const char *name = 0）

构造一个名称为name，父对象为parent的DateEdit

（2）QDateEdit：：QDateEdit（const QDate &date，QWidget *parent = 0，const char *name = 0）

构造一个名字为name，父对象为parent，当前显示日期为date的DateEdit，

（3）QDate QDateEdit：：date（）const

返回DateEdit控件的Date值

（4）void QDateEdit：：setDate（const QDate &date）[virtual]

设置DateEdit控件Date的值为date

（5）void QDateEdit：：setDay（int day）[virtual protected]

设置DateEdit控件Date的Day为day，必须确保day为有效值

（6）void QDateEdit：：setMonth（int month）[virtual protected]

设置DateEdit控件Date的Month为month，必须确保month为有效值

（7）void QDateEdit：：setYear（int year）[virtual protected]

设置DateEdit控件Date的Year为year，必须确保year为有效值

十二、TimeEdit控件

1.控件位置：Input Widgets->TimeEdit

2.控件介绍：用来编辑和显示时间的控件

3.控件属性设置选项

（1）name：同上

（2）font：设置文本框的字体

（3）time：显示的日期

（4）minValue：时间的最小值

（5）maxValue：时间的最大值

（6）display：设置时间显示格式

4.常用成员函数

（1）QTimeEdit：：QTimeEdit（QWidget *parent = 0，const char *name = 0）

构造一个名称为name，父对象为parent的TimeEdit

（2）QTimeEdit：：QTimeEdit（const QTime &time，QWidget *parent = 0，const char *name = 0）

构造一个名称为name，父对象为parent，当前显示时间为time的TimeEdit

（3）QTime QTimeEdit：：time（）const

返回TimeEdit控件Time的值

（4）void QTimeEdit：：setTime（const QTime &time）[virtural]

设置TimeEdit控件为Time的值time

（5）void QTimeEdit：：setHour（int h）[virtural protected]

设置TimeEdit控件Time的Hour为h，必须确保h为有效值

（6）void QTimeEdit：：setMinute（int m）[virtual protected]

设置TimeEdit控件Time的Minute为m，必须确保m为有效值

（7）void QTimeEdit：：setSecond（int s）[virtual protected]

设置TimeEdit控件Time的Second为s，必须确保s为有效值

十三、DateEdit控件

1.控件位置：Input Widgets->DateTimeEdit

2.控件介绍：日期时间编辑框是一个用来编辑和显示日期和时间的控件，相当于把DateEdit和TimeEdit联合起来使用

3.控件属性设置选项

（1）name：同上

（2）font：设置文本框的字体

（3）datetime：显示的日期和时间