【C++ Qt】输入类控件（上） LineEdit、QTextEdit

溟洵2025-05-05 9:45


每日激励："不设限和自我肯定的心态：I can do all things。 --- Stephen Curry"
**绪论​：
本次分享聚焦 Qt 框架里常用的输入框组件，重点讲解 QLineEdit（单行输入框）和 QTextEdit（多行输入框）。先了解 QLineEdit 的核心属性，比如控制输入显示模式的 echoMode、限制输入格式的 inputMask，还有它提供的文本改变等信号，再通过个人信息输入、密码一致性验证等案例，掌握其实际用法。接着介绍支持多行输入及富文本、markdown 格式的 QTextEdit，了解它的关键属性和核心信号，通过获取内容、响应操作等案例，学会如何运用它。

早关注不迷路，话不多说安全带系好，发车啦（建议电脑观看）。**

Line Edit

QLineEdit ⽤来表⽰单⾏输⼊框。可以输⼊⼀段⽂本, 但是不能换⾏

核心属性：

属性 说明
text 输⼊框中的⽂本（用户直接修改界面上输入框中的文本，text也会改变）
inputMask 输⼊内容格式约束
maxLength 最⼤⻓度
frame 是否添加边框
echoMode 显⽰⽅式 QLineEdit::Normal ：这是默认值，⽂本框会显⽰输⼊的⽂本 QLineEdit::Password ：在这种模式下，输⼊的字符会被隐藏 ，通常**⽤星号（*）或等号（=）代替** 、 QLineEdit::NoEcho ：在这种模式下，⽂本框不会显⽰任何输⼊的字符
cursorPosition 光标所在位置
alignment ⽂字对⻬⽅式, 设置⽔平和垂直⽅向的对⻬.
dragEnabled 是否允许拖拽
readOnly 是否是只读的(不允许修改)
placeHolderText 当输⼊框内容为空的时候, 显⽰什么样的提⽰信息
clearButtonEnabled 是否会⾃动显⽰出 "清除按钮

核⼼信号

属性 说明
void cursorPositionChanged (intold, int new) 当⿏标移动时发出此信号，old为先前的位置，new为新位置。
void editingFinished() 当按返回或者回⻋键时，或者⾏编辑失去焦点时，发出此信号。
void returnPressed() 当返回或回⻋键按下时发出此信号. 如果设置了验证器, 必须要验证通过, 才能触发.
void selectionChanged() 当选中的⽂本改变时，发出此信号。
void textChanged(const QString &text) 当QLineEdit中的⽂本改变时，发出此信号，text是新的⽂本。 代码对⽂本的修改能够触发这个信号.
void textEdited(const QString &text)) 当QLineEdit中的⽂本改变时，发出此信号，text是新的⽂本。 代码对⽂本的修改不能触发这个信号.

实操1： 实例 个人信息（密码的隐藏）

用户输入个人信息：姓名、密码、性别、电话

将上述内容统一获取到

  1. ui文件 拖转 4个 label：姓名、...
  2. 再在对应的label后面添加 edit 、性别 提供 男女单选框
  3. 最终下面添加一个按钮：提交（具体如上图）
  4. 构造设置：
    1. 给输入框添加 placeholder（输入提示）
    2. 清空按钮 ClearButtonEnabled（当存在值时能够快速删除的按钮）
    3. 其中对于密码来说还要添加echomode模式设置为 QLineEdit::Password
    4. 手机号码，限制格式 InputMask（"000-0000-0000"）3-4-4的效果输入，他能更具输入框进行内容的简单校验
  5. 给按钮设置槽函数
    1. 控件调用text获取打印姓名、命名
    2. 性别通过控价调用isChecked获取（返回真假）再配合判断进行打印~

此处只是简单打印，实际开发可以将内容发给服务器

