【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

以点为单位设置字体大小。点的大小必须大于零。