TextInput 学习笔记

最新推荐文章于 2025-07-08 00:08:38 发布

原创最新推荐文章于 2025-07-08 00:08:38 发布 · 2k 阅读

0 ·

CC 4.0 BY-SA版权

qml 专栏收录该内容

44 篇文章

订阅专栏

本文详细介绍了QML中TextInput控件的使用方法，包括如何自适应调整输入框尺寸、应用输入掩码限制输入格式、设置不同的回显模式以及处理输入完成后的事件。

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 失去焦点，这样输入的字符会用密码掩码显示。