cpp 复制代码 
#include "widget.h"
#include "ui_widget.h"
#include <QDebug>
Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
    ui->lineEdit_name->setPlaceholderText("输入用户名");
    ui->lineEdit_name->setClearButtonEnabled(true);

    ui->lineEdit_pwd->setPlaceholderText("输入密码");
    ui->lineEdit_pwd->setClearButtonEnabled(true);
    ui->lineEdit_pwd->setEchoMode(QLineEdit::Password);//设置为密码的形式，这样当输入时就无法查看到了

    ui->lineEdit_tel->setPlaceholderText("输入手机号");
    ui->lineEdit_tel->setClearButtonEnabled(true);
    //限制手机号的格式，"000-0000-0000"
    ui->lineEdit_tel->setInputMask("000-0000-0000");//实现简单的校
}

Widget::~Widget()
{
    delete ui;
}

void Widget::on_pushButton_clicked()
{
    //获取值并打印查看
    qDebug() << ui->lineEdit_name->text() << " " <<ui->lineEdit_pwd->text()<< " " <<ui->lineEdit_tel->text();
    if(ui->radioButton->isChecked()){
        qDebug() << "男" ;
    }
    else if(ui->radioButton_2->isChecked()){
         qDebug() << "女" ;
    }
}

inputMask 功能比较有效，只能简单的验证

若想要更复杂的，就可以配合使用 "正则表达式"重新设定规则，它是谷歌带有特殊字符的字符串，特殊字符串用来表示另一个字符串的特性，就能借助正则表达式来描述处一些具有一定特定的字符串（基于这个特点，完成字符串的匹配）

（正则表达式的语法还⽐较复杂, ⼀般都是随⽤随查, 不需要背下来）

正则表达式⽂档
正则表达式在线⼯具

重新设定规则：

  1. 拖拽一个输入框和一个按钮

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

  3. 如果符合规则才将按钮设为可用状态、若不是则设为禁用状态

  4. 构造函数：

    1. 给单行输入框设置验证器，基于正则表达式
    2. QRegExp正则表达式对象，构造内容填写如下图

  5. 给编辑器控件注册验证器 ：setValidator

    1. 内部需要 new 上 QRegExpValidator对象并构造regExg对象
    2. 注意还需要包含QRegExpValidator的头文件

  6. 验证输入框的内容是否合法：

    1. 只要输入框的内容发生改变了
    2. 将edit输入框通过 textEdited 信号（内容修改） 创建信号槽
    3. 判断：
      1. 通过输入框调用 validator 验证器函数（返回一个对象）再调用 validate 函数得知是否验证通过
    4. 其中validate的参数：
      1. 第一个参数是要验证的字符串，参数类型是QString& （注意不能传const）
      2. 第二个参数是一个输出型参数，会返回不符合规则的字符串开始的位置
    5. 调用后返回判断是否等于 QValidator::Acceptable（验证通过）
    6. 若验证通过就将按钮设置为 Enabled（true）、反之设置为false

源码：

cpp 复制代码 
#include "widget.h"
#include "ui_widget.h"
#include <QDebug>
#include <QRegExp>
#include <QRegExpValidator>
#include <QValidator>
Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
    ui->lineEdit_name->setPlaceholderText("输入用户名");
    ui->lineEdit_name->setClearButtonEnabled(true);

    ui->lineEdit_pwd->setPlaceholderText("输入密码");
    ui->lineEdit_pwd->setClearButtonEnabled(true);
    ui->lineEdit_pwd->setEchoMode(QLineEdit::Password);//设置为密码的形式，这样当输入时就无法查看到了

    ui->lineEdit_tel->setPlaceholderText("输入手机号");
    ui->lineEdit_tel->setClearButtonEnabled(true);
    //限制手机号的格式，"000-0000-0000"
//    ui->lineEdit_tel->setInputMask("000-0000-0000");//实现简单的校验

    //设置验证器
    QRegExp reg("^1\\d{10}$");//^代表开始 以1开头再加上10个整数 &表示结束

    //给lineEdit注册一个验证器
    ui->lineEdit_tel->setValidator(new QRegExpValidator(reg));//注意需要加上 QRegExpValidator的头文件


}

Widget::~Widget()
{
    delete ui;
}


void Widget::on_pushButton_clicked()
{
    //获取值并打印查看
    qDebug() << ui->lineEdit_name->text() << " " <<ui->lineEdit_pwd->text()<< " " <<ui->lineEdit_tel->text();
    if(ui->radioButton->isChecked()){
        qDebug() << "男" ;
    }
    else if(ui->radioButton_2->isChecked()){
         qDebug() << "女" ;
    }
}

