Тип QML TextField

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

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

Свойства

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

Сигналы

• void pressAndHold(MouseEvent event)
• void pressed(MouseEvent event)
• void released(MouseEvent event)

Подробное описание

TextField — однострочный редактор текста. TextField расширяет TextInput функционалом «заполнитель текста» и добавляет декорации.

TextField {
    placeholderText: qsTr("Enter name")
}

См. также TextArea, Настройка TextField и Элементы управления вводом.

Документация свойств

background : Элемент

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

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

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

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

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

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

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

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

hoverEnabled : bool

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

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

См. также hovered.

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

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

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

См. также hoverEnabled.

placeholderText : строка

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

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

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.