文本区域 QML 类型

多行文本输入区域。更多信息...

导入语句	import QtQuick.Controls
继承	TextEdit

成员列表，包括继承的成员

属性

背景 : Item
底部内边距 : 实数 (自 QtQuick.Controls 2.5 (Qt 5.12))
聚焦原因 : 枚举
悬停启用 : 布尔值 (自 QtQuick.Controls 2.1 (Qt 5.8))
悬停 : 布尔值 (自 QtQuick.Controls 2.1 (Qt 5.8))
隐式背景高度 : 实数 (自 QtQuick.Controls 2.5 (Qt 5.12))
隐式背景宽度 : 实数 (自 QtQuick.Controls 2.5 (Qt 5.12))
左侧内边距 : 实数 (自 QtQuick.Controls 2.5 (Qt 5.12))
占位文本 : 字符串
占位文本颜色 : 颜色 (自 QtQuick.Controls 2.5 (Qt 5.12))
右侧内边距 : 实数 (自 QtQuick.Controls 2.5 (Qt 5.12))
顶部内边距 : 实数 (自 QtQuick.Controls 2.5 (Qt 5.12))

附加属性

可轻扫的 : TextArea

信号

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

详细描述

TextArea 是一个多行文本编辑器。TextArea 扩展了 TextEdit，增加了占位文本功能，并添加了装饰。

TextArea {
    placeholderText: qsTr("Enter description")
}

文本区域本身不可滚动。特别是在屏幕尺寸受限的平台上，通常更倾向于将整个应用程序页面设为可滚动。在这样的可滚动页面上，一个不可滚动的文本区域可能比嵌套的可滚动控件表现得更好。请注意，在这种情况下，文本区域的背景装饰与可滚动内容一起滚动。

可滚动文本区域

如果您想使文本区域可滚动，例如，当它覆盖整个应用程序页面时，您可以将其放置在一个滚动视图内。

ScrollView {
    id: view
    anchors.fill: parent

    TextArea {
        text: "TextArea\n...\n...\n...\n...\n...\n...\n"
    }
}

放置在滚动视图内的文本区域可以进行以下操作

自动设置内容大小
确保背景装饰保持原位
裁剪内容

制表符焦点

默认情况下，当文本区域具有活动焦点并按下制表符键时，会将制表符字符输入到控件本身中。要使制表符将活动焦点传递到另一个项目，请使用附加的键导航属性

TextField {
    id: textField
}

TextArea {
    KeyNavigation.priority: KeyNavigation.BeforeItem
    KeyNavigation.tab: textField
}

另请参阅 文本字段、自定义文本区域和输入控件。

属性说明

背景 : 项目

此属性包含背景项目。

注意：如果背景项目没有指定显式大小，则它将自动跟随控件的大小。在大多数情况下，无需指定背景项的宽度和高度。

注意：大多数控件使用背景项的隐式大小来计算控制本身的隐式大小。如果您用自定义的背景项替换它，还应考虑为它提供一个合理的隐式大小（除非它是一个具有自己的隐式大小的项目，如图像）。

另请参阅：自定义文本区域。

底部缩进 : 实数 [自QtQuick.Controls 2.5 (Qt 5.12)起]

此属性包含背景的底部缩进。

此属性是在QtQuick.Controls 2.5 (Qt 5.12)中引入的。

另请参阅：控件布局和顶部缩进。

焦点原因 : 枚举

此属性包含最后焦点更改的原因。

注意：此属性不表示项目是否具有活动焦点，但表示项目获得或失去焦点的理由。

常数	描述
`Qt.MouseFocusReason`	发生鼠标操作。
`Qt.TabFocusReason`	按下了制表符键。
`Qt.BacktabFocusReason`	发生反向制表符。输入可能包括Shift或Control键；例如，Shift+Tab。
`Qt.ActiveWindowFocusReason`	窗口系统使此窗口变为活动或非活动。
`Qt.PopupFocusReason`	应用程序打开/关闭了一个弹出窗口，该窗口捕获/释放了键盘焦点。
`Qt.ShortcutFocusReason`	用户输入了一个标签的辅助快捷键。
`Qt.MenuBarFocusReason`	菜单栏获取了焦点。
`Qt.OtherFocusReason`	其他原因，通常是特定于应用程序的。

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

hoverEnabled : 布尔值 [自QtQuick.Controls 2.1 (Qt 5.8)起]

该属性确定文本区域是否接受悬停事件。默认值为 true。

该属性自 QtQuick.Controls 2.1（Qt 5.8）版本中引入。

另请参阅 hovered。

hovered : bool [只读，自 QtQuick.Controls 2.1（Qt 5.8）以来]

该属性表示文本区域是否被悬停。

该属性自 QtQuick.Controls 2.1（Qt 5.8）版本中引入。

另请参阅 hoverEnabled。

implicitBackgroundHeight : real [只读，自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含隐式背景高度。

值等于 background ? background.implicitHeight : 0。

此属性是在QtQuick.Controls 2.5 (Qt 5.12)中引入的。

另请参阅 implicitBackgroundWidth。

implicitBackgroundWidth : real [只读，自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含隐式背景宽度。

值等于 background ? background.implicitWidth : 0。

此属性是在QtQuick.Controls 2.5 (Qt 5.12)中引入的。

另请参阅 implicitBackgroundHeight。

leftInset : real [自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含背景的左侧缩进。

此属性是在QtQuick.Controls 2.5 (Qt 5.12)中引入的。

另请参阅 Control Layout 和 rightInset。

placeholderText : string

该属性包含在用户输入值之前在文本区域内显示的简短提示。

placeholderTextColor : color [自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含 placeholderText 的颜色。

此属性是在QtQuick.Controls 2.5 (Qt 5.12)中引入的。

另请参阅 placeholderText。

rightInset : real [自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含背景的右侧缩进。

此属性是在QtQuick.Controls 2.5 (Qt 5.12)中引入的。

另请参阅 Control Layout 和 leftInset。

topInset : real [自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含背景的顶部缩进。

此属性是在QtQuick.Controls 2.5 (Qt 5.12)中引入的。

另请参阅 Control Layout 和 bottomInset。

属性文档

TextArea.flickable : TextArea

该属性将文本区域附加到 Flickable。

另请参阅 滚动条，滚动指示器和可滚动文本区域。

信号文档

pressAndHold(MouseEvent event)

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

注意：相应的处理器是 onPressAndHold。

另请参阅 pressed 和 released。

[自 QtQuick.Controls 2.1 (Qt 5.8) 起] pressed(MouseEvent event)

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

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

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

另见：released 和 pressAndHold。

[自 QtQuick.Controls 2.1 (Qt 5.8) 起] released(MouseEvent event)

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

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

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

另见：pressed 和 pressAndHold。