Тип 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

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

Примечание: Если элемент фона не имеет явных размеров, он автоматически следует за размером элемента управления. В большинстве случаев нет необходимости указывать ширину или высоту для элемента фона.

Примечание: Большинство элементов управления используют неявный размер элемента фона для расчета собственного неявного размера. Если вы замените элемент фона пользовательским, вы также должны рассмотреть возможность предоставления разумного неявного размера для него (если это не элемент, такой как Image, у которого есть свой неявный размер).

См. также Настройка 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.