Тип QML TextField

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

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

Свойства

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

Сигналы

• pressAndHold(MouseEvent event)
• pressed(MouseEvent event)
• released(MouseEvent 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(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.