Qt输入类控件用法超详细讲解_C/C++

1.line edit

qlineedit⽤来表⽰单⾏输⼊框，可以输⼊⼀段⽂本，但是不能换⾏
核心属性：
- text：输入框中的文本
- inputmask：输入内容格式约束
  - inputmask只能进⾏简单的输⼊格式校验
  - 实际开发中，基于正则表达式的⽅式是更核⼼的⽅法
- maxlength：最大长度
- frame：是否添加边框
- echomode：显示方式
  - qlineedit::normal：默认值，⽂本框会显⽰输⼊的⽂本
  - qlineedit::password：在这种模式下，输⼊的字符会被隐藏，通常⽤星号(*)或等号(=)代替
  - qlineedit::noecho：在这种模式下，⽂本框不会显⽰任何输⼊的字符
- cursorposition：光标所在的位置
- alignment：文字对齐方式，设置水平和垂直方向的对齐
- dragenabled：是否允许拖拽
- readonly：是否是只读的
- placeholdertext：当输入框内容为空的时候，显示什么样的提示信息
- clearbuttonenabled：是否会自动显示出"清除按钮"
核心信号：
- void cursorpositionchanged(int old, int new)：当⿏标移动时发出此信号
  - old为先前的位置，new为新位置
- void editingfinished()：当按返回或者回⻋键时，或者⾏编辑失去焦点时，发出此信号
- void returnpressed()：当返回或回⻋键按下时发出此信号
  - 如果设置了验证器，必须要验证通过，才能触发
- void selectionchanged()：当选中的⽂本改变时，发出此信号
- void textchanged(const qstring &text)：当qlineedit的⽂本改变时，发出此信号
  - text是新的⽂本，代码对⽂本的修改能够触发这个信号
- void textedited(const qstring &text))：当qlineedit中⽂本改变时，发出此信号
  - text是新的⽂本，代码对⽂本的修改不能触发这个信号

示例：对输入框内容进行验证

qregexp创建⼀个正则表达式对象
qregexpvalidator创建⼀个验证器对象，qt中内置了四个主要的验证其对象
- qregularexpressionvalidator在匹配性能上做出了⼀定优化，但是从使⽤⻆度讲，和qregexpvalidator差别不⼤

// 槽函数实现
{
	void widget::on_lineedit_textedited(const qstring &arg1)
	{
		qstring content = arg1;
		int pos = 0;

		if(ui->lineedit->validator()->validate(content, pos)
			== qvalidator::acceptable)
		{
			ui->pushbutton->setenabled(true);
		}
		else
		{
			ui->pushbutton->setenabled(false);
		}
	}
}

// 功能实现
{
	// 设置按钮默认是禁用状态
	ui->pushbutton->setenabled(false);

	// 给lineedit注册一个validator
	ui->lineedit->setvalidator(new qregexpvalidator(qregexp("^1\\d{10}$")));
}

2.text edit

qtextedit表⽰多⾏输⼊框
- 是⼀个富⽂本&markdown编辑器，并且能在内容超出编辑框范围时⾃动提供滚动条
核心属性：
- markdown：输⼊框内持有的内容，⽀持markdown格式，能够⾃动地对markdown⽂本进⾏渲染成html
- html：输⼊框内持有的内容，可以⽀持⼤部分html标签，包括img和table等
- placeholdertext：输⼊框为空时提⽰的内容
- readonly：是否是只读的
- undoredoenable：是否开启undo/redo功能
  - 按下ctrl + z触发undo
  - 按下ctrl + y触发redo
- autoformating：开启自动格式化
- tabstopwidth：按下缩进占多少控件
- overwritemode：是否开启覆盖写模式
  - 对应键盘上insert键开启的功能
- acceptrichtext：是否接受富文本内容
- verticalscrollbarpolicy：垂直⽅向滚动条的出现策略
  - qt::scrollbarasneeded：默认值，根据内容⾃动决定是否需要滚动条
  - qt::scrollbaralwaysoff：总是关闭滚动条
  - qt::scrollbaralwayson：总是显⽰滚动条
- horizontalscrollbarpolicy：⽔平⽅向滚动条的出现策略
  - qt::scrollbarasneeded：默认值，根据内容⾃动决定是否需要滚动条
  - qt::scrollbaralwaysoff：总是关闭滚动条
  - qt::scrollbaralwayson：总是显⽰滚动条
核心信号：
- textchanged()：⽂本内容改变时触发
- selectionchanged()：选中范围改变时触发
- cursorpositionchanged()：光标移动时触发
- undoavailable(bool)：可以进⾏undo操作时触发
- redoavailable(bool)：可以进⾏redo操作时触发
- copyavaiable(bool)：⽂本被选中/取消选中时触发

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(constqstring&text)：这个时候相当于⽤⼾点开下拉框，并且⿏标划过某个选项，此时还没有确认做出选择
- currentindexchanged(int)：当前选项改变时发出
- currentindexchanged(const qstring& text)：此时⽤⼾已经明确的选择了⼀个选项，⽤⼾操作或者通过程序操作都会触发这个信号
- edittextchanged(constqstring& text)：当编辑框中的⽂本改变时发出
  - editable为true时有效

4.spin box

qspinbox或者qdoublespinbox表⽰**“微调框”**
- 它是带有按钮的输⼊框，可以⽤来输⼊整数/浮点数，通过点击按钮来修改数值⼤⼩
关键属性：
- value：存储的数值
- singlestep：每次调整的"步⻓"，即按⼀次按钮数据变化多少
- displayinteger：数字的进制
  - 例如：displayinteger设为10则是按照10进制表⽰，设为2则为2进制表⽰.
