Тип QML TextArea

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

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

Свойства

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

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

• 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 : Элемент

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

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

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

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

[с QtQuick.Controls 2.5 (Qt 5.12)] bottomInset : real

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

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

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

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

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

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

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

[с QtQuick.Controls 2.1 (Qt 5.8)] hoverEnabled : bool

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

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

См. также hovered.

[только для чтения, с QtQuick.Controls 2.1 (Qt 5.8)] hovered : bool

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

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

См. также hoverEnabled.

[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundHeight : real

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

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

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

См. также implicitBackgroundWidth.

[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundWidth : real

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

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

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

См. также implicitBackgroundHeight.

[с QtQuick.Controls 2.5 (Qt 5.12)] leftInset : real

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

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

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

placeholderText : строка

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

[с QtQuick.Controls 2.5 (Qt 5.12)] placeholderTextColor : цвет

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

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

См. также placeholderText.

[с QtQuick.Controls 2.5 (Qt 5.12)] rightInset : real

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

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

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

[since QtQuick.Controls 2.5 (Qt 5.12)] 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.

[since QtQuick.Controls 2.1 (Qt 5.8)] pressed(MouseEvent event)

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

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

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

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

[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)

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

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

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

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