Тип QML TextArea

Многострочное поле ввода текста. Подробнее...

• Список всех членов, включая наследуемые члены

Свойства

• background : Item
• bottomInset : real
• focusReason : перечисление
• hoverEnabled : bool
• hovered : bool
• implicitBackgroundHeight : real
• implicitBackgroundWidth : real
• leftInset : real
• placeholderText : строка
• placeholderTextColor : цвет
• rightInset : real
• topInset : real

Присоединенные свойства

• flickable : TextArea

Сигналы

• pressAndHold(MouseEvent event)
• pressed(MouseEvent event)
• released(MouseEvent event)

Подробное описание

TextArea — это многострочный редактор текста. TextArea расширяет TextEdit с функциональностью заполнительного текста и добавляет декорирование.

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

TextArea сам по себе не прокручивается. Особенно на платформах с ограниченным размером экрана часто предпочтительнее сделать прокручиваемыми страницы всего приложения. На такой прокручиваемой странице не прокручиваемый TextArea может работать лучше, чем вложенные элементы прокрутки. Однако обратите внимание, что в таком сценарии декорация фона TextArea прокручивается вместе с остальным прокручиваемым содержимым.

Прокручиваемый TextArea

Если вы хотите сделать TextArea прокручиваемым, например, когда он занимает всю страницу приложения, его можно поместить внутрь ScrollView.

ScrollView {
    id: view
    anchors.fill: parent

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

TextArea, размещенный внутри ScrollView, делает следующее:

• Автоматически устанавливает размер содержимого
• Обеспечивает, чтобы декорация фона оставалась на месте
• Обрезает содержимое

Фокус при нажатии Tab

По умолчанию при нажатии клавиши Tab, когда у TextArea есть активный фокус, в сам элемент вводится символ табуляции. Чтобы передать активный фокус другому элементу при нажатии Tab, используйте свойства KeyNavigation:

TextField {
    id: textField
}

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

См. также TextField, Настройка TextArea и Элементы ввода.

Документация по свойствам

background : Item

Это свойство содержит элемент фона.

См. также Настройка TextArea.

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

Это свойство содержит отступ снизу для фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет элемента управления и topInset.

focusReason : перечисление

Это свойство содержит причину последнего изменения фокуса.

См. также Item::activeFocus.

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

Это свойство определяет, принимает ли область текста события наведения. Значение по умолчанию — true.

Это свойство было добавлено в QtQuick.Controls 2.1 (Qt 5.8).

См. также hovered.

[только для чтения, с QtQuick.Controls 2.1 (Qt 5.8)] hovered : bool

Это свойство содержит значение, указывает ли область текста на себя.

Это свойство было добавлено в QtQuick.Controls 2.1 (Qt 5.8).

См. также hoverEnabled.

[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundHeight : real

Это свойство содержит неявную высоту фона.

Значение равно background ? background.implicitHeight : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitBackgroundWidth.

[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundWidth : real

Это свойство содержит неявшую ширину фона.

Значение равно background ? background.implicitWidth : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitBackgroundHeight.

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

Это свойство содержит левый отступ для фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет элемента управления и rightInset.

placeholderText : строка

Это свойство содержит краткое описание, отображаемое в области текста до ввода значения пользователем.

[с QtQuick.Controls 2.5 (Qt 5.12)] placeholderTextColor : цвет

Это свойство содержит цвет placeholderText.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также placeholderText.

[с QtQuick.Controls 2.5 (Qt 5.12)] rightInset : real

Это свойство содержит правый отступ для фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет элемента управления и leftInset.

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

Это свойство содержит отступ сверху для фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет элемента управления и bottomInset.

Документация по присоединенным свойствам

TextArea.flickable : TextArea

Это свойство прикрепляет текстовую область к Flickable.

См. также ScrollBar, ScrollIndicator и Прокручиваемая текстовая область.

Документация по сигналам

pressAndHold(MouseEvent event)

Этот сигнал излучается при длительном нажатии (задержка зависит от плагина платформы). Параметр event предоставляет информацию о нажатии, включая координаты x и y нажатия и нажатую кнопку.

Примечание: Соответствующий обработчик — onPressAndHold.

См. также pressed и released.

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

Этот сигнал излучается, когда пользователь нажимает на текстовую область. Параметр event предоставляет информацию о нажатии, включая координаты x и y нажатия и нажатую кнопку.

Примечание: Соответствующий обработчик — onPressed.

Этот сигнал был добавлен в QtQuick.Controls 2.1 (Qt 5.8).

См. также released и pressAndHold.

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

Этот сигнал излучается, когда пользователь отпускает нажатие на текстовую область. Параметр event предоставляет информацию об отпускании, включая координаты x и y нажатия и нажатую кнопку.

Примечание: Соответствующий обработчик — onReleased.

Этот сигнал был добавлен в QtQuick.Controls 2.1 (Qt 5.8).

См. также pressed и pressAndHold.