TextInput
TextInput 项目用来显示单行可编辑的纯文本。TextInput 是一个非常简单的项目,除了显示光标和文本外,默认并没有边框等装饰性效果,所以在使用时一般要为其添加一个可视化的外观。
先来看一个例子:
Window { visible: true width: 320 height: 240 Row { spacing: 10 anchors.centerIn: parent Text { text: qsTr("请输入密码:") ; font.pointSize: 15 verticalAlignment: Text.AlignVCenter } Rectangle { width: 100 height: 24 border.color: "grey" TextInput { anchors.fill: parent anchors.margins: 2 font.pointSize: 15 focus: true } } } }
程序运行效果如下图所示。
1.自适应输入框尺寸
按照前面的代码已经为 TextInput 设置了一个基本的外观,但是如果输入过多的内容时,会显示到背景之外,所以要根据输入的内容来动态改变输入框背景的尺寸,这个可以通过 contentWidth
和 contentHeight
属性来根据输入内容的宽高设置背景矩形的大小,将前面代码更改如下:
Rectangle { width: input.contentWidth<100 ? 100 : input.contentWidth + 10 height: input.contentHeight + 5 color: "lightgrey" border.color: "grey" TextInput { id: input anchors.fill: parent anchors.margins: 2 font.pointSize: 15 focus: true } }
2.输入掩码
可以使用输入掩码 inputMask
来限制输入的内容,输入掩码就是使用一些特殊的字符来限制输入的格式和内容,比如掩码A
指定必须输入一个字母 A-Z或a-z,而掩码 a
与其类似,只是不强制输入,可以用留空。可用的掩码字符如下表所示。
字符(必须输入) | 字符(可留空) | 含义 |
---|---|---|
A | a | 只能输入A-Z,a-z |
N | n | 只能输入A-Z,a-z,0-9 |
X | x | 可以输入任意字符 |
9 | 0 | 只能输入0-9 |
D | d | 只能输入1-9 |
# | 只能输入加号(+),减号(-),0-9 | |
H | h | 只能输入十六进制字符,A-F,a-f,0-9 |
B | b | 只能输入二进制字符,0或1 |
字符 | 含义 |
---|---|
> | 后面的字母字符自动转换为大写 |
< | 后面的字母字符自动转换为小写 |
! | 停止字母字符的大小写转换 |
[ ] { } | 括号中的内容会直接显示出来 |
\ | 将该表中的特殊字符正常显示用作分隔符 |
下面来看示例代码:
Rectangle { width: input.contentWidth<100 ? 100 : input.contentWidth + 10 height: input.contentHeight + 5 color: "lightgrey" border.color: "grey" TextInput { id: input anchors.fill: parent anchors.margins: 2 font.pointSize: 15 focus: true inputMask: ">AA_9_a" onEditingFinished: text2.text = text } } Text { id: text2}
当输入完成后可以按下回车键,这时会调用 onEditingFinished
信号处理器,在其中可以对输入的文本进行处理。注意,只有当所有必须输入的字符都输入后,按下回车键才可以调用该信号处理器,比如这里的掩码字符 9
要求必须输入一个数字,如果不输入而是直接留空,那么按下回车键也没有效果。代码运行效果如下图所示。
3.回显方式
TextInput项目的 echoMode
属性指定了文本的显示方式,可用的方式有:
- TextInput.Normal:直接显示文本(默认方式);
- TextInput.Password:使用密码掩码字符(根据不同平台显示效果不同)来代替真实的字符;
- TextInput.NoEcho:不显示输入的内容;
- TextInput.PasswordEchoOnEdit:使用密码掩码字符,但在输入时显示真实字符。
下面来看示例代码:
focus: true echoMode: TextInput.PasswordEchoOnEdit onEditingFinished: { input.focus = false text2.text = text }
代码先设置了 TextInput 获得焦点,这样输入字符会直接显示,等输入完成按下回车键以后使 TextInput 失去焦点,这样输入的字符会用密码掩码显示。