[Qt] 输入控件 | Line | Text | Combo | Spin | Date | Dial

输入类控件

1、Line Edit

录入个人信息

使用正则表达式验证输入框的数据

验证两次输入的密码一致

切换显示密码

2、Text Edit

获取多行输入框的内容

验证输入框的各种信号

3、Combo Box

使用下拉框模拟麦当劳点餐

从文件中加载下拉框的选项

4、Spin Box

调整麦当劳购物车中的份数

5、Date Edit & Time Edit

实现日期计算器

6、Dial

调整窗口透明度

7、Slider

调整窗口大小

通过自定义快捷键调整滑动条位置

输入类控件

1、Line Edit

QLineEdit 用来表示单行输入框，可以输入一段文本，但是不能换行。

核心属性：

属性	说明
text	输入框中的文本。
inputMask	输入内容格式约束，限制用户输入的格式。
maxLength	最大长度，定义输入框允许的最大字符数。
frame	是否添加边框，默认为 `true` 显示边框。
echoMode	显示方式： - `QLineEdit::Normal`：显示输入文本 - `QLineEdit::Password`：隐藏输入字符 - `QLineEdit::NoEcho`：不显示任何输入字符
cursorPosition	光标所在位置，表示当前光标的索引。
alignment	文字对齐方式，设置水平和垂直方向的对齐。如：`Qt::AlignLeft`、`Qt::AlignCenter` 等
dragEnabled	是否允许拖拽，默认为 `false` 不允许。
readOnly	是否是只读的（不允许修改），默认为 `false` 可编辑。
placeHolderText	当输入框内容为空时显示的提示信息。
clearButtonEnabled	是否会自动显示出“清除按钮”，点击可清空文本，默认为 `false` 不显示。

核心信号

信号	说明
cursorPositionChanged(int old, int new)	当鼠标移动时发出此信号，`old` 为先前的位置，`new` 为新位置。
editingFinished()	当按返回或者回车键时，或者行编辑失去焦点时，发出此信号。
returnPressed()	当返回或回车键按下时发出此信号。如果设置了验证器，则必须验证通过才能触发。
selectionChanged()	当选中的文本改变时，发出此信号。
textChanged(const QString &text)	当 `QLineEdit` 中的文本改变时，发出此信号，`text` 是新的文本。代码对文本的修改也能触发这个信号。
textEdited(const QString &text)	当 `QLineEdit` 中的文本被用户编辑改变时，发出此信号，`text` 是新的文本。代码对文本的修改不会触发这个信号。

录入个人信息

（1）在界面上创建三个输入框和两个单选按钮，一个普通按钮

三个输入框的 objectName 为 lineEdit_name、lineEdit_password、lineEdit_phone
两个单选按钮的 objectName 为 radioButton_male、radioButton_female
按钮的 objectName 为 pushButton

（2）编写 widget.cpp，在构造函数中编写初始化代码

（3）继续修改 widget.cpp，给按钮添加 slot 函数

（4）执行程序

可以看到，随着用户输⼊内容之后，点击 “提交” 按钮就能打印到输入的信息：

inputMask 只能进行简单的输入格式校验。

实际开发中，基于正则表达式的方式是更核心的方法。

使用正则表达式验证输入框的数据

此处要求在输入框中输入一个合法的电话号码（1 开头，11 位，全都是数字）。如果验证不通过，则确定按钮无法点击。

（1）关于正则表达式

正则表达式是一种在计算机中常用的，使用特殊字符描述一个字符串的特征的机制，在进行字符串匹配时非常有用。

正则表达式的语法还比较复杂，一般都是随用随查，不需要背下来。

可参考：

正则表达式文档：正则表达式语法 | Microsoft Learn

正则表达式在线工具：正则表达式语法测试工具 - 在线工具 (buyaocha.com)

（2）在界面上创建输入框和一个按钮

此处的规则：输入框要检查输入的内容是否为合法的手机号码。

如果是，则按钮设为可用状态。
如果不是，则按钮设为禁用状态。

（3）编写 widget.cpp，把按钮初始 enabled 设为 false，给输入框添加验证器

使用 QRegExp 创建一个正则表达式对象，"^1\\d{10}$"
表示" 表示以 xxx 开头，后面跟着的 1 表示以 1 开头，\d 表示数字，为了在 C++ 字符串中使用，需要写作 \\d，{10} 表示前面的内容重复出现 10 次，\d 数字要重复出现 10 次，$ 表示结尾。
使用 QRegExpValidator 创建一个验证器对象，Qt 中内置了四个主要的验证器对象。

QRegularExpressionValidator 在匹配性能上做出了一定优化。

但是从使用角度讲，和 QRegExpValidator 差别不大，我们使用 QRegExpValidator 即可。

