Qt之输入控件（QLineEdit）

简述

QLineEdit是一个单行文本输入框，带有撤销、剪切、粘贴以及拖拽等功能。

通过改变输入框的echoMode()，同时也可以设置为一个“只写”字段，用于输入密码等。

文本的长度可以被限制为maxLength()，可以使用一个validator()或inputMask()来任意限制文本。当在同一个输入框中切换验证器和输入掩码的时候，最好是清除验证器或输入掩码，防止不确定的行为。

用法

下面用一个小例子来展示一个QLineEdit的基础效果

效果

源码

    QLineEdit *lineEdit1 = new QLineEdit;
    lineEdit1->setEchoMode(QLineEdit::Normal);
    lineEdit1->setPlaceholderText("Normal");
    QLineEdit *lineEdit2 = new QLineEdit;
    lineEdit2->setEchoMode(QLineEdit::Password);
    lineEdit2->setPlaceholderText("Password");
    QLineEdit *lineEdit3 = new QLineEdit;
    lineEdit3->setEchoMode(QLineEdit::NoEcho);
    lineEdit3->setPlaceholderText("NoEcho");

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(lineEdit1);
    layout->addWidget(lineEdit2);
    layout->addWidget(lineEdit3);

    this->setLayout(layout);

常用接口

常用属性

• 设置输入掩码
  • inputMask

字符	ASCII字母字符是必须的，A-Z、a-z。
A	ASCII字母字符是允许的，但不是必须的。
a	ASCII字母字符是允许的，但不是必须的。
N	ASCII字母字符是必须的，A-Z、a-z、0-9。
n	ASCII字母字符是允许的，但不是必须的。
X	任何字符都是必须要的。
x	任何字符都是允许的，但不是必须要的。
9	ASCII数字是必须要的，0-9。
0	ASCII数字是允许的，但不是必须要的。
D	ASCII数字是必须要的，1-9。
d	ASCII数字是允许的，但不是必须要的 (1-9)。
#	ASCII数字或加/减符号是允许的，但不是必须要的。
H	十六进制数据字符是必须要的，A-F、a-f、0-9。
h	十六进制数据字符是允许的，但不是必须要的。
B	二进制数据字符是必须要的，0-1。
b	二进制数据字符是允许的，但不是必须要的。
>	所有的字符字母都大写。
<	所有的字符字母都小写。
!	关闭大小写转换
\	使用 \ 去转义上述列出的字符。

掩码由掩码字符和分隔符字符串组成，后面可以跟一个分号和用于空白的字符，空白字符在编辑后总是从文本中删除。

掩码	小提示
000.000.000.000;_	IP地址，空白是_
HH:HH:HH:HH:HH:HH;_	MAC地址
0000-00-00	ISO日期，空白是空格。
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#	License号，空白是-，并且所有(字母)字符转换为大写。

• 文本清除按钮
  • 一个用来清除输入框中文本的按钮
• 占位符文本
  • placeHolderText
• 拖拽文本
  • dragEnabled
• 选中的文本
  • selectedText
• 输出模式
  • echoMode

常量	值	描述
QLineEdit::Normal	0	正常显示输入的字符，默认选项
QLineEdit::NoEcho	1	不显示任何输入，常用于密码类型，其密码长度都需要保密的时候
QLineEdit::Password	2	显示平台相关的密码掩码字符，而不是实际的字符输入
QLineEdit::PasswordEchoOnEdit	3	在编辑的时候显示字符，负责显示密码类型

公有函数

• 添加动作
  • addAction

效果

源码

    QLineEdit *lineEdit1 = new QLineEdit;
    lineEdit1->setEchoMode(QLineEdit::Normal);
    lineEdit1->addAction(QIcon(":/picture/google.png"), QLineEdit::LeadingPosition);
    lineEdit1->addAction(QIcon(":/picture/search.png"), QLineEdit::TrailingPosition);
    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(lineEdit1);
    this->setLayout(layout);

