Тип QML TextField

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

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

Свойства

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

Сигналы

• pressAndHold(event)
• pressed(event)
• released(event)

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

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

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

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

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

background : Item

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

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

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

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

bottomInset : вещественное число

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

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

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

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

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

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

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

hoverEnabled : bool

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

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

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

placeholderTextColor : цвет

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

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

См. также placeholderText.

rightInset : вещественное число

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

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

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

topInset : вещественное число

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

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

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

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

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.