Qt官方示例-QLineEdit编辑器

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

demo.gif

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

回显模式

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

• 使用接口:

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

• 回显模式可设置列表：

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

输入掩码

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

• 使用接口：

void QLineEdit::setInputMask(const QString &inputMask)

• 示例中的相应掩码：

掩码值	含义
+99 99 99 99 99;_	电话格式掩码
0000-00-00	ISO格式日期格式掩码
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#	序列号格式掩码

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

掩码值	含义
+86 999 9999 9999;_	手机格式掩码
000.000.000.000;_	IP格式掩码
HH:HH:HH:HH:HH:HH;_	MAC网卡地址掩码
\\0\\xHH;0	十六进制格式掩码

qt_official_line_edits.png

验证器

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

• 使用接口：

void QLineEdit::setValidator(const QValidator *v)

• 示例中的验证器：

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

只读模式

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

• 使用接口：

void setReadOnly(bool status)

文本对齐模式

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

• 使用接口：

void setAlignment(Qt::Alignment flag)

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

模式	含义
AlignLeft	左对齐
AlignCenter	居中对齐
AlignRight	右对齐

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

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

关于更多

• 在QtCreator软件可以找到：

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示例』获取更多内容。