C++ Qt的QLineEdit控件详解

一、QLineEdit控件概述

QLineEdit是Qt框架中最常用的控件之一，它是一个单行文本编辑框，主要用于接收用户的文本输入。无论是用户登录界面的用户名和密码输入框，还是搜索框、表单输入等场景，QLineEdit都扮演着重要角色【7†source】。

与多行文本编辑器QTextEdit不同，QLineEdit专门设计用于单行文本输入，这使得它在处理简单输入任务时更加轻量和高效。通过灵活的属性设置和样式定制，QLineEdit可以适应各种UI设计需求【7†source】。

二、常用属性设置详解

1. 基本文本属性

1.1 文本内容设置与获取

QLineEdit提供了多种方法来设置和获取文本内容：

// 设置文本内容
lineEdit->setText("Hello, Qt!");
// 获取文本内容
QString text = lineEdit->text();

1.2 文本最大长度限制

使用maxLength()函数可以限制用户输入的最大字符数：

// 获取当前设置的最大长度
int maxLen = lineEdit->maxLength();
// 设置最大长度为10个字符
lineEdit->setMaxLength(10);

这在需要限制输入长度的场景中非常有用，如手机号码、邮政编码等固定长度的输入【5†source】【8†source】。

1.3 占位文本（Placeholder Text）

占位文本是当输入框为空时显示的提示文本，它不会作为实际内容：

// 设置占位文本
lineEdit->setPlaceholderText("请输入用户名...");

2. 显示模式属性

2.1 回显模式（Echo Mode）

通过设置回显模式，可以控制输入文本的显示方式，这在密码输入等场景中特别有用：

// 设置回显模式
// QLineEdit::Normal - 正常显示输入的字符（默认）
// QLineEdit::NoEcho - 不显示任何内容，但仍然可以复制
// QLineEdit::Password - 显示为密码字符（通常为*或●）
// QLineEdit::PasswordEchoOnEdit - 编辑时显示正常字符，失去焦点后显示为密码字符
lineEdit->setEchoMode(QLineEdit::Password);

这种属性设置使得QLineEdit可以灵活处理各种敏感信息的输入需求【5†source】【8†source】。

2.2 只读模式

// 设置为只读模式
lineEdit->setReadOnly(true);
// 获取是否为只读模式
bool isReadOnly = lineEdit->isReadOnly();

3. 输入验证属性

3.1 输入掩码（Input Mask）

输入掩码是一种强大的输入格式化工具，可以强制用户按照特定格式输入：

// 设置电话号码输入掩码（中国格式）
lineEdit->setInputMask("+86 000 0000 0000");
// 设置日期输入掩码
lineEdit->setInputMask("0000-99-99");
// 清除输入掩码
lineEdit->setInputMask("");

输入掩码可以确保用户输入的数据格式正确，减少数据验证的工作量【5†source】。

3.2 验证器（Validator）

验证器可以更灵活地控制用户输入的内容：

// 整数验证器（0-100）
QIntValidator *intValidator = new QIntValidator(0, 100, this);
lineEdit->setValidator(intValidator);
// 浮点数验证器
QDoubleValidator *doubleValidator = new QDoubleValidator(0.0, 100.0, 2, this);
lineEdit->setValidator(doubleValidator);
// 正则表达式验证器（只允许输入字母和数字）
QRegularExpressionValidator *regexValidator = new QRegularExpressionValidator(QRegularExpression("^[A-Za-z0-9]+$"), this);
lineEdit->setValidator(regexValidator);

通过验证器，可以确保用户输入符合特定规则，如只能输入数字、英文字母等【5†source】【8†source】。

三、文本对齐方式详解

文本对齐方式决定了QLineEdit内部文本的显示位置，通过setAlignment()函数进行设置：

1. 水平对齐方式

// 水平左对齐（默认）
lineEdit->setAlignment(Qt::AlignLeft);
// 水平居中对齐
lineEdit->setAlignment(Qt::AlignHCenter);
// 水平右对齐
lineEdit->setAlignment(Qt::AlignRight);
// 水平两端对齐
lineEdit->setAlignment(Qt::AlignJustify);

