TextField QML 类型

单行文本输入字段。更多信息...

导入语句	import QtQuick.Controls
继承	TextInput

包含所有成员的列表，包括继承成员

属性

background : Item
bottomInset : real (自 QtQuick.Controls 2.5 (Qt 5.12))
focusReason : 枚举
hoverEnabled : bool (自 QtQuick.Controls 2.1 (Qt 5.8))
hovered : bool (自 QtQuick.Controls 2.1 (Qt 5.8))
implicitBackgroundHeight : real (自 QtQuick.Controls 2.5 (Qt 5.12))
implicitBackgroundWidth : real (自 QtQuick.Controls 2.5 (Qt 5.12))
leftInset : real (自 QtQuick.Controls 2.5 (Qt 5.12))
placeholderText : string
placeholderTextColor : 颜色 (自 QtQuick.Controls 2.5 (Qt 5.12))
rightInset : real (自 QtQuick.Controls 2.5 (Qt 5.12))
topInset : real (自 QtQuick.Controls 2.5 (Qt 5.12))

信号

pressAndHold(MouseEvent event)
pressed(MouseEvent event) (自 QtQuick.Controls 2.1 (Qt 5.8))
released(MouseEvent event) (自 QtQuick.Controls 2.1 (Qt 5.8))

详细说明

TextField 是一个单行文本编辑器。TextField 通过添加占位文本功能扩展了 TextInput，并添加了装饰。

	文本字段在正常状态下的样子。
	具有活动焦点状态的文本字段。
	禁用状态的文本字段。

TextField {
    placeholderText: qsTr("Enter name")
}

另请参阅 TextArea，定制 TextField 以及输入控件。

属性文档

background : Item

此属性包含背景项。

注意： 如果背景项没有指定明确的大小，它将自动跟随控件的大小。在大多数情况下，没有必要为背景项指定宽度或高度。

注意： 大多数控件会将背景项的隐式大小用来计算控件的自身隐式大小。如果您用自定义项替换背景项，您也应该考虑为它提供一个合理的隐式大小（除非它是像Image这样的项，它有自己的隐式大小）。

另请参阅 定制TextField。

bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

此属性保存背景的底部内边距。

此属性在QtQuick.Controls 2.5（Qt 5.12）中引入。

另请参阅 控件布局和topInset。

focusReason : enumeration

此属性保存上一次焦点变化的原因。

注意： 此属性不指示项是否具有活动焦点，而是说明项为何获得或失去焦点。

常量	描述
`Qt.MouseFocusReason`	发生了鼠标操作。
`Qt/tabFocusReason`	按下了Tab键。
`Qt.BacktabFocusReason`	发生了Backtab事件。这包括Shift或Ctrl键，例如Shift+Tab。
`Qt.ActiveWindowFocusReason`	窗口系统使这个窗口变为活动或非活动状态。
`Qt.PopupFocusReason`	应用程序打开/关闭了一个捕获/释放键盘焦点的弹出窗口。
`Qt.ShortcutFocusReason`	用户输入了标签的伙伴快捷键
`Qt.MenuBarFocusReason`	菜单栏接管了焦点。
`Qt.OtherFocusReason`	其他原因，通常是应用特定的。

注意： 优先使用Item::focusReason属性。

hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]

此属性确定文本字段是否接受悬停事件。默认值为false。

此属性在QtQuick.Controls 2.1（Qt 5.8）中引入。

另请参阅 hovered。

hovered : bool [只读，since QtQuick.Controls 2.1 (Qt 5.8)]

此属性保存文本字段是否被悬停。

此属性在QtQuick.Controls 2.1（Qt 5.8）中引入。

另请参阅 hoverEnabled。

implicitBackgroundHeight : real [只读，since QtQuick.Controls 2.5 (Qt 5.12)]

此属性保存隐式背景高度。

该值等于background ? background.implicitHeight : 0。

此属性在QtQuick.Controls 2.5（Qt 5.12）中引入。

另请参阅 implicitBackgroundWidth。

implicitBackgroundWidth : real [只读，since QtQuick.Controls 2.5 (Qt 5.12)]

此属性保存隐式背景宽度。

值等于background ? background.implicitWidth : 0。

此属性在QtQuick.Controls 2.5（Qt 5.12）中引入。

另请参阅 implicitBackgroundHeight。

leftInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

此属性保存背景的左侧内边距。

此属性在QtQuick.Controls 2.5（Qt 5.12）中引入。

另请参阅 控件布局和rightInset。

placeholderText : string

此属性包含在用户输入文本之前在 TextField 中显示的提示信息。

placeholderTextColor : 颜色 [自 QtQuick.Controls 2.5 (Qt 5.12) 起支持]

此属性包含 placeholderText 的颜色。

此属性在QtQuick.Controls 2.5（Qt 5.12）中引入。

另请参阅 placeholderText。

rightInset : 实数 [自 QtQuick.Controls 2.5 (Qt 5.12) 起支持]

此属性包含背景的右侧边距。

此属性在QtQuick.Controls 2.5（Qt 5.12）中引入。

另请参阅 控件布局和 leftInset。

topInset : 实数 [自 QtQuick.Controls 2.5 (Qt 5.12) 起支持]

此属性包含背景的顶部边距。

此属性在QtQuick.Controls 2.5（Qt 5.12）中引入。

另请参阅 控件布局和 bottomInset。

信号文档

pressAndHold(鼠标事件 event)

当发生长按（延迟取决于平台插件）时，会触发此信号。参数 event 提供有关长按的信息，包括按下的 x 和 y 坐标以及按下的按钮。

注意： 相应的处理程序是 onPressAndHold。

另请参阅 pressed 和 released。

[自 QtQuick.Controls 2.1 (Qt 5.8) 起支持] pressed(鼠标事件 event)

当用户按下文本字段时，会触发此信号。参数 event 提供有关按下的信息，包括按下的 x 和 y 坐标以及按下的按钮。

注意： 相应的处理程序是 onPressed。

该信号是在 QtQuick.Controls 2.1 (Qt 5.8) 中引入的。

另请参阅 released 和 pressAndHold。

[自 QtQuick.Controls 2.1 (Qt 5.8) 起支持] released(鼠标事件 event)

当用户释放文本字段时，会触发此信号。参数 event 提供有关释放的信息，包括按下的 x 和 y 坐标以及按下的按钮。

注意： 相应的处理程序是 onReleased。

该信号是在 QtQuick.Controls 2.1 (Qt 5.8) 中引入的。

另请参阅 pressed 和 pressAndHold。