TextInput是用于在用户界面中输入文本的控件，通常应用于表单、搜索框等需要用户输入文字的场景。以下是对TextInput的详细解释，涵盖其各个方面的功能和属性。

基本属性

1. text

   • 描述：TextInput中当前显示的文本。
   • 用法：text: "示例文本"

2. placeholderText

   • 描述：当TextInput为空时，显示的提示文本。
   • 用法：placeholderText: "请输入内容"

3. readOnly

   • 描述：设置TextInput是否为只读。
   • 用法：readOnly: true

4. echoMode

   • 描述：设置TextInput的显示模式，通常用于密码输入时隐藏文本。
   • 用法：echoMode: TextInput.Password

输入控制

1. inputMethodHints

   • 描述：提供输入法的提示，如仅允许数字输入。
   • 用法：inputMethodHints: Qt.ImhDigitsOnly

2. validator

   • 描述：用于验证TextInput的输入是否合法。
   • 用法：validator: RegExpValidator { regExp: /^[0-9]*$/ }

3. maximumLength

   • 描述：限制TextInput的最大字符数。
   • 用法：maximumLength: 20

4. focus

   • 描述：设置或获取TextInput的焦点状态。
   • 用法：focus: true

外观和样式

1. font.family

   • 描述：设置TextInput中文本的字体。
   • 用法：font.family: "Arial"

2. font.pointSize

   • 描述：设置TextInput中文本的字体大小。
   • 用法：font.pointSize: 16

3. color

   • 描述：设置TextInput中文本的颜色。
   • 用法：color: "black"

4. selectionColor

   • 描述：设置TextInput中选中文本的颜色。
   • 用法：selectionColor: "blue"

交互和行为

1. onTextChanged

   • 描述：当TextInput中的文本变化时调用的回调函数。
   • 用法：onTextChanged: { console.log("文本变化: " + text) }

2. onEditingFinished

   • 描述：当用户完成编辑（如按下回车键）时调用的回调函数。
   • 用法：onEditingFinished: { console.log("编辑完成: " + text) }

3. inputMethodComposing

   • 描述：指示当前是否有未完成的输入法输入。
   • 用法：inputMethodComposing: false

示例代码

import QtQuick 2.15
import QtQuick.Controls 2.15ApplicationWindow {visible: truewidth: 640height: 480title: qsTr("TextInput示例")TextInput {id: textInputwidth: 200height: 40placeholderText: qsTr("请输入内容")font.family: "Arial"font.pointSize: 16color: "black"selectionColor: "blue"maximumLength: 20inputMethodHints: Qt.ImhDigitsOnlyonTextChanged: {console.log("文本变化: " + text)}onEditingFinished: {console.log("编辑完成: " + text)}}
}

这个示例展示了如何使用TextInput的各种属性，创建一个带有提示文本、字符限制、输入法提示以及回调函数的输入框。通过这些属性和方法，开发者可以实现多种多样的文本输入需求。