2. 垂直对齐方式

// 垂直上对齐
lineEdit->setAlignment(Qt::AlignTop);
// 垂直居中对齐（默认）
lineEdit->setAlignment(Qt::AlignVCenter);
// 垂直下对齐
lineEdit->setAlignment(Qt::AlignBottom);

3. 组合对齐方式

可以同时设置水平和垂直对齐：

// 文本居中显示
lineEdit->setAlignment(Qt::AlignHCenter | Qt::AlignVCenter);
// 文本右下角显示
lineEdit->setAlignment(Qt::AlignRight | Qt::AlignBottom);

文本对齐属性（alignment）表示显示文本的对齐方式，通过这些设置可以创建更加美观和用户友好的界面【1†source】【3†source】【4†source】。

四、正则表达式控制详解

正则表达式是文本处理的强大工具，在QLineEdit中可以通过多种方式应用正则表达式来控制输入。

1. 使用QRegularExpressionValidator

// 只允许输入电子邮件地址
QRegularExpressionValidator *emailValidator = new QRegularExpressionValidator(
QRegularExpression(R"([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,})"),
this
);
lineEdit->setValidator(emailValidator);
// 只允许输入IP地址
QRegularExpressionValidator *ipValidator = new QRegularExpressionValidator(
QRegularExpression(R"(^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$)"),
this
);
lineEdit->setValidator(ipValidator);

2. 使用QInputMask结合正则表达式

虽然输入掩码本身不直接支持正则表达式，但可以通过组合使用实现更复杂的输入控制：

// 创建一个自定义的输入验证器类
class CustomValidator : public QValidator {
public:
explicit CustomValidator(QObject *parent = nullptr) : QValidator(parent) {}
State validate(QString &input, int &pos) const override {
QRegularExpression regex("^[A-Za-z0-9]+$");
if (regex.match(input).hasMatch()) {
return Acceptable;
}
return Intermediate;
}
};
// 使用自定义验证器
lineEdit->setValidator(new CustomValidator(this));

3. 实时正则匹配反馈

可以通过信号槽机制实现实时正则匹配反馈：

// 连接textChanged信号
connect(lineEdit, &QLineEdit::textChanged, [](const QString &text) {
QRegularExpression regex("^[A-Za-z0-9]+$");
if (regex.match(text).hasMatch()) {
qDebug() << "输入符合要求";
lineEdit->setStyleSheet(""); // 清除样式
} else {
qDebug() << "输入不符合要求";
lineEdit->setStyleSheet("background-color: #ffcccc;"); // 设置错误样式
}
});

通过这些正则表达式控制技术，可以确保用户输入的数据格式正确，提高数据质量和用户体验【8†source】。

五、样式设置详解

QSS（Qt Style Sheets）是Qt提供的样式表功能，类似于网页开发中的CSS，可以用来定制QLineEdit的外观。

1. 基本样式设置

// 设置背景色
lineEdit->setStyleSheet("background-color: #f0f0f0;");
// 设置文本颜色
lineEdit->setStyleSheet("color: #333333;");
// 设置边框
lineEdit->setStyleSheet("border: 1px solid #cccccc;");
// 设置圆角边框
lineEdit->setStyleSheet("border: 1px solid #cccccc; border-radius: 5px;");
// 设置内边距
lineEdit->setStyleSheet("padding: 5px;");

2. 焦点状态样式

// 焦点状态样式
lineEdit->setStyleSheet(
"QLineEdit {"
"   background-color: #ffffff;"
"   border: 1px solid #cccccc;"
"   border-radius: 3px;"
"   padding: 5px;"
"}"
"QLineEdit:focus {"
"   border: 1px solid #0078d7;"
"   background-color: #f0f8ff;"
"}"
);

3. 只读状态样式

