Тип QML TextArea

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

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

Свойства

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

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

• 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 есть активный фокус, приводит к вводу символа табуляции в само поле. Чтобы передать активный фокус на другой элемент, используйте присоединённые свойства KeyNavigation:

TextField {
    id: textField
}

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

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

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

background : Item

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

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

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

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

bottomInset : вещественное

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

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

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

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

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

Примечание: Это свойство не указывает, имеет ли элемент управления активный фокус, но указывает причину, по которой элемент управления либо получил, либо потерял фокус.

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

hoverEnabled : bool

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

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

См. также hovered.

[только для чтения] hovered : bool

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

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

См. также hoverEnabled.

[только для чтения] implicitBackgroundHeight : вещественное

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

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

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

См. также implicitBackgroundWidth.

[только для чтения] implicitBackgroundWidth : вещественное

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

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

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

См. также implicitBackgroundHeight.

leftInset : вещественное

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

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

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

palette : палитра

Это свойство содержит палитру, текущую для области текста.

Это свойство было введено в QtQuick.Controls 2.3 (Qt 5.10).

См. также Control::palette.

placeholderText : строка

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

placeholderTextColor : цвет

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

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

См. также placeholderText.

rightInset : вещественное

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

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

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

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.

pressed(MouseEvent event)

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

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

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

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

released(MouseEvent event)

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

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

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

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