本節對應的視頻講解：B_站_鏈_接

https://www.bilibili.com/video/BV1bU4y1S7f7

QLineEdit 是 Qt 中的文本框，準確地說是單行文本框，通常用于接受用戶的輸入

比如用戶輸入用戶名、密碼等，都可以使用該控件。

1. 屬性和方法

---

QLineEdit 有很多屬性，完整的可查看幫助文檔。這里列出常用的屬性和方法：

1.1 占位字符串

占位字符，就是當文本框中輸入內容為空時，顯示的字符，用于提示用戶文本框中應該輸入什么內容

// 獲取和設置占位字符串
QString placeholderText() const
void setPlaceholderText(const QString &)    

如下，是 QQ 登錄界面的用戶名和密碼文本框，在輸入內容為空時，提示如下：

1.2 對齊方式

用于設置文本框中的內容在水平和垂直兩個方向上的對齊方式，比如左對齊、右對齊、上對齊、下對齊、水平居中、垂直居中等。

// 獲取和設置文本的對齊方式
Qt::Alignment alignment() const
void setAlignment(Qt::Alignment flag)

其中，Qt::Alignment 是一個宏，常用取值如下：

• Qt::AlignLeft（0x0001） 水平方向-左對齊
• Qt::AlignRight（0x0002） 水平方向-右對齊
• Qt::AlignHCenter（0x0004） 水平方向-居中對齊
• Qt::AlignTop（0x0020）垂直方向-上對齊
• Qt::AlignBottom（0x0040）垂直方向-下對齊
• Qt::AlignVCenter（0x0080）垂直方向-居中對齊
• Qt::AlignCenter（AlignVCenter | AlignHCenter） 垂直方向和水平方向-居中對齊

上面的每一個宏，都代表 16 進制中的一位，可以進行或（|）操作，來同時設置多個對齊方式。

1.3 回顯模式

所謂回顯模式（EchoMode），就是輸入的內容如何顯示

該屬性既可以在 Qt 設計師右側的屬性窗口中修改，也可以在代碼中動態地獲取和修改

// 獲取和設置回顯模式
QLineEdit::EchoMode echoMode() const
void setEchoMode(QLineEdit::EchoMode)

其中，QLineEdit::EchoMode 是一個宏，有如下 4 個取值：

• QLineEdit::Normal

  正常模式。輸入什么就顯示什么，默認就是這種方式

• QLineEdit::Password

  密碼模式。不顯示實際輸入的字符，而是以小圓圈代替，這樣別人就無法看到輸入的字符。

  Do not display anything. This may be appropriate for passwords where even the length of the password should be kept secret.

• QLineEdit::NoEcho

  無回顯模式。無論輸入什么內容，在文本框中都不會顯示，這樣別人既無法看到輸入的內容，也無法知道輸入字符的長度

  這對于輸入密碼非常有用，在linux下輸入密碼時，就是這種模式

• QLineEdit::PasswordEchoOnEdit

  正在輸入時顯示正常模式顯示，當失去焦點時以密碼模式顯示，也就是顯示小圓圈

1.4 讀寫控制

用于設置文本框是否可編輯、是否使能

// 獲取和設置文本框的只讀屬性
bool isReadOnly() const
void setReadOnly(bool)
    
// 獲取和設置文本框的是否使能
bool isEnabled() const
void setEnabled(bool)

注意：設置為只讀和設置為禁能，都無法對文本框進行編輯

區別在于，只讀時文本框不會置灰，而禁能時文本框會置灰

1.5 格式控制

用于指定文本框輸入特定格式的內容。比如輸入電話號碼格式的文本，或者輸入 IP 地址格式的文本等。

// 設置和獲取格式控制
QString inputMask() const 
void setInputMask(const QString &inputMask)

接收一個 QString 類型的掩碼，常用格式如下：

• 無格式

// 接受任何字符的輸入
setInputMask("");

• 電話號碼

// 9 - 表示要求輸入0-9的數字
// ;# - 表示格式字符串結束，并且未輸入時顯示#
ui->leMask->setInputMask("99999999999;#");

• **

// 9 - 表示要求輸入0-9的數字
// ;# - 表示格式字符串結束，并且未輸入時顯示*
ui->leMask->setInputMask(">AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;*");

其他更多格式使用方法，直接查看 QLineEdit 幫助文檔即可，以上列出的兩個，僅作為拋磚引玉

1.6 信號槽

QLineEdit 有多個信號和槽函數，詳情可參考官方幫助文檔，這里僅演示兩個常用的，作為拋磚引玉

• textChanged 信號

// 當文本框內容改變時，發射該信號
void textChanged(const QString &text)

• editingFinished

// 當輸入完畢時，發射該信號
void editingFinished()

什么叫輸入完畢呢？

答：a、按了 enter 鍵 b、文本框失去焦點

2. 案例

---

該案例演示，文本框的回顯模式、對齊方式、讀寫控制、校驗、格式控制，如下：

2.1 布局

在UI設計師界面，拖拽對應的控件，修改顯示的文字、控件的 name，然后完成布局