// 只读状态样式
lineEdit->setStyleSheet(
"QLineEdit {"
"   background-color: #f9f9f9;"
"}"
"QLineEdit[readOnly=\"true\"] {"
"   background-color: #eeeeee;"
"   color: #666666;"
"}"
);

4. 错误状态样式

// 错误状态样式
lineEdit->setStyleSheet(
"QLineEdit {"
"   border: 1px solid #cccccc;"
"}"
"QLineEdit.error {"
"   border: 1px solid #ff0000;"
"   background-color: #ffeeee;"
"}"
);
// 动态设置错误状态
lineEdit->setProperty("error", true);
lineEdit->style()->unpolish(lineEdit);
lineEdit->style()->polish(lineEdit);
lineEdit->update();

5. 高级样式技巧

5.1 渐变背景

// 设置渐变背景
lineEdit->setStyleSheet(
"QLineEdit {"
"   background: qlineargradient(x1:0, y1:0, x2:0, y2:1, "
"                               stop:0 #f6f7fa, stop:1 #dadbde);"
"}"
);

5.2 自定义占位符文本样式

// 自定义占位符文本样式
lineEdit->setStyleSheet(
"QLineEdit {"
"   color: #333333;"
"}"
"QLineEdit::placeholder {"
"   color: #999999;"
"}"
);

5.3 图标装饰

// 添加左侧搜索图标
lineEdit->setStyleSheet(
"QLineEdit {"
"   border: 1px solid #cccccc;"
"   padding-left: 20px;"
"   background-image: url(:/images/search.png);"
"   background-repeat: no-repeat;"
"   background-position: center left;"
"}"
);

通过这些样式设置技巧，可以创建出美观且符合品牌风格的QLineEdit控件，提升应用程序的整体用户体验【6†source】【9†source】。

六、综合应用示例

下面是一个综合运用上述知识的示例，创建一个功能完善的用户名输入框：

// 创建用户名输入框
QLineEdit *usernameEdit = new QLineEdit(this);
// 设置基本属性
usernameEdit->setPlaceholderText("请输入用户名（3-16位字母、数字或下划线）");
usernameEdit->setMaxLength(16);
// 设置验证器
QRegularExpressionValidator *usernameValidator = new QRegularExpressionValidator(
QRegularExpression("^[a-zA-Z0-9_]{3,16}$"),
this
);
usernameEdit->setValidator(usernameValidator);
// 设置对齐方式
usernameEdit->setAlignment(Qt::AlignLeft | Qt::AlignVCenter);
// 设置样式
usernameEdit->setStyleSheet(
"QLineEdit {"
"   border: 1px solid #cccccc;"
"   border-radius: 4px;"
"   padding: 5px 8px;"
"   background-color: #ffffff;"
"}"
"QLineEdit:focus {"
"   border: 1px solid #0078d7;"
"   background-color: #f0f8ff;"
"}"
"QLineEdit[error=\"true\"] {"
"   border: 1px solid #ff0000;"
"   background-color: #ffeeee;"
"}"
);
// 连接信号槽
connect(usernameEdit, &QLineEdit::textChanged, this, [usernameEdit](const QString &text) {
QRegularExpression regex("^[a-zA-Z0-9_]{3,16}$");
if (regex.match(text).hasMatch()) {
usernameEdit->setProperty("error", false);
} else {
usernameEdit->setProperty("error", true);
}
usernameEdit->style()->unpolish(usernameEdit);
usernameEdit->style()->polish(usernameEdit);
usernameEdit->update();
});

七、总结

QLineEdit作为Qt框架中最常用的控件之一，通过灵活的属性设置、文本对齐方式、正则表达式控制和样式设置，可以满足各种输入场景的需求。掌握这些技巧，可以帮助开发者创建出更加用户友好、功能完善的用户界面。

在实际开发中，应根据具体需求选择合适的属性和样式，平衡功能性和美观性。同时，良好的用户体验设计也是成功应用的重要因素，合理的输入验证和即时反馈可以大大提升用户满意度。