（4）编写 widget.cpp，给 lineEdit 添加 textEdited 信号的 slot 函数

on_lineEdit_textEdited 的参数是当前输入框的内容
通过 lineEdit->validator() 获取到内置的验证器
通过 validate 方法验证文本是否符合要求

第一个参数填写的是要验证的字符串。由于参数要求是 QString& 而不是 const QString&，需要把这个变量复制一下。
第二个参数是⼀个 int&，是输出型参数。当验证的字符串不匹配时，返回这个字符串的长度（没有什么实质作用）。
返回值是⼀个枚举。 QValidator::Acceptable 表示验证通过，QValidator::Invalid 表示验证不通过。

（5）执行程序

观察效果，可以看到此时尝试输入字母是无法输入的，并且只有当输入的内容符合要求，确定按钮才能被使用

验证两次输入的密码一致

（1）在界面上创建两个输入框和一个 label

（2）编写代码，设置两个输入框的 echoMode 为 Password

（3）给两个输入框设置 textEdited slot 函数

由于两个槽函数内容一致，我们可以选择封装一个函数，然后在槽函数内直接调用即可。

（4）执行程序

可以看到当两个输入框内的密码相同时，就会提示密码相同：

切换显示密码

（1）创建一个输入框和一个复选按钮

（2）修改 widget.cpp，设置输入框的 echoMode 为 Password

（3）修改 widget.cpp，给 checkBox 添加 slot 函数

（4）执行程序

可以看到切换复选框的状态，就可以控制输入框显示密码：

2、Text Edit

QTextEdit 表示多行输入框，也是一个富文本 & markdown 编辑器
并且能在内容超出编辑框范围时自动提供滚动条。

核心属性：

属性	说明
markdown	输入框内持有的内容，支持 Markdown 格式。能够自动对 Markdown 文本进行渲染成 HTML。
html	输入框内持有的内容，可以支持大部分 HTML 标签，包括 `img` 和 `table` 等。
placeHolderText	输入框为空时提示的内容。
readOnly	是否是只读的，默认为 `false` 可编辑。
undoRedoEnabled	是否开启 undo/redo 功能，默认为 `true` 开启。按下 `Ctrl+Z` 触发 undo 按下 `Ctrl+Y` 触发 redo
autoFormatting	开启自动格式化功能。
tabStopWidth	按下缩进占多少空间，默认单位为像素。
overwriteMode	是否开启覆盖写模式，默认为 `false` 不开启。
acceptRichText	是否接收富文本内容，默认为 `true` 接收。
verticalScrollBarPolicy	垂直方向滚动条的出现策略： - `Qt::ScrollBarAsNeeded`：根据内容自动决定是否需要滚动条（默认值） - `Qt::ScrollBarAlwaysOff`：总是关闭滚动条 - `Qt::ScrollBarAlwaysOn`：总是显示滚动条
horizontalScrollBarPolicy	水平方向滚动条的出现策略： - `Qt::ScrollBarAsNeeded`：根据内容自动决定是否需要滚动条（默认值） - `Qt::ScrollBarAlwaysOff`：总是关闭滚动条 - `Qt::ScrollBarAlwaysOn`：总是显示滚动条

核心信号

信号	说明
textChanged()	文本内容改变时触发。
selectionChanged()	选中范围改变时触发。
cursorPositionChanged()	光标移动时触发。
undoAvailable(bool)	当可以进行 undo 操作时触发，参数表示当前是否可以 undo。
redoAvailable(bool)	当可以进行 redo 操作时触发，参数表示当前是否可以 redo。
copyAvailable(bool)	文本被选中或取消选中时触发，参数表示当前是否有可复制的文本。

获取多行输入框的内容

（1）创建一个多行输入框和一个 label

⭕（2）给多行输入框添加 slot 函数，处理 textChanged 信号

通过 toPlainText 方法获取到内部的文本
类似的，QTextEdit 还提供了 toMarkdown 和 toHtml，根据需要我们调整不同的获取方式

（3）执行程序

可以看到当输入框中的内容发生变化时，label 中的内容同步发生改变：

验证输入框的各种信号

（1）创建多行输入框

（2）给输入框添加以下几个 slot 函数

QTextEdit 中包含了一个 QTextCursor 对象，通过这个对象可以获取到当前光标位置和选中的内容。

（3）执行程序

A. 编写内容时，textChanged 和 cursorPositionChanged 会触发

B. 选中一段文本时，cursorPositionChanged、selectChanged、copyAvailable 会触发

C. 按下 Ctrl + Z 时，textChanged、undoAvailable、redoAvailable、cursorPositionChanged 会触发

D. 按下 Ctrl + Y，textChanged、undoAvailable、redoAvailable、cursorPositionChanged 会触发

3、Combo Box

QComboBox 表示下拉框。

核心属性

