桌面应用 / 系统课时
用 QLineEdit 接收单行输入
用 QLineEdit 接收单行输入
表单输入是桌面应用最基础的交互需求之一。QLineEdit 用于接收单行文本,例如用户名、搜索关键词、密码或配置参数。本篇将学习输入提示、读取文本、密码模式和长度限制等常用能力。
学习目标
- 掌握 QLineEdit 的基本创建和文本读取方式
- 理解占位文字、密码模式等输入配置
- 学会限制输入长度并处理用户输入
创建单行输入框
QLineEdit 是 Qt Widgets 中处理单行文本输入的核心控件。它内部维护当前文本内容,并通过信号通知文本变化。
下面示例创建输入框和按钮,点击按钮后读取用户输入。
cpp
#include <QApplication>
#include <QLineEdit>
#include <QPushButton>
#include <QDebug>
#include <QVBoxLayout>
#include <QWidget>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
auto *edit = new QLineEdit(&window);
auto *button = new QPushButton("读取", &window);
auto *layout = new QVBoxLayout(&window);
edit->setPlaceholderText("请输入用户名");
layout->addWidget(edit);
layout->addWidget(button);
QObject::connect(button, &QPushButton::clicked, [&]() {
qDebug() << edit->text();
});
window.show();
return app.exec();
}预期输出
text
用户输入 QtUser 后,控制台输出:
QtUser配置占位文字和输入限制
占位文字用于提示用户输入内容,在输入框为空时显示,不会成为实际文本。
cpp
edit->setPlaceholderText("请输入邮箱地址");如果业务要求限制输入长度,可以设置最大字符数:
cpp
edit->setMaxLength(20);例如用户名输入框通常需要限制长度,避免提交过大的数据。
设置密码输入模式
密码输入不应该直接显示原始字符。QLineEdit 通过输入模式控制显示效果。
cpp
edit->setEchoMode(QLineEdit::Password);设置后,用户输入内容会以隐藏字符显示。
预期结果
text
输入 abc123 时,界面显示隐藏字符。
调用 text() 时仍可以获取真实输入内容。常用模式包括:
| 模式 | 用途 |
|---|---|
| Normal | 普通文本输入 |
| Password | 密码输入 |
| PasswordEchoOnEdit | 编辑时显示,失去焦点后隐藏 |
| NoEcho | 不显示输入内容 |
处理输入变化事件
实际应用中通常需要在用户输入过程中进行校验,例如检查格式或实时搜索。
QLineEdit 提供 textChanged 信号:
cpp
QObject::connect(edit, &QLineEdit::textChanged, [](const QString &text) {
qDebug() << "当前输入:" << text;
});预期输出
text
用户输入 abc 时,控制台可能输出:
当前输入: "a"
当前输入: "ab"
当前输入: "abc"QLineEdit 适合处理简单文本输入。如果需要多行内容,应使用 QTextEdit;如果需要复杂格式编辑,应选择更专用的控件。
按自己的节奏,确认真正理解。