一，QLineEdit简介
QLineEdit是Qt库中的一个控件，它提供了一个单行的文本输入框。用户可以在这个输入框中输入和编辑文本。它可以设置占位符文本（Placeholder Text），当QLineEdit为空的时候显示这个占位符文本。它还可以设置回显模式（Echo Mode），例如可以设置为密码模式，输入的内容不显示出来。此外，QLineEdit还有验证器（Validator）和输入掩码（Input Mask）功能，可以限制用户输入的内容。
二，QLineEdit的常用属性，方法和信号
属性：
| 属性 | 描述 |
|---|---|
| text | QLineEdit中的文本内容 |
| maxLength | 可以输入的最大字符数 |
| readOnly | 设置为只读模式，用户无法编辑内容 |
| placeholderText | 当QLineEdit为空时显示的占位符文本 |
| echoMode | 回显模式，可以设置为正常，无回显，密码和密码回显 |
| inputMask | 输入掩码，用于限制用户输入的内容 |
方法：
| 方法 | 描述 |
|---|---|
| setText | 设置QLineEdit中的文本内容 |
| clear | 清除QLineEdit中的文本内容 |
| setReadOnly | 设置为只读模式 |
| setMaxLength | 设置可以输入的最大字符数 |
| setPlaceholderText | 设置占位符文本 |
| setEchoMode | 设置回显模式 |
| setInputMask | 设置输入掩码 |
信号：
| 信号 | 描述 |
|---|---|
| textChanged | 当QLineEdit中的文本改变时发出 |
| textEdited | 当用户编辑QLineEdit中的文本时发出 |
| returnPressed | 当用户按下回车键时发出 |
三，QLineEdit的使用示例
- 基本的QLineEdit使用：
#include <QApplication>
#include <QLineEdit>
int main(int argc, char **argv)
{
QApplication app(argc, argv);
QLineEdit lineEdit;
lineEdit.show();
return app.exec();
}
- 设置和获取QLineEdit中的文本：
#include <QApplication>
#include <QLineEdit>
int main(int argc, char **argv)
{
QApplication app(argc, argv);
QLineEdit lineEdit;
lineEdit.setText("Hello World");
QString text = lineEdit.text();
lineEdit.show();
return app.exec();
}
- 设置QLineEdit为只读：
#include <QApplication>
#include <QLineEdit>
int main(int argc, char **argv)
{
QApplication app(argc, argv);
QLineEdit lineEdit;
lineEdit.setReadOnly(true);
lineEdit.show();
return app.exec();
}
- 设置QLineEdit的占位符文本：
#include <QApplication>
#include <QLineEdit>
int main(int argc, char **argv)
{
QApplication app(argc, argv);
QLineEdit lineEdit;
lineEdit.setPlaceholderText("Enter your text here");
lineEdit.show();
return app.exec();
}
- 连接信号和槽来处理文本改变事件：
#include <QApplication>
#include <QLineEdit>
#include <QDebug>
void handleTextChanged(const QString &text) {
qDebug() << "Text changed:" << text;
}
int main(int argc, char **argv)
{
QApplication app(argc, argv);
QLineEdit lineEdit;
QObject::connect(&lineEdit, &QLineEdit::textChanged, handleTextChanged);
lineEdit.show();
return app.exec();
}
四，QLineEdit总结
QLineEdit是Qt中一个非常实用的控件，可以让用户输入和编辑单行文本。它的常用属性包括文本，最大长度，只读，占位符文本，回显模式和输入掩码。常用的方法包括设置和获取文本，清除文本，设置只读，设置最大长度，设置占位符文本，设置回显模式和设置输入掩码。常用的信号有文本改变，文本编辑和按下回车键。