注：lineEdit1->addAction会返回一个QAction指针，我们可以利用这个指针获得QAction的信号并与相应槽函数绑定。

• 设置输入文本对齐方式
  • setAlignment
• 设置清除按钮
  • setClearButtonEnabled

效果

源码

    QLineEdit *lineEdit1 = new QLineEdit;
    lineEdit1->setClearButtonEnabled(true);
    lineEdit1->setCursorMoveStyle(Qt::VisualMoveStyle);

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(lineEdit1);

    this->setLayout(layout);

• 拖拽文本
  • setDragEnabled

效果

源码

lineEdit1->setDragEnabled(true);

• 设置输出模式
  • setEchoMode

效果

源码

    QLineEdit *lineEdit1 = new QLineEdit;
    lineEdit1->setEchoMode(QLineEdit::Normal);
    QLineEdit *lineEdit2 = new QLineEdit;
    lineEdit2->setEchoMode(QLineEdit::NoEcho);
    QLineEdit *lineEdit3 = new QLineEdit;
    lineEdit3->setEchoMode(QLineEdit::Password);
    QLineEdit *lineEdit4 = new QLineEdit;
    lineEdit4->setEchoMode(QLineEdit::PasswordEchoOnEdit);


    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(lineEdit1);
    layout->addWidget(lineEdit2);
    layout->addWidget(lineEdit3);
    layout->addWidget(lineEdit4);

    this->setLayout(layout);

• 设置输入掩码
  • setInputMask

效果

源码

    QLineEdit *lineEdit1 = new QLineEdit;
    lineEdit1->setInputMask("000.000.000.000;_");
    QLineEdit *lineEdit2 = new QLineEdit;
    lineEdit2->setInputMask("HH:HH:HH:HH:HH:HH;_");
    QLineEdit *lineEdit3 = new QLineEdit;
    lineEdit3->setInputMask("0000-00-00");
    QLineEdit *lineEdit4 = new QLineEdit;
    lineEdit4->setInputMask(">AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#");

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(lineEdit1);
    layout->addWidget(lineEdit2);
    layout->addWidget(lineEdit3);
    layout->addWidget(lineEdit4);

    this->setLayout(layout);

• 设置占位符
  • setPlaceHolderText

效果

源码

    QLineEdit *lineEdit1 = new QLineEdit;
    lineEdit1->setEchoMode(QLineEdit::Normal);
    lineEdit1->setPlaceholderText("Normal");
    QLineEdit *lineEdit2 = new QLineEdit;
    lineEdit2->setEchoMode(QLineEdit::NoEcho);
    lineEdit2->setPlaceholderText("NoEcho");
    QLineEdit *lineEdit3 = new QLineEdit;
    lineEdit3->setEchoMode(QLineEdit::Password);
    lineEdit3->setPlaceholderText("PassWard");
    QLineEdit *lineEdit4 = new QLineEdit;
    lineEdit4->setEchoMode(QLineEdit::PasswordEchoOnEdit);
    lineEdit4->setPlaceholderText("PasswordEchoOnEdit");


    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(lineEdit1);
    layout->addWidget(lineEdit2);
    layout->addWidget(lineEdit3);
    layout->addWidget(lineEdit4);

    this->setLayout(layout);

槽函数

槽	意义
clear	清除输入框中文本
copy	复制选中的文本
cut	剪切选中的文本
paste	将粘贴板中的文本粘贴到输入框
redo	重复做
selectAll	选中所有文本
setText	为输入框设置文本
undo	撤销

信号

信号	意义
cursorPositionChanged	鼠标位置变化
editingFinished	编辑结束
inputRejected	拒绝输入
returnPressed	回车键按下
selectionChanged	文本选择变化
textChanged	输入框中文本变化（编程和用户输入）
texEdited	输入框中文本变化（仅限于用户输入）

引用

[1] Qt助手