桌面应用 / 系统课时

用 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;如果需要复杂格式编辑,应选择更专用的控件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 QLineEdit 接收单行输入

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通