2.2 代碼實現

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    // 默認正常模式回顯
    on_btnEchoNormal_clicked();
    // 默認左對齊
    on_btnAlignLeft_clicked();
    // 默認可讀可寫
    on_btnAccessReadWrite_clicked();
    // 默認無格式控制
    on_btnMaskNone_clicked();

    // 演示-textChanged信號
    ui->leAdd1->setValidator(new QIntValidator(this)); // 用于設置校驗,只允許文本框中輸入整數
    ui->leAdd1->setPlaceholderText("加數");
    ui->leAdd2->setValidator(new QIntValidator(this));
    ui->leAdd2->setPlaceholderText("被加數");
    ui->leSum->setPlaceholderText("和");

    // 演示-textFinished信號
    ui->leSub1->setValidator(new QIntValidator(this));
    ui->leSub1->setPlaceholderText("減數");
    ui->leSub2->setValidator(new QIntValidator(this));
    ui->leSub2->setPlaceholderText("被減數");
    ui->leResult->setPlaceholderText("差");
}

Widget::~Widget()
{
    delete ui;
}

// 1、回顯模式
// 1.1 正常
void Widget::on_btnEchoNormal_clicked()
{
    ui->leEcho->clear();
    ui->leEcho->setEchoMode(QLineEdit::Normal);
    ui->leEcho->setPlaceholderText("Normal");
}

// 1.2 密碼模式
void Widget::on_btnEchoPassword_clicked()
{
    ui->leEcho->clear();
    ui->leEcho->setEchoMode(QLineEdit::Password);
    ui->leEcho->setPlaceholderText("Password");
}

// 1.3 不回顯
void Widget::on_btnEchoNoEcho_clicked()
{
    ui->leEcho->clear();
    ui->leEcho->setEchoMode(QLineEdit::NoEcho);
    ui->leEcho->setPlaceholderText("NoEcho");
}

// 1.4 失去焦點時為密碼模式
void Widget::on_btnEchoPasswordEchoOnEdit_clicked()
{
    ui->leEcho->clear();
    ui->leEcho->setEchoMode(QLineEdit::PasswordEchoOnEdit);
    ui->leEcho->setPlaceholderText("PasswordEchoOnEdit");
}

// 打印輸處
void Widget::on_btnEchoPrint_clicked()
{
    QMessageBox::information(this, "回顯模式", ui->leEcho->text());
}

// 2、對齊方式
// 2.1 左對齊
void Widget::on_btnAlignLeft_clicked()
{
    ui->leAlignment->setAlignment(Qt::AlignLeft);
    ui->leAlignment->setPlaceholderText("Left");
}

// 2.2 居中對齊
void Widget::on_btnAlignCenter_clicked()
{
    ui->leAlignment->setAlignment(Qt::AlignCenter);
    ui->leAlignment->setPlaceholderText("Center");
}

// 2.3 右對齊
void Widget::on_btnAlignRight_clicked()
{
    ui->leAlignment->setAlignment(Qt::AlignRight);
    ui->leAlignment->setPlaceholderText("Right");
}

// 3、讀寫控制
// 3.1 可讀可寫
void Widget::on_btnAccessReadWrite_clicked()
{
    ui->leAccess->setReadOnly(false);
    ui->leAccess->setPlaceholderText("ReadWrite");
}

// 3.2 只讀
void Widget::on_btnAccessReadOnly_clicked()
{
    ui->leAccess->setReadOnly(true);
    ui->leAccess->setPlaceholderText("ReadOnly");
}

// 3.3 禁能
void Widget::on_btnAccessDisabled_clicked()
{
    ui->leAccess->setEnabled(false);
    ui->leAccess->setPlaceholderText("Disabled");
}

// 3.4 使能
void Widget::on_btnAccessEnabled_clicked()
{
    ui->leAccess->setEnabled(true);
    ui->leAccess->setPlaceholderText("Enabled");
}

void Widget::on_btnAccessPrint_clicked()
{
    QMessageBox::information(this, "文本框演示", ui->leAccess->text());
}

// 4、格式控制
// 4.1 無格式
void Widget::on_btnMaskNone_clicked()
{
    ui->leMask->setInputMask("");
}

// 4.2 電話號碼格式
void Widget::on_btnMaskPhone_clicked()
{
    // 9 - 表示要求輸入0-9的數字
    // ;# - 表示格式字符串結束，并且未輸入時顯示#
    ui->leMask->setInputMask("99999999999;#");
}

// 4.3 **格式
void Widget::on_btnMaskLicense_clicked()
{
    // 9 - 表示要求輸入0-9的數字
    // ;# - 表示格式字符串結束，并且未輸入時顯示*
    ui->leMask->setInputMask(">AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;*");
}

// 5、信號槽演示
// 5.1 textChanged信號 - 實現自動計算加法結果
void Widget::on_leAdd1_textChanged(const QString &arg1)
{
    int sum = arg1.toInt() + ui->leAdd2->text().toInt();
    ui->leSum->setText(QString::number(sum));
}

void Widget::on_leAdd2_textChanged(const QString &arg1)
{
    int sum = arg1.toInt() + ui->leAdd1->text().toInt();
    ui->leSum->setText(QString::number(sum));
}

// 5.2 editingFinished信號 - 實現自動計算減法結果
void Widget::on_leSub1_editingFinished()
{
    int result = ui->leSub1->text().toInt() - ui->leSub2->text().toInt();
    ui->leResult->setText(QString::number(result));
}

void Widget::on_leSub2_editingFinished()
{
    int result = ui->leSub1->text().toInt() - ui->leSub2->text().toInt();
    ui->leResult->setText(QString::number(result));
}

本節對應的視頻講解：B_站_鏈_接
https://www.bilibili.com/video/BV1bU4y1S7f7