Qt6.2教程——6.QT常用控件QLineEdit

一，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的使用示例

1. 基本的QLineEdit使用：

#include <QApplication>
#include <QLineEdit>

int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    QLineEdit lineEdit;
    lineEdit.show();

    return app.exec();
}

2. 设置和获取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();
}

3. 设置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();
}

4. 设置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();
}

5. 连接信号和槽来处理文本改变事件：

#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中一个非常实用的控件，可以让用户输入和编辑单行文本。它的常用属性包括文本，最大长度，只读，占位符文本，回显模式和输入掩码。常用的方法包括设置和获取文本，清除文本，设置只读，设置最大长度，设置占位符文本，设置回显模式和设置输入掩码。常用的信号有文本改变，文本编辑和按下回车键。