Qt官方示例-QLineEdit编辑器

Bertha 。 2023-06-25 16:27 64阅读 0赞

> 基于QLineEdit而写的文本单行编辑器。

![demo.gif][]

上手使用了该编辑器示例，并归纳出以下主要功能分享给大家。

## 回显模式 ##

根据不同的场合显示字符的不同显示模式，比较常用的模式有**密码模式**。

*  使用接口:

void QLineEdit::setEchoMode(QLineEdit::EchoMode mode)

*  回显模式可设置列表：

<table> 
 <thead> 
  <tr> 
   <th>回显模式</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Normal</td> 
   <td>在输入字符时显示它们。<strong>默认值</strong></td> 
  </tr> 
  <tr> 
   <td>Password</td> 
   <td>显示平台相关的<strong>密码掩码字符</strong>，而不是实际输入的字符。</td> 
  </tr> 
  <tr> 
   <td>PasswordEchoOnEdit</td> 
   <td><strong>在编辑时显示输入的字符</strong>，否则Password模式显示。</td> 
  </tr> 
  <tr> 
   <td>NoEcho</td> 
   <td><strong>不显示任何东西</strong>。使用保密性较高的场合。</td> 
  </tr> 
 </tbody> 
</table>

## 输入掩码 ##

这只允许用户在**遵循简单规则的行编辑中键入字符**，使用不同的掩码在编辑前将会预先固定显示相应的字符掩码。

*  使用接口：

void QLineEdit::setInputMask(const QString &inputMask)

*  示例中的相应掩码：

<table> 
 <thead> 
  <tr> 
   <th>掩码值</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>+99 99 99 99 99;_</code></td> 
   <td>电话格式掩码</td> 
  </tr> 
  <tr> 
   <td><code>0000-00-00</code></td> 
   <td>ISO格式日期格式掩码</td> 
  </tr> 
  <tr> 
   <td><code>&gt;AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#</code></td> 
   <td>序列号格式掩码</td> 
  </tr> 
 </tbody> 
</table>

*  另外Qt君也整理了一些输入掩码：

<table> 
 <thead> 
  <tr> 
   <th>掩码值</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>+86 999 9999 9999;_</code></td> 
   <td>手机格式掩码</td> 
  </tr> 
  <tr> 
   <td><code>000.000.000.000;_</code></td> 
   <td>IP格式掩码</td> 
  </tr> 
  <tr> 
   <td><code>HH:HH:HH:HH:HH:HH;_</code></td> 
   <td>MAC网卡地址掩码</td> 
  </tr> 
  <tr> 
   <td><code>\\0\\xHH;0</code></td> 
   <td>十六进制格式掩码</td> 
  </tr> 
 </tbody> 
</table>

![qt\_official\_line\_edits.png][qt_official_line_edits.png]

## 验证器 ##

通过设置QValidator验证器来限制文本输入，一般有QIntValidator(整型值验证器), QDoubleValidator(浮点值验证器), QRegularExpressionValidator(正则表达式验证器)等。

*  使用接口：

void QLineEdit::setValidator(const QValidator *v)

*  示例中的验证器：

<table> 
 <thead> 
  <tr> 
   <th>验证器</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0</td> 
   <td>重置验证器</td> 
  </tr> 
  <tr> 
   <td><code>QIntValidator</code></td> 
   <td>只能输入整型值内容，还可以设置输入的范围。</td> 
  </tr> 
  <tr> 
   <td><code>QDoubleValidator(-999.0, 999.0, 2)</code></td> 
   <td>只能输入-999.00到999.00的浮点值，小数精度值为2。</td> 
  </tr> 
 </tbody> 
</table>

## 只读模式 ##

通过设置`setReadOnly`接口的true或false来控制QLineEdit是否启用该模式。在只读模式下，用户仍然可以将文本复制到剪贴板，或者拖放文本(但回显需是Normal模式)，但是不能编辑它。另外只读模式下不显示光标。

*  使用接口：

void setReadOnly(bool status)

## 文本对齐模式 ##

通过设置`setAlignment`对齐参数值可以控制不同方向的显示。

*  使用接口：

void setAlignment(Qt::Alignment flag)

*  **示例中使用到的对齐方式**：

<table> 
 <thead> 
  <tr> 
   <th>模式</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>AlignLeft</td> 
   <td>左对齐</td> 
  </tr> 
  <tr> 
   <td>AlignCenter</td> 
   <td>居中对齐</td> 
  </tr> 
  <tr> 
   <td>AlignRight</td> 
   <td>右对齐</td> 
  </tr> 
 </tbody> 
</table>

*  除了这些方式外还有这些**常用对齐方式**：

<table> 
 <thead> 
  <tr> 
   <th>模式</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>AlignJustify</td> 
   <td>本文尽量两端对齐(多用在多行文本显示)</td> 
  </tr> 
  <tr> 
   <td>AlignTop</td> 
   <td>顶部对齐</td> 
  </tr> 
  <tr> 
   <td>AlignBottom</td> 
   <td>底部对齐</td> 
  </tr> 
  <tr> 
   <td>AlignVCenter</td> 
   <td>垂直中心对齐</td> 
  </tr> 
  <tr> 
   <td>AlignHCenter</td> 
   <td>水平中心对齐</td> 
  </tr> 
  <tr> 
   <td>AlignBaseline</td> 
   <td>与基线对齐</td> 
  </tr> 
 </tbody> 
</table>

## 关于更多 ##

*  在**QtCreator软件**可以找到：

![what\_find.png][what_find.png]

*  或在以下**Qt安装目录**找到：

C:\Qt\{ 你的Qt版本}\Examples\{ 你的Qt版本}\widgets\widgets\lineedits

*  **相关链接**

https://doc.qt.io/qt-5/qtwidgets-widgets-lineedits-example.html

*  Qt君公众号回复『**Qt示例**』获取更多内容。

[demo.gif]: https://img-blog.csdnimg.cn/20191229222157443.gif
[qt_official_line_edits.png]: https://img-blog.csdnimg.cn/20191229232530190.png
[what_find.png]: https://img-blog.csdnimg.cn/20191229221721718.png