QT编程(10): QLineEdit

一、QLineEdit核心定义与继承关系QLineEdit是Qt Widgets模块中最基础、最常用的单行文本输入与显示控件专门用于处理短文本内容的交互仅支持单行纯文本输入不支持换行和富文本格式是Qt界面开发中短文本交互的核心组件几乎所有需要简短文本录入的场景都会用到该控件。继承体系QLineEdit 直接继承自 QWidget属于基础桌面控件不自带滚动区域文本过长时会自动显示省略号或支持光标横向滚动结构轻量化内存占用低、渲染速度快适配各类轻量化短文本交互需求。核心定位主打单行纯文本交互兼顾输入与展示双重功能默认支持用户编辑也可设为只读模式用于展示短文本信息自带基础输入校验、输入提示、快捷键等便捷功能无需复杂配置即可满足大部分短文本交互需求。二、核心功能与特性1. 基础文本交互特性纯单行文本限制严格限制单行输入不支持回车换行输入内容超出控件宽度时会自动横向滚动显示不会自动换行或撑开控件高度保证界面布局规整。纯文本模式仅支持无格式纯文本不兼容HTML、Markdown等富文本输入内容仅保留文字本身无字体、颜色、段落等格式属性适配所有标准化短文本输入场景。基础编辑功能自带复制、剪切、粘贴、撤销、重做、全选、清空等基础编辑操作支持CtrlC/CtrlV等标准快捷键无需额外编写代码实现基础编辑逻辑。2. 实用输入控制与校验功能输入掩码支持自定义输入掩码强制用户按照指定格式输入比如手机号、身份证号、日期、邮编、IP地址等固定格式内容杜绝无效输入。最大长度限制可设置最大输入字符数限制文本长度避免超长内容输入适配数据库字段长度、表单规范等硬性要求。只读/禁用模式setReadOnly(true)设为只读用户可选中复制但无法编辑setEnabled(false)设为禁用完全禁止交互适合展示固定短文本或临时锁定输入框。密码模式支持密码输入模式可将输入内容替换为圆点、星号等占位符保护隐私信息是登录界面密码框的首选实现方式。3. 交互体验优化特性占位提示文本支持设置placeholder占位提示文字输入框为空时显示提示内容用户开始输入后自动隐藏引导用户规范输入提升界面易用性。文本对齐与选中支持左对齐、居中、右对齐三种文本对齐方式点击控件可自动全选内容也可通过代码控制文本选中范围和光标位置。自动补全功能搭配QCompleter类实现输入自动补全比如搜索历史、常用词条、固定选项补全大幅提升输入效率。清除按钮可开启内置清除按钮输入内容后自动显示点击一键清空无需手动选中删除优化用户操作流程。三、核心常用APIC版本使用前需引入头文件#include QLineEditqmake项目需添加QT widgetsCMake项目需链接Qt6::Widgets基础配置简单开箱即用。1. 文本设置与获取API函数功能说明setText(const QString text)设置控件显示的纯文本内容清空原有内容无格式保留text()获取控件内的纯文本字符串最常用的内容获取接口clear()一键清空所有输入内容操作便捷placeholderText()获取当前设置的占位提示文本setPlaceholderText(const QString)设置占位提示文本输入为空时显示2. 输入控制与模式设置setReadOnly(bool)设置只读模式true为不可编辑false为可编辑setMaxLength(int)设置最大输入字符数超出部分无法输入setEchoMode(QLineEdit::EchoMode)设置输入显示模式支持正常、密码、密码字符切换、无显示四种模式setInputMask(const QString)设置输入掩码规范输入格式setClearButtonEnabled(bool)开启/关闭内置清除按钮3. 样式与对齐设置setAlignment(Qt::Alignment)设置文本对齐方式可选Qt::AlignLeft、Qt::AlignCenter、Qt::AlignRightsetFont(const QFont)设置文本字体、字号、加粗等基础样式setTextColor(const QColor)设置文本颜色Qt高版本支持低版本可通过样式表实现4. 核心常用信号信号是QLineEdit交互逻辑的核心通过绑定信号实现输入监听、确认、校验等功能常用信号如下textChanged(const QString text)文本内容每次发生变化时触发实时监听输入内容适合实时校验、实时搜索场景textEdited(const QString text)仅用户手动编辑内容时触发代码调用setText不会触发区分手动与代码赋值场景editingFinished()输入完成后触发比如按下回车、点击其他控件失去焦点时适合表单提交、输入确认场景returnPressed()按下回车键时触发适配快速确认、搜索提交场景selectionChanged()文本选中范围发生变化时触发四、适用场景表单录入场景用户名、密码、昵称、手机号、邮箱、邮编、验证码、IP地址、端口号等短文本输入搜索查询场景顶部搜索框、筛选条件输入框、关键词录入框参数配置场景软件配置项输入、路径填写、数值录入、固定参数设置短文本展示场景只读模式展示单个参数、状态信息、简短提示语五、QLineEdit与同类文本控件区别1. QLineEdit vs QTextEditQLineEdit是单行纯文本控件轻量化、无富文本、不支持换行适合短文本输入内存占用极低QTextEdit是多行富文本编辑器支持换行、富文本、滚动适合长篇内容功能更复杂内存占用更高二者适用场景完全互补短文本必选QLineEdit长文本/富文本选QTextEdit。2. QLineEdit vs QPlainTextEditQPlainTextEdit是多行纯文本控件支持换行和滚动主打长篇纯文本编辑比如代码、日志支持多行输入QLineEdit仅支持单行专注短文本交互输入校验和快捷功能更贴合短文本场景二者均为纯文本但单行与多行的定位差异明显。3. QLineEdit vs QTextBrowserQTextBrowser是只读富文本展示控件继承自QTextEdit支持链接跳转和富文本专门用于展示内容QLineEdit支持编辑仅纯文本单行展示/输入适合可交互短文本不可用于长篇或带格式内容展示。六、简单使用示例// 创建QLineEdit控件指定父对象QLineEdit*lineEditnewQLineEdit(this);// 设置占位提示文本lineEdit-setPlaceholderText(请输入用户名/手机号);// 设置最大输入长度20字符lineEdit-setMaxLength(20);// 开启清除按钮lineEdit-setClearButtonEnabled(true);// 设置文本左对齐lineEdit-setAlignment(Qt::AlignLeft);// 绑定输入完成信号处理输入内容connect(lineEdit,QLineEdit::editingFinished,this,[](){// 获取输入内容QString inputTextlineEdit-text();qDebug()用户输入内容inputText;});// 密码框示例QLineEdit*pwdEditnewQLineEdit(this);pwdEdit-setPlaceholderText(请输入密码);// 设置为密码显示模式pwdEdit-setEchoMode(QLineEdit::Password);// 调整控件位置大小pwdEdit-setGeometry(10,50,300,30);开发避坑小贴士1. 禁止用QLineEdit实现多行文本输入强行换行会导致显示异常需改用QPlainTextEdit2. 密码输入务必使用Password模式切勿用普通模式明文存储3. 表单校验优先用textChanged实时监听最终确认用editingFinished信号4. 大量短文本输入场景用QLineEdit性能远优于多行控件。