属性名称	说明
currentText	当前选中的文本
currentIndex	当前选中的条目下标，从0开始计算。如果没有条目被选中，值为-1
editable	是否允许修改；设为true时，QComboBox的行为接近QLineEdit，并可设置validator
iconSize	下拉框图标（小三角）的大小
maxCount	最多允许有多少个条目

核心方法

方法名称	说明
addItem(const QString&)	添加一个条目
currentIndex()	获取当前条目的下标，从0开始计算。如果没有条目被选中，值为-1
currentText()	获取当前条目的文本内容

核心信号

信号名称	说明
activated(int)	用户选择了选项时发出，相当于用户点开下拉框并且鼠标划过某个选项
activated(const QString &text)	同上，但是传递的是文本参数
currentIndexChanged(int)	当前选项改变时发出，用户已经明确选择了一个选项
currentIndexChanged(const QString &text)	同上，但是传递的是文本参数
editTextChanged(const QString &text)	当编辑框中的文本改变时发出（当editable为true时有效）

使用下拉框模拟麦当劳点餐

（1）在界面上创建三个下拉框和一个按钮

（2）编写 widget.cpp，初始化三个下拉框的内容

也可以选择直接在 ui 界面添加选项内容：

（3）编写 widget.cpp，给按钮添加 slot 函数

（4）执行程序

在点击确定按钮时，就能获取到当前下拉框中选中的内容：

从文件中加载下拉框的选项

很多时候下拉框的选项并非是固定的，而是通过读取文件 / 读取网络获取到的。

（1）在界面上创建一个下拉框

（2）创建文件 d:/config.txt，编写选项，每个选项占一行

⭕（3）修改 widget.cpp，从文件中读取选项

使用 ifstream 打开文件
使用 getline 读取每一行
使用 QString::fromStdString 把 std::string 转成 QString

（4）执行程序

可以看到文件内容已经被加载到下拉框中：

Qt 中也提供了 QFile 实现读写文件的功能，当然使用 C++ 标准库的 std::fstream 也是完全可以的。
之所以存在两套，是因为 Qt 诞生较早（1991 年左右），此时 C++ 还没有完成 “标准化” 的工作，C++ 标准库这样的概念自然也没有诞生。
因此 Qt 就自己打造了一套库，实现了字符串、容器、文件操作、多线程、网络操作、定时器、正则表达式等内容。（由于 C++ 标准委员会的不作为，至今仍然有些 Qt 提供的功能，是标准库不具备的）

4、Spin Box

使用 QSpinBox 或者 QDoubleSpinBox 表示 “微调框”，它是带有按钮的输入框，可以用来输入整数 / 浮点数，通过点击按钮来修改数值大小。

由于 SpinBox 和 QDoubleSpinBox 用法基本相同，就只介绍 SpinBox 的使用了。

Spin 英文原意为 “旋转”，此处引申成 “微调”。

事实上很多术语在翻译的时候，不一定非要按照原始的翻译来表示，更追求的是 “信达雅”。
举例：地铁上的 "Priority Seat" 会翻译成 “爱心专座”，而不是 “优先座位”。

QSpinBox 关键属性

属性名称	说明
value	存储的数值
singleStep	每次调整的"步长". 按下一次按钮数据变化多少
displayIntegerBase	数字的进制。例如设为10，则是按照10进制表示；设为2则为2进制表示
minimum	最小值
maximum	最大值
suffix	后缀
prefix	前缀
wrapping	是否允许换行
frame	是否带边框
alignment	文字对齐方式
readOnly	是否允许修改
buttonSymbols	按钮上的图标：上下箭头形式、加减号形式、没有按钮
accelerated	按下按钮时是否为快速调整模式
correctionMode	输入有误时如何修正： - CorrectToPreviousValue: 恢复为上一个有效值 - CorrectToNearestValue: 恢复为最接近的有效值
keyboardTracking	是否开启键盘跟踪。设为true, 每次在输入框输入一个数字, 都会触发一次valueChanged() 和 textChanged() 信号。设为false, 只有在最终按下enter 或者输入框失去焦点, 才会触发 valueChanged() 和 textChanged() 信号

核心信号

信号名称	说明
textChanged(QString)	微调框的文本发生改变时会触发。参数 QString 带有前缀和后缀
valueChanged(int)	微调框的值发生改变时会触发。参数 int 表示当前的数值

调整麦当劳购物车中的份数

（1）在界面上创建下列内容

三个下拉框：objectName 为 comboBox 到 comboBox_3
三个微调框：objectName 为 spinBox 到 spinBox_3
一个按钮：objectName 为 pushButton

（2）编写代码，修改 widget.cpp，给下拉框设置初始值

（3）编写代码，给按钮添加 slot 函数

（4）执行程序

可以看到当用户选择不同的内容时，点击按钮就能获取到对应的结果