void Widget::on_lineEdit_tel_textEdited(const QString &arg1)//只要内容发送改变就会触发该信号
{
    QString str = arg1;
    int t;
    //通过输入框调用设置进去的validator进行判断是否符合
    if(ui->lineEdit_tel->validator()->validate(str,t) == QValidator::Acceptable){//符合条件会返回：QValidator::Acceptable
      ui->pushButton->setEnabled(true);
    }
}

实操2： 验证两次密码输入是否一样

  1. 打开ui文件 拖拽两个LineEdit
  2. 构造函数中进行初始化：
    1. 设置echoMode为密码模式
  3. 同样使用textEdited信号来进行判定是否有输入内容
  4. 再在顶上通过放上一个label内部执行判断，输入框的状态：
  5. 给两个输入框添加槽函数：
    1. 为空（s1.isEmpty & s2.isEmpty）、密码不一致、密码一致（s1 == s2）
    2. 搞一个compare公共函数存储上述判断内容
  6. （void）arg1：来避免不使用arg1带来的警告
cpp 复制代码 
#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);//设置为密码
    ui->lineEdit_2->setEchoMode(QLineEdit::Password);//设置为密码模式
}

Widget::~Widget()
{
    delete ui;
}

void Widget::compare(){
    QString str1 = ui->lineEdit->text();
    QString str2 = ui->lineEdit_2->text();
    if(str1.isEmpty() || str2.isEmpty()){
        ui->label->setText("请输入密码");
    }
    else if(str1 == str2){
        ui->label->setText("密码一致");
    }else{
        ui->label->setText("密码不一致");
    }
}

//当文本发送改变进行判断
void Widget::on_lineEdit_textEdited(const QString &arg1)
{
    (void) arg1;//使用arg1不要去除警告
    compare();
}


//当文本发送改变进行判断
void Widget::on_lineEdit_2_textEdited(const QString &arg1)
{
     (void) arg1;//使用arg1不要去除警告
    compare();
}

实操3：针对密码，让其可以通过一个按钮进行显示

  1. 拖拽check box、LinuxEdit
  2. 构造函数：
    1. 初始情况下，输入框的密码方式为密码模式
    2. 对显示密码的按钮，使用toggled信号编写槽（因为有个checked参数代表选中/每选中）
  3. 槽函数（右键快速生成）
    1. 判断checked
    2. 为true将输入框的显示模式setEchoMode设为"Normal"
    3. 为false则设置为"隐藏密码"状态

cpp 复制代码 
构造函数：
ui->lineEdit_3->setEchoMode(QLineEdit::Password);//设置为密码模式

槽函数：
void Widget::on_checkBox_toggled(bool checked)
{
    //其中的 checked 代表是否选中
    if(checked == true){
        //设置editline的模式
        ui->lineEdit_3->setEchoMode(QLineEdit::Normal);//Normal代表真常文本格式
    }else{
        ui->lineEdit_3->setEchoMode(QLineEdit::Password);
    }
}

QTextEdit

QTextEdit 表⽰多⾏输⼊框. 也是⼀个支持 富⽂本 & markdown 的编辑器

其中能显示多行的还有 QPlainTextEdit，但它不能支持富文本和markdown（本质差不多就不写了）

属性 说明
markdown 输⼊框内持有的内容. ⽀持 markdown 格式. 能够⾃动的对markdown ⽂本进⾏渲染成 html
html 输⼊框内持有的内容. 可以⽀持⼤部分 html 标签. 包括 img 和 table 等.
placeHolderText 输⼊框为空时提⽰的内容.
readOnly 是否是只读的
undoRedoEnable 是否开启 undo / redo 功能. 、按下 ctrl + z 触发 undo 、按下 ctrl + y 触发 redo
autoFormating 开启⾃动格式化.
tabstopWidth 按下缩进占多少空间
overwriteMode 是否开启覆盖写模式
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) ⽂本被选中/取消选中时触发

