Qt Quick 常用控件：TextInput, TextEdit（编辑框）

高亚奇

已于 2023-12-13 09:47:35 修改

阅读量192

点赞数

分类专栏：上位机框架 QML + QT 文章标签： qt

于 2023-12-13 09:42:36 首次发布

本文链接：https://blog.csdn.net/m0_73482095/article/details/134963977

版权

上位机框架 QML + QT 专栏收录该内容

20 篇文章 0 订阅

订阅专栏

一、Textinput

Textinput 用于编辑一行文本，类似于 QLineEdit，除了显示光标和文本外，默认并没有边框等装饰性效果，所以在使用时一般要为其添加一个可视化的外观。

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
            color: "lightgrey"
            border.color: "grey"

            TextInput {
                anchors.fill: parent
                anchors.margins: 2
                font.pointSize: 15
                focus: true
            }
        }
    }
}

Textinput 默认并没有边框，所以上面使用 Rectangle 作为其边框，程序运行效果如下图所示：

下面介绍其一些属性：

font 分组属性允许你设置 Textlnput 元素所用字体的各种属性，包括字体族（family）、大小（pixelSize、pointSize）、粗细（bold、weight）、斜体（italic）、下画线（underline）等。
horizontalAlignment 和 verticalAlignment 用于设定文本对齐方式，wrapMode 设置文本超过控件宽度时的换行策略，color 设置文字颜色，contentWidth、contentHeight 返回文本的宽、高。
当用户按了回车键或确认键，或者编辑框失去焦点时，会发出 accepted 和 editingFinished 信号，开发者可以实现 onAccepted 和 onEditingFinished 信号处理器来处理。

1.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
    }
}

运行效果如下图所示：

1.2 输入掩码

可以使用输入掩码 inputMask 来限制输入的内容，输入掩码就是使用一些特殊的字符来限制输入的格式和内容，举个简单的例子，你想让用户输入类似于 "2014-01-30" 这种格式的日期，可以将 inputMask 设置为 "0000-00-00"。可用的掩码字符如下表所示。

字符（必须输入）	字符（可留空）	含义
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 要求必须输入一个数字，如果不输入而是直接留空，那么按下回车键也没有效果。代码运行效果如下图所示：

1.3 验证器

除了使用掩码，还可以使用整数验证器 IntValidator 、DoubleValidator（非整数验证器）和RegExpValidator（正则表达式验证器）。下面的代码可以限制在 TextInput 中只能输入 11 到 31 之间的整数：

validator: IntValidator{ bottom: 11; top: 31; }

对于正则表达式的使用，可以参考网上教程。

1.4 回显方式

TextInput项目的 echoMode 属性指定了文本的显示方式，可用的方式有：

TextInput.Normal：直接显示文本（默认方式）；
TextInput.Password：使用密码掩码字符（根据不同平台显示效果不同）来代替真实的字符；
TextInput.NoEcho：不显示输入的内容；
TextInput.PasswordEchoOnEdit：使用密码掩码字符，但在输入时显示真实字符。

下面来看示例代码：

TextInput {
    id: input
    focus: true
    echoMode: TextInput.PasswordEchoOnEdit

    onEditingFinished: {
        input.focus = false
        text2.text = text
    }
}

代码先设置了 TextInput 获得焦点，这样输入字符会直接显示，等输入完成按下回车键以后使 TextInput 失去焦点，这样输入的字符会用密码掩码显示。效果如下图所示：

如果 echoMode 不为 Textlnput.Normal，那么 displayText 属性就保存显示给用户的文本，而 text 属性则保存实际输入的文本，比如你设定 passwordCharacter 为 *, echoMode为TextInput.Password，那么displayText属性内保存的就是一串 *。

二、Textinput

Textinput 用于编辑一行文本，类似于 QLineEdit。

font 分组属性允许你设置 Textlnput 元素所用字体的各种属性，包括字体族（family）、大小（pixelSize、pointSize）、粗细（bold、weight）、斜体（italic）、下画线（underline）等。
还有一些属性与 Text 元素一样，如 text 属性可以设置或获取元素的文本，horizontalAlignment 和 verticalAlignment 用于设定文本对齐方式，wrapMode 设置文本超过控件宽度时的换行策略，color 设置文字颜色，contentWidth、contentHeight 返回文本的宽、高。
length 属性返回编辑框内的字符个数。maxinumiLength 设置编辑框允许输入的字符串的最大长度，超过这个长度就会被截断。
假如你想使用 Textlnput 来输入密码，可以设置 echoMode 属性为 Textlnput.Password、 Textlnput.PasswordEchoOnEdit 或 Textlnput.NoEcho，而 echoMode 默认为 Textlnput.Normal，即输入什么显示什么。如果 echoMode 不为 Textlnput.Normal，那么 displayText 属性就保存显示给用户的文本，而 text 属性则保存实际输入的文本，比如你设定 passwordCharacter 为 "*"， echoMode 为 Textlnput.Password，那么 displayText 属性内保存的就是一串 "*"。

Textlnput 还支持粘贴、撤销、重做、滚动等特性。不过，Textlnput不支持使用HTML标记的富文本。

Textinput 同时也支持适应 validator 或 inputMask 对输入文本做范围限制，也可以设置 echoMode 实现密码框的效果。