同时我们也无法输入一些超出范围的非法值。

5、Date Edit & Time Edit

使用 QDateEdit 作为日期的微调框：

使用 QTimeEdit 作为时间的微调框：

使用 QDateTimeEdit 作为时间日期的微调框：

这几个控件用法非常相似，这里以 QDateTimeEdit 为例进行介绍。

QDateTimeEdit 核心属性：

属性名称	说明
dateTime	时间日期的值。格式形如：2000/1/1 0:00:00
date	单纯日期的值。格式形如：2001/1/1
time	单纯时间的值。格式形如：0:00:00
displayFormat	时间日期显示格式。常用的格式化符号： - `y`: 年份 - `M`: 月份 - `d`: 日期 - `H`: 小时（24小时制） - `m`: 分钟 - `s`: 秒注意，不同语言或库的设定规则可能存在差异，具体使用时应查阅文档
minimumDateTime	设置可选择的最小时间日期
maximumDateTime	设置可选择的最大时间日期
timeSpec	指定时间的时区或偏移： - `Qt::LocalTime`: 显示本地时间 - `Qt::UTC`: 显示协调世界时（UTC） - `Qt::OffsetFromUTC`: 显示相对于UTC的偏移量（时差）

（1）关于本地时间（LocalTime）和协调世界时（UTC）

UTC 时间是一个基于原子钟的标准时间，不受地球的自转周期影响，和格林威治时间（GMT）是非常接近的，科学家会通过精密的设备来测量并维护。

我们的计算机内部使用的时间就是基于 UTC 时间。
本地时间则是基于不同的时区，对 UTC 时间做出了一些调整。
比如咱们使用的北京时间，位于 “东八区”，就需要在 UTC 时间基础上 +8 个小时的时差。

核心信号：

信号名称	说明
dateChanged(QDate)	当日期改变时触发。参数 QDate 包含新的日期值
timeChanged(QTime)	当时间改变时触发。参数 QTime 包含新的时间值
dateTimeChanged(QDateTime)	当日期或时间任意一个改变时触发。参数 QDateTime 包含新的日期时间值

实现日期计算器

（1）在界面上创建两个 QDateTimeEdit 和一个按钮，一个 label

QDateTimeEdit 的 objectName 为 dateTimeEdit_old 和 dateTimeEdit_new

（2）编写计算按钮的 slot 函数

使用 daysTo 函数可以计算两个日期的天数
使用 secsTo 函数可以计算两个时间的秒数
通过（秒数 / 3600）换算成小时数，再余上 24 得到零几个小时
使用 QString::number 把整数转成 QString 进行拼接

（3）执行程序

6、Dial

使用 QDial 表示一个旋钮。

有些程序通过鼠标拖动旋钮旋转，即可完成一些相关的设置。

核心属性：

属性名称	说明
value	持有的数值
minimum	最小值
maximum	最大值
singleStep	按下方方向键的时候改变的步长
pageStep	按下 PageUp/PageDown 的时候改变的步长
sliderPosition	界面上旋钮显示的初始位置
tracking	外观是否会跟踪数值变化，默认值为 true，一般不需要修改
wrapping	是否允许循环调整。即数值如果超过最大值，是否允许回到最小值（调整过程能否"套圈"）
notchesVisible	是否显示刻度线
notchTarget	刻度线之间的相对位置。数字越大，刻度线越稀疏

核心信号

信号名称	说明
valueChanged(int)	数值改变时触发
rangeChanged(int, int)	范围变化时触发。参数包含新的最小值和最大值

调整窗口透明度

（1）在界面上创建一个旋钮，并对其数值进行初始化

（2）编写 widget.cpp，设置旋钮的 valueChanged slot 函数

（3）运行程序

观察效果，可以看到随着拖动旋钮旋转，不透明度发生明显变化：

7、Slider

使用 QSlider 表示一个滑动条：

QSlider 和 QDial 都是继承自 QAbstractSlider，因此用法上基本相同。

核心属性：

属性名称	说明
value	持有的数值
minimum	最小值
maximum	最大值
singleStep	按下方方向键的时候改变的步长
pageStep	按下 PageUp/PageDown 的时候改变的步长
sliderPosition	滑动条显示的初始位置
tracking	外观是否会跟踪数值变化，默认值为 true，一般不需要修改
orientation	滑动条的方向是水平还是垂直
invertedAppearance	是否要翻转滑动条的方向
tickPosition	刻度的位置。可选值包括无刻度、仅在上方或下方、两侧都显示等
tickInterval	刻度的密集程度。定义相邻刻度之间的间隔

核心信号

信号名称	说明
valueChanged(int)	数值改变时触发。参数 int 包含新的数值
rangeChanged(int, int)	范围变化时触发。参数包含新的最小值和最大值