目录
一、概述
QLineEdit 是 Qt 框架中的一个重要的输入框控件，用于接收用户的单行文本输入。它提供了丰富的功能和灵活的定制选项，广泛应用于各种需要用户输入文本信息的场景，如登录界面的用户名和密码输入框、表单填写中的文本字段等。
二、基本使用方法
2.1 创建 QLineEdit 实例
在 Qt 应用程序中，可以通过以下方式创建 QLineEdit 控件：
#include <QLineEdit>
// 在合适的函数或类成员函数中
QLineEdit *lineEdit = new QLineEdit(parentWidget); 其中，parentWidget 是 QLineEdit 的父窗口部件，如果没有明确的父部件，可以设置为 nullptr，但在实际应用中，通常将其作为其他布局或窗口的子部件，以便进行合理的布局管理。
2.2 设置文本内容
可以在创建后通过 setText 函数设置 QLineEdit 的初始文本：
lineEdit->setText("Initial Text");或者使用 insert 函数在当前文本的特定位置插入文本：
lineEdit->insert("Inserted Text");2.3 获取用户输入的文本
当用户在 QLineEdit 中输入文本后，可以通过 text 函数获取输入的内容：
QString userInput = lineEdit->text();三、常见属性设置
3.1 显示模式
QLineEdit 支持多种显示模式，以适应不同的输入需求，例如：
- 普通文本模式（Normal）：这是默认模式，用户输入的文本以明文形式显示。
lineEdit->setEchoMode(QLineEdit::Normal);- 密码模式（Password）：用于输入密码等敏感信息，输入的文本将以特定的密码掩码（如星号 *）显示，以保护隐私。
lineEdit->setEchoMode(QLineEdit::Password);- 密码不回显模式（PasswordEchoOnEdit）：在编辑时显示明文，失去焦点后变为密码掩码形式，适用于需要用户确认密码输入的场景。
lineEdit->setEchoMode(QLineEdit::PasswordEchoOnEdit);- 无回显模式（NoEcho）：输入的文本不显示任何内容，常用于需要秘密输入的情况，如输入 PIN 码等。
lineEdit->setEchoMode(QLineEdit::NoEcho);3.2 文本对齐方式
可以设置文本在 QLineEdit 中的对齐方式，包括左对齐、右对齐和居中对齐：
// 左对齐
lineEdit->setAlignment(Qt::AlignLeft);
// 右对齐
lineEdit->setAlignment(Qt::AlignRight);
// 居中对齐
lineEdit->setAlignment(Qt::AlignCenter); 3.3 只读属性
通过设置 setReadOnly 函数，可以将 QLineEdit 设置为只读模式，用户无法编辑其中的文本，但仍可以查看：
lineEdit->setReadOnly(true);四、信号与槽
QLineEdit 提供了多个信号，以便在用户与输入框进行交互时发出通知，开发者可以通过连接这些信号到相应的槽函数来实现特定的功能。
4.1 textChanged 信号
当 QLineEdit 中的文本发生改变时，会发出 textChanged 信号，传递当前的文本内容作为参数。这对于实时验证用户输入的合法性或根据输入内容动态更新界面其他部分非常有用。
connect(lineEdit, &QLineEdit::textChanged, [](const QString &text) {
// 在这里处理文本改变后的逻辑
qDebug() << "Text changed: " << text;
});4.2 editingFinished 信号
当用户完成编辑（例如按下回车键或失去焦点）时，会发出 editingFinished 信号。这个信号可以用于在用户完成输入后进行一些后续操作，如提交表单数据或验证输入的完整性。
connect(lineEdit, &QLineEdit::editingFinished, []() {
qDebug() << "Editing finished.";
// 执行提交或验证等操作
});4.3 returnPressed 信号
当用户在 QLineEdit 中按下回车键时，会发出 returnPressed 信号。这对于处理用户输入完成并希望立即执行某个操作的情况很方便，比如在命令行输入框中执行命令。
connect(lineEdit, &QLineEdit::returnPressed, []() {
qDebug() << "Return key pressed.";
// 执行与回车键相关的操作
});五、验证器和输入掩码
5.1 验证器（QValidator）
为了确保用户输入的数据符合特定的格式或范围要求，可以使用验证器。Qt 提供了几种预定义的验证器，如 QIntValidator（用于整数验证）、QDoubleValidator（用于浮点数验证）和 QRegExpValidator（基于正则表达式的验证）。
例如，使用 QIntValidator 限制用户只能输入特定范围内的整数：
QIntValidator *validator = new QIntValidator(1, 100, lineEdit);
lineEdit->setValidator(validator);上述代码将 QLineEdit 的输入限制在 1 到 100 之间的整数。当用户输入不符合要求的文本时，QLineEdit 将阻止输入或显示提示信息（取决于平台和设置）。
5.2 输入掩码（Input Mask）
输入掩码提供了一种更灵活的方式来控制用户的输入格式。通过设置输入掩码，可以指定每个输入位置的允许字符类型和格式。
例如，设置一个日期格式的输入掩码：
lineEdit->setInputMask("99/99/9999"); 这样，用户在输入时将被限制按照 dd/mm/yyyy 的格式输入日期，其中 9 表示数字是可选的输入字符，其他字符（如 /）是固定的分隔符。输入掩码还支持其他占位符和修饰符，以满足各种复杂的输入格式要求。
六、样式设置
可以通过样式表（QSS - Qt Style Sheets）对 QLineEdit 的外观进行定制，包括背景颜色、字体、边框等。
例如，设置 QLineEdit 的背景颜色为淡蓝色，边框为红色虚线：
lineEdit->setStyleSheet("QLineEdit { background-color: lightblue; border: 1px dashed red; }");还可以设置当 QLineEdit 获得焦点时的样式，以提供更好的用户交互反馈：
lineEdit->setStyleSheet("QLineEdit { background-color: lightblue; border: 1px dashed red; }"
"QLineEdit:focus { border: 2px solid green; }");这样，当 QLineEdit 获得焦点时，边框将变为绿色的实线，增强了界面的交互性和美观性。
七、布局中的应用
在实际的 Qt 应用程序界面设计中，QLineEdit 通常与其他控件一起放置在布局管理器中，以实现合理的界面布局。
例如，可以将一个 QLineEdit 和一个 QLabel（用于显示提示信息）水平排列在一个 QHBoxLayout 中：
QLabel *label = new QLabel("Username:");
QLineEdit *lineEdit = new QLineEdit;
QHBoxLayout *layout = new QHBoxLayout;
layout->addWidget(label);
layout->addWidget(lineEdit);
QWidget *parentWidget = new QWidget;
parentWidget->setLayout(layout);通过这种方式，QLineEdit 可以与其他界面元素协同工作，构建出完整、友好的用户界面。
八、高级功能和扩展
8.1 自动补全（QCompleter）
QLineEdit 可以结合 QCompleter 类实现自动补全功能，为用户提供可能的输入建议，提高输入效率。首先，创建一个 QStringList 来存储可能的补全选项：
QStringList wordList;
wordList << "apple" << "banana" << "cherry" << "date";
QCompleter *completer = new QCompleter(wordList, lineEdit);
lineEdit->setCompleter(completer);这样，当用户在 QLineEdit 中输入时，如果输入的前缀与 wordList 中的某个单词匹配，QCompleter 将自动弹出一个下拉列表，显示可能的补全选项，用户可以通过上下箭头键选择并补全输入。
8.2 文字拖放操作支持
QLineEdit 可以通过重写一些事件处理函数来支持拖放操作，允许用户从其他地方拖动文本并放置到 QLineEdit 中，或者从 QLineEdit 中拖动文本到其他支持拖放的应用程序中。这涉及到处理 dragEnterEvent、dropEvent 等事件，以实现自定义的拖放行为，为用户提供更便捷的交互体验，但实现过程相对复杂，需要深入了解 Qt 的事件处理机制。
#include <QLineEdit>
#include <QDrag>
#include <QMimeData>
#include <QMouseEvent>
#include <QApplication>
class DragDropLineEdit : public QLineEdit
{
public:
DragDropLineEdit(QWidget *parent = nullptr) : QLineEdit(parent)
{
// 启用接受拖放操作
setAcceptDrops(true);
}
protected:
// 当拖放操作进入 QLineEdit 时触发
void dragEnterEvent(QDragEnterEvent *event) override
{
// 判断拖放的数据是否为文本，如果是则接受该拖放操作
if (event->mimeData()->hasText()) {
event->acceptProposedAction();
} else {
event->ignore();
}
}
// 当拖放操作在 QLineEdit 内移动时触发
void dragMoveEvent(QDragMoveEvent *event) override
{
// 设置拖放操作的移动动作
event->setDropAction(Qt::MoveAction);
event->accept();
}
// 当在 QLineEdit 上放下拖放的数据时触发
void dropEvent(QDropEvent *event) override
{
// 获取拖放的数据并将其设置为 QLineEdit 的文本
if (event->mimeData()->hasText()) {
setText(event->mimeData()->text());
event->acceptProposedAction();
} else {
event->ignore();
}
}
// 当鼠标按下并移动时触发，用于开始拖放操作
void mouseMoveEvent(QMouseEvent *event) override
{
if (!(event->buttons() & Qt::LeftButton))
return;
if ((event->pos() - dragStartPosition).manhattanLength() < QApplication::startDragDistance())
return;
QDrag *drag = new QDrag(this);
QMimeData *mimeData = new QMimeData;
mimeData->setText(text());
drag->setMimeData(mimeData);
// 开始拖放操作
drag->exec(Qt::CopyAction | Qt::MoveAction);
}
private:
QPoint dragStartPosition;
};
// 示例代码：
#include <QVBoxLayout>
#include <QWidget>
#include <QApplication>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget *widget = new QWidget;
QVBoxLayout *layout = new QVBoxLayout(widget);
DragDropLineEdit *lineEdit1 = new DragDropLineEdit;
DragDropLineEdit *lineEdit2 = new DragDropLineEdit;
layout->addWidget(lineEdit1);
layout->addWidget(lineEdit2);
widget->show();
return app.exec();
}代码解释：
- 首先，我们创建了一个名为 DragDropLineEdit 的类，它继承自 QLineEdit。
- 在构造函数中，通过 setAcceptDrops(true) 启用了该 QLineEdit 对拖放操作的接受能力。
- dragEnterEvent 函数：检查拖放操作携带的数据是否为文本，如果是，则接受该拖放操作，否则忽略。
- dragMoveEvent 函数：将拖放操作的动作设置为 Qt::MoveAction，并接受该操作。
- dropEvent 函数：当拖放的数据是文本时，将其设置为 QLineEdit 的文本并接受该操作。
- mouseMoveEvent 函数：当用户按下鼠标左键并移动一定距离（通过 QApplication::startDragDistance() 确定）时，开始拖放操作。
- 创建 QDrag 对象和 QMimeData 对象，将当前 QLineEdit 的文本存储在 QMimeData 中，使用 drag->exec(Qt::CopyAction | Qt::MoveAction) 启动拖放操作。
- 在 main 函数中，我们创建了一个 QWidget 和 QVBoxLayout，并添加了两个 DragDropLineEdit 实例，以演示拖放操作。
实现效果：
总结
QLineEdit 控件在 Qt 应用程序开发中具有重要地位，通过灵活运用其各种属性、信号与槽机制、验证器、输入掩码、样式设置以及与其他类的结合使用，可以创建出功能强大、用户体验良好的文本输入界面，满足各种不同的应用需求。无论是简单的文本输入框还是复杂的表单填写界面，QLineEdit 都能提供可靠且高效的解决方案，是 Qt 开发者必须熟练掌握的控件之一。
如需更多信息，建议查阅Qt官方文档：