inputMask 是个字符串，用来限制你可以输入的字符。掩码串内包含允许的字符和分隔符，后面还可以跟一个可选的分号，以及一个用于补空白的字符。举个简单的例子，你想让用户输入类似于 "2014-01-30" 这种格式的日期，可以将 inputMask 设置为 "0000-00-00"。
Textlnput 目前支持 IntValidator、DoubleValidator、RegExpValidator，如果你设置了 validator属性，那么用户就只能输入符合 validator 所界定范围的字符。
IntValidator 可以设置一个整数范围，top、bottom 设定最大值、最小值，不设置的话使用整型的最大值、最小值。
RegExpValidator 让我们提供一个正则表达式作为验证器。

当用户按了回车键或确认键，或者编辑框失去焦点时，会发出 accepted 和 editingFinished 信号，开发者可以实现 onAccepted 和 onEditingFinished 信号处理器来处理。需要注意的是，如果你设置了 inputMask 或 validator，那么只有在编辑框内的文本符合限制条件时这两个信号才会触发。

TextInput 除了显示光标和文本外，默认并没有边框等装饰性效果，所以在使用时一般要为其添加一个可视化的外观。示例代码如下：

import QtQuick 2.2
import QtQuick.Window 2.0

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
            color: "lightgrey"
            border.color: "grey"

            TextInput {
                anchors.fill: parent
                anchors.margins: 2
                font.pointSize: 15
                focus: true
                 onAccepted: console.log("accepted")
            }
        }
    }
}

执行后的效果图如下：

三、TextEdit

TextEdit 是 Qt Quick 提供的多行文本编辑框，它的大多数属性与 Textinput 类似。下面只说不同之处：

文本颜色

TextInput 的文本颜色使用 color 属性指定，TextField 的文本颜色使用 textColor 属性指定。
背景色

TextInput 没有背景，是透明的，能够与父控件无缝结合；而 TextField 有背景，其背景色可通过 TextFieldStyle 的 background 属性来设定，其他属性都一样。
富文本
Textlnput 不支持使用 HTML 标记的富文本，而 TextEdit 可以。

示例如下：

import QtQuick 2.9
import QtQuick.Window 2.2

Window {
    visible: true
    width: 640
    height: 480

    TextEdit {
        width: 240
        textFormat: Text.RichText
        text: "<b>Hello</b> <i>World!</i>"
        font.family: "Helvetica"
        font.pointSize: 20
        color: "blue"
        focus: true
        anchors.centerIn: parent
    }
}

运行代码可以看到，TextEdit 没有提供滚动条、光标跟随和其它在可视部件中通常具有的行为。为了更加人性化的体验，我们可以使用 Flickable 来为其提供滚动，实现光标跟随。下面来看一段示例代码：

Window {
    visible: true
       width: 640
       height: 480

       Flickable {
           id: flick

           anchors.fill: parent
           contentWidth: edit.paintedWidth
           contentHeight: edit.paintedHeight
           clip: true

           function ensureVisible(r)
           {
               if (contentX >= r.x)
                   contentX = r.x;
               else if (contentX+width <= r.x+r.width)
                   contentX = r.x+r.width-width;
               if (contentY >= r.y)
                   contentY = r.y;
               else if (contentY+height <= r.y+r.height)
                   contentY = r.y+r.height-height;
           }

           TextEdit {
               id: edit
               width: flick.width
               height: flick.height
               font.pointSize: 15
               wrapMode: TextEdit.Wrap
               focus: true
               onCursorRectangleChanged:
                   flick.ensureVisible(cursorRectangle)
           }
       }

       Rectangle {
           id: scrollbar
           anchors.right: flick.right
           y: flick.visibleArea.yPosition * flick.height
           width: 10
           height: flick.visibleArea.heightRatio * flick.height
           color: "lightgrey"
       }
}

JS 折叠复制全屏

这里使用的 Flickable 类型到后面会详细讲解。在 TextEdit 中可以设置 selectByMouse 属性为 true 来使鼠标可以选取文本内容，可以直接通过键盘快捷键实现文本的复制、粘贴、撤销等操作，当然也可以使用相应的函数来完成。运行效果如下图所示：

四、TextEdit

TextEdit 是 Qt Quick 提供的多行文本编辑框，它的大多数属性与 Textinput 类似，不同之处在于，TextEdit 用来显示多行的可编辑的格式化文本，它既可以显示纯文本也可以显示富文本。如下面的代码所示：

import QtQuick 2.2
import QtQuick.Window 2.0

Window {
    visible: true
    width: 320
    height: 240

    Column {
        anchors.centerIn: parent

        Rectangle {
            width: 120
            height: 100
            color: "lightgrey"
            border.color: "grey"

            TextEdit {
                id : textEdit
                width: 100
                height: 100
                font.pointSize: 20
                color: "blue"
                focus: true
            }
        }
    }
}

执行后的效果图如下：

高亚奇

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
打赏
0
评论
Qt Quick 常用控件：TextInput, TextEdit（编辑框）

如果 echoMode 不为 Textlnput.Normal，那么 displayText 属性就保存显示给用户的文本，而 text 属性则保存实际输入的文本，比如你设定 passwordCharacter 为 "*"， echoMode 为 Textlnput.Password，那么 displayText 属性内保存的就是一串 "*"。代码先设置了 TextInput 获得焦点，这样输入字符会直接显示，等输入完成按下回车键以后使 TextInput 失去焦点，这样输入的字符会用密码掩码显示。
复制链接

扫一扫