Тип QML TextField

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

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

Свойства

• background : Item
• bottomInset : real
• focusReason : перечисление
• hoverEnabled : bool
• hovered : bool
• implicitBackgroundHeight : real
• implicitBackgroundWidth : real
• leftInset : real
• palette : palette
• 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.

bottomInset : real

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

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

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

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

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

См. также implicitBackgroundWidth.

[только для чтения] implicitBackgroundWidth : real

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

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

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

См. также implicitBackgroundHeight.

leftInset : real

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

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

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

palette : palette

Это свойство содержит палитру, текущую для текстового поля.

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

См. также Control::palette.

placeholderText : строка

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

placeholderTextColor : цвет

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

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

См. также placeholderText.

rightInset : real

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

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

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

topInset : real

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

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

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

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

pressAndHold(MouseEvent event)

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

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

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

pressed(MouseEvent event)

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

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

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

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

released(MouseEvent event)

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

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

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

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