Тип 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.