TextInput是用于在用户界面中输入文本的控件，通常应用于表单、搜索框等需要用户输入文字的场景。以下是对TextInput的详细解释，涵盖其各个方面的功能和属性。
基本属性
-
text
- 描述：TextInput中当前显示的文本。
- 用法：
text: "示例文本"
-
placeholderText
- 描述：当TextInput为空时，显示的提示文本。
- 用法：
placeholderText: "请输入内容"
-
readOnly
- 描述：设置TextInput是否为只读。
- 用法：
readOnly: true
-
echoMode
- 描述：设置TextInput的显示模式，通常用于密码输入时隐藏文本。
- 用法：
echoMode: TextInput.Password
输入控制
-
inputMethodHints
- 描述：提供输入法的提示，如仅允许数字输入。
- 用法：
inputMethodHints: Qt.ImhDigitsOnly
-
validator
- 描述：用于验证TextInput的输入是否合法。
- 用法：
validator: RegExpValidator { regExp: /^[0-9]*$/ }
-
maximumLength
- 描述：限制TextInput的最大字符数。
- 用法：
maximumLength: 20
-
focus
- 描述：设置或获取TextInput的焦点状态。
- 用法：
focus: true
外观和样式
-
font.family
- 描述：设置TextInput中文本的字体。
- 用法：
font.family: "Arial"
-
font.pointSize
- 描述：设置TextInput中文本的字体大小。
- 用法：
font.pointSize: 16
-
color
- 描述：设置TextInput中文本的颜色。
- 用法：
color: "black"
-
selectionColor
- 描述：设置TextInput中选中文本的颜色。
- 用法：
selectionColor: "blue"
交互和行为
-
onTextChanged
- 描述：当TextInput中的文本变化时调用的回调函数。
- 用法：
onTextChanged: { console.log("文本变化: " + text) }
-
onEditingFinished
- 描述：当用户完成编辑（如按下回车键）时调用的回调函数。
- 用法：
onEditingFinished: { console.log("编辑完成: " + text) }
-
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的各种属性，创建一个带有提示文本、字符限制、输入法提示以及回调函数的输入框。通过这些属性和方法，开发者可以实现多种多样的文本输入需求。
