Тип QML TextArea

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

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

Свойства

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

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

• flickable : TextArea

Сигналы

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

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

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

Примечание: Большинство элементов управления используют неявный размер элемента фона для вычисления неявного размера самого элемента управления. Если вы заменяете элемент фона пользовательским элементом, вы также должны учесть предоставление разумного неявного размера для него (если это не элемент, например, 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(event)

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

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

pressed(event)

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

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

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

released(event)

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

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

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