Тип QML TextArea

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

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

Свойства

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

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

• flickable : TextArea

Сигналы

• void pressAndHold(MouseEvent event)
• void pressed(MouseEvent event)
• void 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 : Элемент

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

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

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

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

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

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

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

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

hoverEnabled : bool

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

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

См. также hovered.

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

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

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

См. также hoverEnabled.

placeholderText : строка

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

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

TextArea.flickable : TextArea

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

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

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

void pressAndHold(MouseEvent event)

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

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

void pressed(MouseEvent event)

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

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

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

void released(MouseEvent event)

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

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

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