目录
Line Edit
核心属性
核心信号
正则表达式
示例:使用正则表达式验证输入框内容
示例:切换输入框密码模式下的显示状态
Text Edit
核心属性
核心信号
示例:获取多行输入框的内容同步显示到label
示例:获取文本的选中范围
Combo Box
核心属性
核心方法
核心信号
示例:通过读取文件获取选项内容
QString和std::string相互转换
Spin Box
QSpinBox关键属性
核心信号
Date Edit & Time Edit
核心属性
关于 本地时间(LocalTime) 和 协调世界时(UTC)
核心信号
QDateTime
示例:计算两个日期的差值
Dial
核心属性
核心信号
Slider
核心属性
核心信号
自定义快捷键 **
Line Edit
核心属性
属性 | 说明 |
---|---|
text | 输⼊框中的⽂本 |
inputMask | 输⼊内容格式约束 |
maxLength | 最⼤⻓度 |
frame | 是否添加边框 |
echoMode | 显示方式.
|
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是新的⽂本。 代码对⽂本的修改不能触发这个信号. |
为了验证输入框中的内容是否满足规则,可以使用正则表达式。
正则表达式
正则表达式⽂档正则表达式语法 | Microsoft Learn正则表达式在线⼯具:正则表达式语法测试工具 - 在线工具 (buyaocha.com)
示例:使用正则表达式验证输入框内容
#include "widget.h"
#include "ui_widget.h"
#include <QRegExpValidator>
Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);ui->pushButton->setEnabled(false);ui->lineEdit->setPlaceholderText("请输入手机号");ui->lineEdit->setClearButtonEnabled(true);//这里只是注册一个验证器QRegExp regexp("^1\\d{10}$");ui->lineEdit->setValidator(new QRegExpValidator(regexp));}Widget::~Widget()
{delete ui;
}void Widget::on_lineEdit_textChanged(const QString &arg1)
{QString text=arg1;int pos=0;if(ui->lineEdit->validator()->validate(text,pos)==QValidator::Acceptable){//验证通过ui->pushButton->setEnabled(true);}else{//验证不通过ui->pushButton->setEnabled(false);}
}
示例:切换输入框密码模式下的显示状态
#include "widget.h"
#include "ui_widget.h"Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);ui->lineEdit->setEchoMode(QLineEdit::Password);}Widget::~Widget()
{delete ui;
}void Widget::on_checkBox_toggled(bool checked)
{if(checked){ui->lineEdit->setEchoMode(QLineEdit::Normal);}else{ui->lineEdit->setEchoMode(QLineEdit::Password);}
}
Text Edit
与Line Edit不同的是,Text Edit表示多行输入框,也是⼀个富⽂本 & markdown 编辑器,并且能在内容超出编辑框范围时⾃动提供滚动条。
在Qt中表示多行输入框有两种:
QTextEdit | 不仅能表示纯文本,还可以表示html和markdow |
QPlainTextEdit | 只能表示纯文本 |
核心属性
属性 | 说明 |
---|---|
markdown | 输⼊框内持有的内容. ⽀持 markdown 格式. 能够⾃动的对markdown ⽂本进⾏ 渲染成 html |
html | 输⼊框内持有的内容. 可以⽀持⼤部分 html 标签. 包括 img 和 table 等 |
placeHolderText | 输⼊框为空时提⽰的内容 |
readOnly | 是否是只读的 |
undoRedoEnable | 是否开启 undo / redo 功能. 按下 ctrl + z 触发 undo 撤销 按下 ctrl + y 触发 redo 撤销的撤销 |
autoFormating | 开启⾃动格式化. |
tabstopWidth | 按下缩进占多少空间 |
overwriteMode | 是否开启覆盖写模式 |
acceptRichText | 是否接收富⽂本内容 |
verticalScrollBarPolicy | 垂直⽅向滚动条的出现策略
|
horizontalScrollBarPolicy | ⽔平⽅向滚动条的出现策略
|
核心信号
信号 | 说明 |
---|---|
textChanged() | ⽂本内容改变时触发 |
selectionChanged() | 选中范围改变时触发 |
cursorPositionChanged() | 光标移动时触发 |
undoAvailable(bool) | 可以进⾏ undo 操作时触发 |
redoAvailable(bool) | 可以进⾏ redo 操作时触发 |
copyAvaiable(bool) | ⽂本被选中/取消选中时触发 |
示例:获取多行输入框的内容同步显示到label
void Widget::on_textEdit_textChanged()
{QString text=ui->textEdit->toPlainText();ui->label->setText(text);
}
示例:获取文本的选中范围
Edit中有一个属性
QTextCursor cursor = ui->textEdit->textCursor();
返回的QTextCursor对象描述的就是光标的一些情况
void Widget::on_textEdit_selectionChanged()
{QTextCursor cursor=ui->textEdit->textCursor();qDebug()<<"选中的文本是:"<<cursor.selectedText();
}
Combo Box
核心属性
属性 | 说明 |
---|---|
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 时有效) |
示例:通过读取文件获取选项内容
#include "widget.h"
#include "ui_widget.h"
#include <QDebug>
#include <fstream>
Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);//C:/Users/L/Desktop/config.txtstd::ifstream file("C:/Users/L/Desktop/config.txt");if(!file.is_open()){qDebug()<<"文件打开失败";return;}std::string line;while(std::getline(file,line)){ui->comboBox->addItem(QString::fromStdString(line));}file.close();
}Widget::~Widget()
{delete ui;
}
QString和std::string相互转换
std::string 转 QString
QString::fromStdString(line);
QString 转 std::string
QString s;
std::string str=s.toStdString();
Spin Box
QSpinBox关键属性
属性 | 说明 |
---|---|
value | 存储的数值 |
singleStep | 每次调整的 "步⻓". 按下⼀次按钮数据变化多少 |
displayInteger | 数字的进制. 例如 displayInteger 设为 10, 则是按照 10 进制表⽰. 设为 2 则为 2 进制表⽰ |
minimum | 最⼩值 |
maximum | 最⼤值 |
suffix | 后缀 |
prefix | 前缀 |
wrapping | 是否允许换⾏ |
frame | 是否带边框 |
alignment | ⽂字对⻬⽅式 |
readOnly | 是否允许修改 |
buttonSymbol | 按钮上的图标.
|
accelerated (加速的) | 按下按钮时是否为快速调整模式 |
correctionMode | 输⼊有误时如何修正.
|
keyboardTrack | 是否开启键盘跟踪.
|
核心信号
信号 | 说明 |
---|---|
textChanged(QString) | 微调框的⽂本发⽣改变时会触发. 参数 QString 带有 前缀 和 后缀. |
valueChanged(int) | 微调框的⽂本发⽣改变时会触发. 参数 int, 表⽰当前的数值 |
Date Edit & Time Edit
核心属性
属性 | 说明 |
---|---|
dateTime | 时间⽇期的值. 形如 2000/1/1 0:00:00 |
date | 单纯⽇期的值. 形如 2001/1/1 |
time | 单纯时间的值. 形如 0:00:00 |
displayFormat | 时间⽇期格式. 形如 yyyy/M/d H:mm
注意: 这⾥的格式化符号的含义, 不要记忆. 不同语⾔/库的设定规则 是存在差异的. ⼀定是⽤的时候再去查. |
minimumDateTime | 最⼩时间⽇期 |
maximumDateTime | 最⼤时间⽇期 |
timeSpec |
|
关于 本地时间(LocalTime) 和 协调世界时(UTC)
UTC 时间是⼀个基于原⼦钟的标准时间. 不受地球的⾃转周期影响. 和格林威治时间 (GMT) 是 ⾮常接近的. 科学家会通过精密的设备来测量并维护.咱们的计算机内部使⽤的时间就是基于 UTC 时间.本地时间则是基于不同的时区, 对 UTC 时间做出了⼀些调整. ⽐如咱们使⽤的北京时间, 位于"东⼋区", 就需要在 UTC 时间基础上 +8 个⼩时的时差
核心信号
信号 | 说明 |
---|---|
dateChanged(QDate) | ⽇期改变时触发. |
timeChanged(QTime) | 时间改变时触发. |
dateTimeChanged(QDateTime) | 时间⽇期任意⼀个改变时触发. |
QDateTime
Qt中 QDateTime 提供了两个函数:
daysTo :计算两个时间的日期的差值
secsTo :计算两个时间的秒数的差值
示例:计算两个日期的差值
void Widget::on_pushButton_clicked()
{//1.获取到这两个输入框之间的时间QDateTime timeold = ui->dateTimeEdit->dateTime();QDateTime timenew = ui->dateTimeEdit_2->dateTime();//2.计算日期的差值int seconds = timeold.secsTo(timenew);//3.把秒数换算int days = seconds/3600 /24;int hour = seconds/3600 %24;//4.显示结果ui->label->setText(QString::number(days)+QString::number(hour));
}
这里不使用daysTo方法求两个日期天数的差值,是因为daysTo在同一天时间到第二天0点之间会多算一天.
Dial
核心属性
属性 | 说明 |
---|---|
value | 持有的数值 |
minimum | 最⼩值 |
maximum | 最⼤值 |
singleStep | 按下⽅向键的时候改变的步⻓ |
pageStep | 按下 pageUp / pageDown 的时候改变的步⻓ |
sliderPosition | 界⾯上旋钮显⽰的 初始位置 |
tracking | 外观是否会跟踪数值变化. 默认值为 true. ⼀般不需要修改. |
wrapping | 是否允许循环调整. 即数值如果超过最⼤值, 是否允许回到最⼩值. (调整过程能否 "套圈") |
notchesVisible | 是否显⽰ 刻度线 |
notchTarget | 刻度线之间的相对位置. 数字越⼤, 刻度线越稀疏 |
核心信号
属性 | 说明 |
---|---|
valueChanged(int) | 数值改变时触发 |
rangeChanged(int, int) | 范围变化时触发 |
Slider
QSlider 和 QDial 都是继承⾃ QAbstractSlider , 因此⽤法上基本相同.
核心属性
属性 | 说明 |
---|---|
value | 持有的数值. |
minimum | 最⼩值 |
maximum | 最⼤值 |
singleStep | 按下⽅向键的时候改变的步⻓ |
pageStep | 按下 pageUp / pageDown 的时候改变的步⻓ |
sliderPosition | 滑动条显⽰的 初始位置 |
tracking | 外观是否会跟踪数值变化. 默认值为 true. ⼀般不需要修改. |
orientation | 滑动条的⽅向是⽔平还是垂直 |
invertedAppearance | 是否要翻转滑动条的⽅向 |
tickPosition | 刻度的位置 |
tickInterval | 刻度的密集程度 |
核心信号
属性 | 说明 |
---|---|
valueChanged(int) | 数值改变时触发 |
rangeChanged(int, int) | 范围变化时触发 |
自定义快捷键 **
滑动条本身可以通过方向键和pageUp和pageDown操作,但是我们也可以通过slot来自定义快捷键,
代码示例:
#include "widget.h"
#include "ui_widget.h"
#include <QShortcut>
Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);//创建快捷键QShortcut* shortCut = new QShortcut(this);shortCut->setKey(QKeySequence("="));//使用信号槽,感知到快捷键被按下connect(shortCut,&QShortcut::activated,this,&Widget::subValue);
}Widget::~Widget()
{delete ui;
}void Widget::subValue()
{//获取当前值int value = ui->horizontalSlider->value();if(value >= ui->horizontalSlider->maximum()){return;}ui->horizontalSlider->setValue(value+5);
}