实操1：获取多⾏输⼊框的内容

  1. 拖拽TextEdit和label，使用 textChange 信号添加信号槽
  2. 获取文本（toPlainText）存放到text变量中
  3. 将text中的内容设置到label中
cpp 复制代码 
void Widget::on_textEdit_textChanged()
{
    //将textEdit中的内容放到label中
    QString text = ui->textEdit->toPlainText();//toPlainText
    ui->label->setText(text);
}

实操2：TextLabel中常用信号

  1. 拖拽个TextEdit
  2. 根据两个信号：textChanged、selectionChanged进行操作
  3. 在textChange（内容被修改时触发的信号）信号槽：
    1. 直接打印文本内容
  4. 在selectionChanged（内容被选择时触发的信号）中：
    1. 首先获取光标对象，通过控件调用 textCursor 获取光标选中文本
    2. 打印对象中的文本（selectedText）
  5. 其他信号：
  6. CursorPositionChanged（光标选择改变时触发的信号）
    1. 获取光标对象（方法同上）
    2. 打印光标的位置（光标对象调用position）
  7. undoAvailabel、redoAvailabel、copyAvailable
    1. 进行输入(ctrl + z)，撤销(ctrl + y)，撤销的撤销
    2. 打印查看 参数 b
cpp 复制代码 
//内容改变时触发
void Widget::on_textEdit_2_textChanged()
{
    qDebug() << ui->textEdit_2->toPlainText();
}

//鼠标选择改变时触发
void Widget::on_textEdit_2_selectionChanged()
{
    QTextCursor text = ui->textEdit_2->textCursor();
    qDebug() << text.selectedText();//selectedText查看光标选中的内容
}

//光标位置改变时触发
void Widget::on_textEdit_2_cursorPositionChanged()
{
    QTextCursor cursor = ui->textEdit_2->textCursor();//获取光标对象
    qDebug() << cursor.position();//打印光标下标的位置
}

//撤销时触发
void Widget::on_textEdit_2_undoAvailable(bool b)
{
    qDebug() << b;
}

//撤销的撤销时触发
void Widget::on_textEdit_2_redoAvailable(bool b)
{
    qDebug() << b;
}

//⽂本被选中/取消选中时触发
void Widget::on_textEdit_2_copyAvailable(bool b)
{
    qDebug() << b;
}


本章完。预知后事如何，暂听下回分解。

如果有任何问题欢迎讨论哈！

如果觉得这篇文章对你有所帮助的话点点赞吧！

持续更新大量C++ Qt细致内容，早关注不迷路。

​

相关推荐
Despacito0o2 分钟前
QMK固件烧录指南：安全高效地更新您的机械键盘
c语言·安全·计算机外设·qmk
学C岁月11 分钟前
BC19 反向输出一个四位数
c语言·开发语言·笔记
Wabi_sabi_x29 分钟前
C++设计模式：面向对象的八大设计原则之四
开发语言·c++·设计模式
大道归简38 分钟前
自动化实现web端Google SignUp——selenium
前端·selenium·自动化
SimpleLearingAI1 小时前
如何在纯C中实现类、继承和多态（小白友好版）
c语言·开发语言
用手码出世界1 小时前
【Linux】日志与策略模式、线程池
linux·运维·服务器·开发语言·c++·策略模式
汉克老师1 小时前
GESP2024年6月认证C++八级( 第一部分选择题（11-15））
c++·gesp八级·gesp8级
普通young man2 小时前
QT | 常用控件
开发语言·前端·qt
想不明白的过度思考者2 小时前
为了结合后端而学习前端的学习日志——【黑洞光标特效】
前端·学习
twodragon&primy2 小时前
CSS布局
开发语言·前端·css·算法·html5
热门推荐
01KGG转MP3工具|非KGM文件|解密音频02西电B测-计算机网络综合实验(含验收问题)03从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑04YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】05Coze扣子平台完整体验和实践（附国内和国际版对比）06DeepSeek各版本说明与优缺点分析07【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！08YOLOv8目标检测在RK3588部署全过程09苍穹外卖面试总结10【解决】Android Gradle Sync 报错 Could not read workspace metadata