Тип QML TextField

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

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

Свойства

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

Сигналы

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

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

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

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

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

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

background : Item

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

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

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

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

[с QtQuick.Controls 2.5 (Qt 5.12)] bottomInset : real

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

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

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

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

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

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

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

[с QtQuick.Controls 2.1 (Qt 5.8)] hoverEnabled : bool

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

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

См. также hovered.

[только для чтения, с QtQuick.Controls 2.1 (Qt 5.8)] hovered : bool

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

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

См. также hoverEnabled.

[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundHeight : real

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

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

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

См. также implicitBackgroundWidth.

[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundWidth : real

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

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

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

См. также implicitBackgroundHeight.

[с QtQuick.Controls 2.5 (Qt 5.12)] leftInset : real

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

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

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

placeholderText : string

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

[с QtQuick.Controls 2.5 (Qt 5.12)] placeholderTextColor : color

Это свойство содержит цвет подсказки placeholderText.

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

См. также placeholderText.

[с QtQuick.Controls 2.5 (Qt 5.12)] rightInset : real

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

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

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

[с QtQuick.Controls 2.5 (Qt 5.12)] topInset : real

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

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

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

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

pressAndHold(MouseEvent event)

Этот сигнал испускается при длительном нажатии (задержка зависит от плагина платформы). Параметр event предоставляет информацию о нажатии, включая координаты x и y нажатия и нажатую кнопку.

Примечание: Соответствующий обработчик — onPressAndHold.

См. также pressed и released.

[since QtQuick.Controls 2.1 (Qt 5.8)] pressed(MouseEvent event)

Этот сигнал излучается, когда пользователь нажимает на поле ввода текста. Параметр event предоставляет информацию о нажатии, включая координаты x и y нажатия и нажатую кнопку.

Примечание: Соответствующий обработчик — onPressed.

Этот сигнал был представлен в QtQuick.Controls 2.1 (Qt 5.8).

См. также released и pressAndHold.

[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)

Этот сигнал излучается, когда пользователь отпускает нажатие на поле ввода текста. Параметр event предоставляет информацию об отпускании, включая координаты x и y нажатия и нажатую кнопку.

Примечание: Соответствующий обработчик — onReleased.

Этот сигнал был представлен в QtQuick.Controls 2.1 (Qt 5.8).

См. также pressed и pressAndHold.