Тип QML TextArea

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

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

Свойства

• background : Элемент
• focusReason : перечисление
• hoverEnabled : bool
• hovered : bool
• palette : палитра
• placeholderText : строка

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

• 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, делает следующее:

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

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

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

background : Элемент

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

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

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

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

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

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

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

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

hoverEnabled : bool

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

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

См. также hovered.

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

Это свойство указывает, находится ли текстовое поле под курсором.

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

См. также hoverEnabled.

palette : палитра

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

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

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

placeholderText : строка

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

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

TextArea.flickable : TextArea

Это свойство присоединяет текстовое поле к Flickable.

См. также ScrollBar, ScrollIndicator и Прокручиваемый TextArea.

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

pressAndHold(MouseEvent event)

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

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

pressed(MouseEvent event)

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

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

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

released(MouseEvent event)

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

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

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