【Qt QML入门】TextInput
TextInput：单行文本输入框。
TextInput除了光标和文本外，默认没有边框等效果。
import QtQuick
import QtQuick.Window
import QtQuick.Controls
Window {
id: win
width: 800
height: 600
visible: true
title: qsTr("Hello World")
//单行文本输入框
//TextInput除了光标和文本外，默认没有边框等效果
TextInput {
anchors.centerIn: parent
text: "this is a textinout"
}
}
我们可以自己给它加一个边框：
import QtQuick
import QtQuick.Window
import QtQuick.Controls
Window {
id: win
width: 800
height: 600
visible: true
title: qsTr("Hello World")
Rectangle {
anchors.centerIn: parent
width: 200
height: 50
color: "transparent"
border.width: 1
border.color: "red"
//单行文本输入框
//TextInput除了光标和文本外，默认没有边框等效果
TextInput {
anchors.margins: 1
text: "this is a textinput control!"
}
}
} leftPadding设置为10，效果如下：
topPadding设置为10，效果如下：
bottomPadding : real
leftPadding : real
padding : real
rightPadding : real
topPadding : real
注意: 如果为TextInput指定了显式的宽度或高度，则必须注意确保它足够大，以容纳相关的填充值。例如:如果topPadding和bottomPadding设置为10，但是TextInput的高度仅设置为20，则文本将没有足够的垂直空间来呈现，会被剪切显示。
effectiveHorizontalAlignment : enumeration
horizontalAlignment : enumeration
verticalAlignment : enumeration
设置文本在textput项目的宽度和高度内的水平对齐方式。默认情况下，文本对齐遵循文本的自然对齐，例如，从左到右读取的文本将向左对齐。
TextInput没有垂直对齐，因为自然高度正是单行文本的高度。如果您手动将高度设置为更大的值，则TextInput将始终顶部垂直对齐。您可以使用锚来对齐它，但你想在另一个项目。
horizontalAlignment的有效值是TextInput.AlignLeft、TextInput.AlignRight和TextInput.AlignHCenter。
垂直对齐的有效值是TextInput.AlignTop(默认)，TextInput.AlignBottom、TextInput.AlignVCenter。
当使用附加属性LayoutMirroring::enabled来镜像应用程序布局时，文本的水平对齐也将被镜像。但是，属性horizontalAlignment将保持不变。要查询TextInput的有效水平对齐方式，请使用只读属性effectiveHorizontalAlignment。
activeFocusOnPress : bool
TextInput是否应该在鼠标按下时获得活动焦点。默认情况下，此设置为true。
autoScroll : bool
当文本长度大于宽度时，TextInput是否应该滚动。默认情况下，此设置为true。
canPaste : bool
如果TextInput是可写的，并且剪贴板的内容适合粘贴到TextInput中，则返回true。
canRedo : bool
如果TextInput是可写的，并且存在可重做的未完成操作，则返回true。
color : color
文本颜色。
contentHeight : real
返回文本的高度，包括如果文本不适合设置的高度，则超过覆盖高度的高度。
contentWidth : real
如果设置了wrapMode，则返回文本的宽度，包括超过由于换行不足而覆盖的宽度。
cursorDelegate : Component
TextInput中光标的委托。
如果你为TextInput设置了一个cursorDelegate，这个delegate将被用来绘制光标，而不是标准的光标。当需要游标时，将由TextInput创建和管理委托实例，并且将委托实例的x属性设置为在当前字符的左上角之前一个像素。请注意，委托组件的根项必须是QQuickItem或QQuickItem的派生项。
cursorPosition : int
TextInput中光标的位置。
cursorRectangle : rectangle
在文本输入中呈现标准文本游标的矩形。只读的。
自定义cursorDelegate的位置和高度会随着cursorRectangle的变化而自动更新。委托的宽度不受
光标矩形更改的影响。
cursorVisible : bool
当TextInput显示光标时设置为true。当TextInput获得活动焦点时设置和取消该属性，以便可以将其他属性绑定到光标当前是否显示。因为它可以自动设置和取消设置，所以当您自己设置该值时，必须记住您的值可能会被覆盖。
它可以直接在脚本中设置，例如，如果KeyProxy可能会向它转发密钥，并且您希望它在发生这种情况时看起来是活动的(但实际上没有给它活动焦点)。
它不应该像下面的QML一样直接在项目上设置，因为指定的值将在焦点更改时被覆盖并丢失。
displayText : string
这是在TextInput中显示的文本。
如果echoMode被设置为TextInput::Normal，它的值与TextInput::text属性的值相同。否则，此属性保存对用户可见的文本，而text属性保存实际输入的文本。
echoMode : enumeration
指定文本应该如何在TextInput中显示。
TextInput.Normal-按原样显示文本。(默认)
TextInput.Password-显示平台相关的密码掩码字符，而不是实际字符。
TextInput.NoEcho -不显示任何内容。
TextInput.PasswordEchoOnEdit -在编辑时显示输入的字符，否则与TextInput.Password相同
font.bold : bool
文本加粗。
font.capitalization : enumeration
设置文本的大写。
Font.MixedCase：这是不应用大小写变化的普通文本呈现选项。
Font.AllUppercase：这将文本更改为以全大写类型呈现。
Font.AllLowercase：将文本改为以全小写字体呈现。
Font.SmallCaps：这将文本更改为以小大写类型呈现。
Font.Capitalize：这将改变文本，使每个单词的第一个字符为大写字符
font.family : string
设置字体的家族名称。
font.hintingPreference : enumeration
在文本上设置首选提示。注意:此属性仅在与渲染类型TextInput.NativeRendering一起使用时有效。
Font.PreferDefaultHinting：使用目标平台的默认提示级别。
Font.PreferNoHinting：如果可能的话，渲染文本而不提示符号的轮廓。文本布局将在排版上准确，使用与使用相同的指标，例如打印时。
Font.PreferVerticalHinting：如果可能的话，渲染文本时不使用水平提示，但将字形与像素网格在垂直方向上对齐。在密度太低而无法准确呈现符号的显示器上，文本将显得更清晰。但由于字形的水平度量是没有暗示的，文本的布局将可扩展到更高密度的设备(如打印机)，而不会影响诸如换行之类的细节。
Font.PreferFullHinting：如果可能的话，在水平和垂直方向上呈现带有提示的文本。文本将被修改以优化目标设备上的易读性，但由于指标将取决于文本的目标大小，字形、断行和其他排版细节的位置将无法缩放，这意味着文本布局可能在具有不同像素密度的设备上看起来不同。
font.italic : bool
设置字体是否为斜体样式。
font.kerning : bool
启用或禁用OpenType字距调整功能时，对文本进行字形调整。禁用此功能可能会在创建或更改文本时提高性能，但可能会牺牲一些外观特征。默认值为true。
font.letterSpacing : real
字距调整，它改变了字体中各个字母之间的默认间距。一个正数值会增加相应的像素，使字母间距增大；一个负数值会减少间距。
font.pixelSize : int
以像素为单位设置字体大小。字体依赖于特定的设备。为了以独立于设备的方式设置字体大小，应该使用“pointSize”。
font.pointSize : real
以点为单位设置字体大小。点的大小必须大于零。
font.strikeout : bool
字体是否带有删除线（即划线删除标记）
font.styleName : string
设置字体的样式名称。这个属性是大小写不敏感的。如果设置了font.styleName，那么在匹配字体时，会根据这个样式名称来匹配，而不是根据font.weight、font.bold和font.italic这些属性。
font.underline : bool
设置文本是否带有下划线。
font.weight : int
设置字体粗细（weight）。在Qt中，字体粗细是一个整数值，范围从1到1000，或者可以使用预定义的枚举值：
Font.ThinFont.LightFont.ExtraLightFont.Normal- 默认值Font.MediumFont.DemiBoldFont.BoldFont.ExtraBoldFont.Black
不是所有的字体都支持所有粗细级别。具体而言，一些字体可能只支持一部分范围的值，因此在设置字体粗细时，可能需要考虑字体的可用选项。
font.wordSpacing : real
设置字体的字间距。字间距是单词之间的默认间距。正值会增加相应的像素数量，负值会相应地减少单词之间的间距。
inputMask : string
设置输入掩码（input mask），以限制允许的文本输入。输入掩码的功能类似于输入验证，确保用户只能输入符合特定格式的文本。
| 字符（必须输入） | 字符（可留空） | 含义 |
| 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 |
| 字符 | 含义 |
| > | 后面的字母字符自动转换为大写 |
| < | 后面的字母字符自动转换为小写 |
| ！ | 停止字母字符的大小写转换 |
| [ ] { } | 括号中的内容会直接显示出来 |
| \ | 将该表中的特殊字符正常显示用作分隔符 |
length : int
返回TextInput项目中的总字符数。如果TextInput有一个输入掩码，长度将包括掩码字符，并且可能与text属性返回的字符串长度不同。与查询text属性的长度相比，这个属性可能更快，因为它不需要复制或转换TextInput内部字符串数据。这个属性通常用于性能优化，特别是在处理大量文本数据时。通过使用textLength属性，可以避免不必要的字符串复制和转换操作，从而提高应用程序的效率。
maximumLength : int
TextInput中允许的最大文本长度。如果文本太长，它会在限制处被截断。默认情况下，此属性包含一个值为32767的值。这个属性可以用于限制用户在文本输入框中输入的最大字符数，防止过长的文本导致内存占用过高或其他问题。
mouseSelectionMode : enumeration
指定了如何使用鼠标选择文本。
TextInput.SelectCharacters - 选择以单个字符为单位进行更新。（默认）TextInput.SelectWords - 选择以整个单词为单位进行更新。
这个属性仅在selectByMouse为true时适用。通过设置selectionMode属性，可以选择是按字符还是按单词进行选择，这取决于用户的鼠标操作方式。
overwriteMode : bool
用户输入的文本是否会覆盖现有的文本。如果此属性为true，则现有文本被逐个字符覆盖；否则，文本在光标位置插入并替换现有文本。默认情况下，此属性为false（新文本不会覆盖现有文本）。
passwordCharacter : string
定义了当echoMode设置为Password或PasswordEchoOnEdit时显示的字符。默认情况下，它是平台主题使用的密码字符。
passwordMaskDelay : int
设置在可见字符被密码字符屏蔽之前的延迟，单位是毫秒。
persistentSelection : bool
当TextInput失去焦点并转移到场景中的另一个项目时，是否应保持其选择。默认情况下，这个属性被设置为false。
readOnly : bool
用户输入是否可以修改TextInput的内容。
renderType : enumeration
设置文本渲染类型。
有两种支持的渲染类型：
1、Text.QtRendering：文本在目标平台上看起来更原生，并且不需要诸如文本转换等高级功能，那么可以选择Text.NativeRendering。使用这种渲染类型与高级功能结合可能会导致结果质量较差，有时甚至出现像素化。
2、Text.NativeRendering: 这是默认的渲染类型，它是由QQuickWindow::textRenderType()确定的。
selectByMouse : bool
在特定平台上用户是否可以通过鼠标选择文本。
selectedText : string
文本输入中当前选择的文本。
selectedTextColor : color
选择文本时的显示高亮文本颜色。
selectionColor : color
文本高亮颜色，在选择后使用。
selectionEnd : int
光标在当前选择的最后一个字符之后的位置。
selectionStart : int
光标在当前选择的第一个字符之前的位置。
text : string
输入框的文本。
validator : Validator
在TextInput上设置验证器。当设置验证器时，TextInput将只接受使text属性处于可接受状态或中间状态的输入。只有当按enter键时文本处于可接受状态时，才会发送可接受的信号。
目前支持的验证器有IntValidator、DoubleValidator和RegularExpressionValidator。
wrapMode : enumeration
设置TextInput对象的文本换行方式。这个属性决定了当文本超过TextInput的宽度时该如何处理。TextInput.NoWrap（默认值）：不进行换行。如果文本中没有足够的换行符，那么implicitWidth会超过设定的宽度。
TextInput.WordWrap：只在单词边界进行换行。如果某个单词太长，implicitWidth会超过设定的宽度。
TextInput.WrapAnywhere：在任何位置进行换行，即使这个位置在单词的中间。
TextInput.Wrap：如果可能，尽量在单词边界进行换行；如果不可能，则在适当的位置换行，即使这个位置在单词的中间。