Тип QML TextArea

Область ввода текста с несколькими строками. Подробнее...

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

Свойства

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

Прикреплённые свойства

• 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 : Item

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

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

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

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

bottomInset : real

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

Это свойство было введено в 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 : real

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

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

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

См. также implicitBackgroundWidth.

[только для чтения] implicitBackgroundWidth : real

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

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

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

См. также implicitBackgroundHeight.

leftInset : real

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

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

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

palette : palette

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

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

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

placeholderText : string

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

placeholderTextColor : color

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

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

См. также placeholderText.

rightInset : real

Это свойство задаёт правый отступ для фона.

Это свойство было добавлено в 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.