Qt QLineEdit单行输入框用法详解

已剪辑自: http://c.biancheng.net/view/vip_9655.html

QLineEdit 是 Qt 提供的一个控件类，它直接继承自 QWdiget 类，专门用来创建单行输入框，如下图所示：

图 1 单行文本输入框

实际开发中，我们经常用到 QLineEdit 输入框，比如接收用户输入的个人信息、账户信息、角色名称等，就可以用 QLineEdit 实现。

QLineEdit单行输入框的创建

每个单行输入框都是 QLineEdit 类的一个实例对象，QLineEdit 类提供有两个构造函数，分别是：

QLineEdit(QWidget *parent = Q_NULLPTR)
QLineEdit(const QString &contents, QWidget *parent = Q_NULLPTR)

contents 参数用于指定输入框中的文本内容；parent 参数用于指定新建输入框控件的父窗口，新建输入框将会内嵌到父窗口上，作为父窗口的一个子控件。当然，我们也可以不指定父窗口，那么新建的输入框就会作为独立的窗口。

在 QLineEdit 输入框中，用户可以直接输入一行文本，也可以粘贴一行文本，还可以修改输入框内的文本。某些实际场景中，QLineEdit 输入框还可以对用户输入的内容加以限定，比如：

• 限定文本的长度，例如用户最多可以输入 20 个字符；
• 输入文本的格式，例如用户输入出生日期时，必须按照“yy-mm-dd”的格式输入；
• 输入的文本内容，例如当前输入框仅允许用户输入数字，或者只允许用户输入英文字符。

QLineEdit单行输入框的使用

QLineEdit 类的内部提供了很多实用的属性和方法，同时还从 QWidget 父类处继承了一些属性和方法。

下表列出了 QLineEdit 类对象经常调用的一些属性以及它们各自的含义：

表 1 QLineEdit常用属性 属 性 含 义

除了上表提到的获取和修改属性值的方法外，QLineEdit 类还提供了一些功能实用的方法，例如：

表 2 QLineEdit常用方法 成员方法 功 能

QLineEdit单行输入框的信号和槽

QLineEdit 类提供了几个信号函数，分别对应用户的几种输入状态。

表 3 QLineEdit信号函数 信号函数 功 能

QLineEdit 类常用的槽函数有以下几个：

表 4 QLineEdit槽函数 槽函数 功 能

QLineEdit单行输入框的用法示例

下面的实例给大家演示了 QLineEdit 单行输入框控件的基本用法，同时还演示了几个成员方法的用法。

#include <QApplication>
#include <QWidget>
#include <QLineEdit>
using namespace std;
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    //创建一个窗口，作为输入框的父窗口
    QWidget widget;
    //设置窗口的标题
    widget.setWindowTitle("QWidget窗口");
   
    //接下来，分别创建两个输入框，用于让用户分别输入账号和密码
    //创建账号输入框
    QLineEdit lineEdit(&widget);
    //指定输入框位于父窗口中的位置
    lineEdit.move(100,100);
    //设置提示信息
    lineEdit.setPlaceholderText("请输入账号...");
    //让输入框显示“一键清除”按钮
    lineEdit.setClearButtonEnabled(true);
   
    //创建密码输入框
    QLineEdit lineEditPass(&widget);
    lineEditPass.setPlaceholderText("请输入密码...");
    lineEditPass.move(100,150);
    //指定文本显示方式，保护用户账号安全
    lineEditPass.setEchoMode(QLineEdit::Password);
   
    //指定窗口的尺寸和显示文字的大小
    widget.resize(500,300);
    widget.setFont(QFont("宋体",16));
    widget.show();
    return a.exec();
}

运行结果为：

图 2 运行结果