Тип 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 нажатия и нажатую кнопку.

См. также 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.