- minimum：最⼩值
- maximum：最⼤值
- suffix：后缀
- prefix：前缀
- wrapping：是否允许换⾏
- frame：是否带边框
- alignment：⽂字对⻬⽅式.
- readonly：是否允许修改
- buttonsymbol：按钮上的图标
  - updownarrows：上下箭头形式
  - plusminus：加减号形式
  - nobuttons：没有按钮
- accelerated：按下按钮时是否为快速调整模式
- correctionmode：输⼊有误时如何修正
  - qabstractspinbox::correcttopreviousvalue
    - 如果⽤⼾输⼊了⼀个⽆效的值，那么spinbox会恢复为上⼀个有效值
    - 例如：如果spinbox的初始值是1，⽤⼾输⼊了-1(⽆效)，然后spinbox会恢复为1
  - qabstractspinbox::correcttonearestvalue
    - 如果⽤⼾输⼊了⼀个⽆效的值，spinbox会恢复为最接近的有效值
    - 例如：如果spinbox的初始值是1，⽤⼾输⼊了-1(⽆效)，那么spinbox会恢复为0
- keyboardtrack：是否开启键盘跟踪
  - true：每次在输⼊框输⼊⼀个数字，都会触发⼀次valuechanged()和textchanged()信号
  - false，只有在最终按下enter或者输⼊框失去焦点，才会触发valuechanged()和textchanged()信号
核心信号：
- textchanged(qstring)：微调框的⽂本发⽣改变时会触发
  - 参数qstring带有前缀和后缀
- valuechanged(int)：微调框的⽂本发⽣改变时会触发
  - 参数int，表⽰当前的数值

5.date edit && time edit

qdateedit为⽇期的微调框
qtimeedit为时间的微调框
qdatetimeedit为时间⽇期的微调框
这⼏个控件⽤法⾮常相似，以qdatetimeedit为例进⾏介绍
核心属性：
- datetime：时间⽇期的值，形如2000/1/1 0:00:00
- date：单纯⽇期的值，形如2000/1/1
- time：单纯时间的值，形如0:00:00
- displayformat：时间⽇期格式，形如yyyy/m/d h:mm
- minimumdatetime：最⼩时间⽇期
- maximumdatetime：最⼤时间⽇期
- timespec：
  - qt::localtime ：显⽰本地时间
  - qt::utc ：显⽰协调世界时(utc)
  - qt::offsetfromutc ：显⽰相对于utc的偏移量(时差)
核心信号：
- datechanged(qdate)：⽇期改变时触发
- timechanged(qtime)：时间改变时触发
- datetimechanged(qdatetime)：时间⽇期任意⼀个改变时触发

示例：日期计算器

使⽤daysto()可以计算两个⽇期的天数
使⽤secsto()可以计算两个时间的秒数
通过(seconds/3600)换算成⼩时数，再%24得到零⼏个⼩时
使⽤qstring::number把整数转成qstring进⾏拼接

void widget::on_pushbutton_clicked()
{
	qdatetime timeold = ui->datetimeedit_old->datetime();
	qdatetime timenew = ui->datetimeedit_new->datetime();

	// int days = timeold.daysto(timenew); // 实际上这样换算有bug
	int days = (timeold.secsto(timenew) / 3600) / 24;
	int hours = (timeold.secsto(timenew) / 3600) % 24;
	
	qstring text = qstring("间隔为") + qstring::number(days) + qstring("天 ") 
				 + qstring::number(hours) + qstring("个⼩时!");

	ui->label->settext(text);
}

6.dial

qdial表⽰⼀个旋钮
核心属性：
- value：持有的数值
- minimum：最⼩值
- maximum：最⼤值
- singlestep：按下⽅向键的时候改变的步⻓
- pagestep：按下pageup/pagedown的时候改变的步⻓
- sliderposition：界⾯上旋钮显⽰的初始位置
- tracking：外观是否会跟踪数值变化，默认值为true，⼀般不需要修改
- wrapping：是否允许循环调整，即数值如果超过最⼤值，是否允许回到最⼩值
  - 即：调整过程能否"套圈"
- notchesvisible：是否显⽰刻度线
- notchtarget：刻度线之间的相对位置，数字越⼤，刻度线越稀疏
核心信号：
- valuechanged(int)：数值改变时触发
- rangechanged(int, int)：范围变化时触发

7.slider

qslider表⽰⼀个滑动条
- qslider和qdial都是继承⾃qabstractslider，因此⽤法上基本相同
核心属性：
- value：持有的数值
- minimum：最⼩值
- maximum：最⼤值
- singlestep：按下⽅向键的时候改变的步⻓
- pagestep：按下pageup/pagedown的时候改变的步⻓
- sliderposition：界⾯上旋钮显⽰的初始位置
- tracking：外观是否会跟踪数值变化，默认值为true，⼀般不需要修改
- orientation：滑动条的⽅向是⽔平还是垂直
- invertedappearance：是否要翻转滑动条的⽅向
- tickposition：刻度的位置
- tickinterval：刻度的密集程度
核心信号：
- valuechanged(int)：数值改变时触发
- rangechanged(int, int)：范围变化时触发

示例：通过⾃定义快捷键调整滑动条位置

使⽤qshortcut类设置快捷键
快捷键触发时，会发出qshortcut::activated信号，连接到⾃⼰写的slot函数

qshortcut* shortcut1 = new qshortcut(this);
shortcut1->setkey(qkeysequence("-"));
connect(shortcut1, &qshortcut::activated, this, &widget::subvalue);

qshortcut* shortcut2 = new qshortcut(this);
shortcut2->setkey(qkeysequence("="));
connect(shortcut2, &qshortcut::activated, this, &widget::addvalue);