Тип QML TextField
Однострочное поле ввода текста. Подробнее...
| Заявление об импорте: | import QtQuick.Controls 2.0 |
| С момента: | Qt 5.7 |
| Наследует: |
Свойства
- background : Элемент
- bottomInset : вещественное число
- focusReason : перечисление
- hoverEnabled : логическое значение
- hovered : логическое значение
- implicitBackgroundHeight : вещественное число
- implicitBackgroundWidth : вещественное число
- leftInset : вещественное число
- placeholderText : строка
- placeholderTextColor : цвет
- rightInset : вещественное число
- topInset : вещественное число
Сигналы
- pressAndHold(MouseEvent event)
- pressed(MouseEvent event)
- released(MouseEvent event)
Подробное описание
TextField — однострочный текстовый редактор. TextField расширяет TextInput функционалом заполнительного текста и добавляет оформление.
| Поле ввода в нормальном состоянии. | |
| Поле ввода с активным фокусом. | |
| Поле ввода, которое отключено. |
TextField {
placeholderText: qsTr("Enter name")
} См. также TextArea, Настройка TextField и Контролы ввода.
Документация по свойствам
background : Элемент
Это свойство содержит элемент фона.
Примечание: Если у элемента фона нет явных размеров, он автоматически следует за размером элемента управления. В большинстве случаев нет необходимости указывать ширину или высоту для элемента фона.
Примечание: Большинство элементов управления используют неявные размеры элемента фона для расчета неявных размеров самого элемента управления. Если вы замените элемент фона пользовательским, вам также следует рассмотреть возможность предоставления разумных неявных размеров для него (если это не элемент, как Image, у которого есть свои неявные размеры).
См. также Настройка TextField.
[с QtQuick.Controls 2.5 (Qt 5.12)] bottomInset : вещественное число
Это свойство содержит отступ снизу для фона.
Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).
См. также Макет элемента управления и topInset.
focusReason : перечисление
Это свойство содержит причину последнего изменения фокуса.
Примечание: Это свойство не указывает, имеет ли элемент управления активный фокус, но причину, по которой элемент управления либо получил, либо потерял фокус.
| Постоянная | Описание |
|---|---|
Qt.MouseFocusReason |
Произошло действие мыши. |
Qt.TabFocusReason |
Нажата клавиша Tab. |
Qt.BacktabFocusReason |
Произошла клавиша Backtab. Ввод может включать клавиши Shift или Control; например, Shift+Tab. |
Qt.ActiveWindowFocusReason |
Система окон сделала этот окно активным или неактивным. |
Qt.PopupFocusReason |
Приложение открыло/закрыло всплывающее окно, которое захватило/освободило фокус клавиатуры. |
Qt.ShortcutFocusReason |
Пользователь ввёл ярлык метки. |
Qt.MenuBarFocusReason |
Панель меню получила фокус. |
Qt.OtherFocusReason |
Другая причина, обычно специфичная для приложения. |
См. также Item::activeFocus.
[с QtQuick.Controls 2.1 (Qt 5.8)] hoverEnabled : логическое значение
Это свойство определяет, принимает ли поле ввода события наведения. Значение по умолчанию — false.
Это свойство было добавлено в QtQuick.Controls 2.1 (Qt 5.8).
См. также hovered.
[только для чтения, с QtQuick.Controls 2.1 (Qt 5.8)] hovered : логическое значение
Это свойство содержит значение, указывающее, находится ли поле ввода под курсором.
Это свойство было добавлено в QtQuick.Controls 2.1 (Qt 5.8).
См. также hoverEnabled.
[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundHeight : вещественное число
Это свойство содержит неявную высоту фона.
Значение равно background ? background.implicitHeight : 0.
Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).
См. также implicitBackgroundWidth.
[только для чтения, с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundWidth : вещественное число
Это свойство содержит неявную ширину фона.
Значение равно background ? background.implicitWidth : 0.
Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).
См. также implicitBackgroundHeight.
[с QtQuick.Controls 2.5 (Qt 5.12)] leftInset : вещественное число
Это свойство содержит левый отступ для фона.
Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).
См. также Макет элемента управления и rightInset.
placeholderText : строка
Это свойство содержит подсказку, отображаемую в TextField до ввода текста пользователем.
[с QtQuick.Controls 2.5 (Qt 5.12)] placeholderTextColor : цвет
Это свойство содержит цвет placeholderText.
Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).
См. также placeholderText.
[с QtQuick.Controls 2.5 (Qt 5.12)] rightInset : вещественное число
Это свойство содержит правый отступ для фона.
Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).
См. также Макет элемента управления и leftInset.
[с QtQuick.Controls 2.5 (Qt 5.12)] topInset : вещественное число
Это свойство содержит верхний отступ для фона.
Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).
См. также Макет элемента управления и bottomInset.
Документация по сигналам
pressAndHold(MouseEvent event)
Этот сигнал генерируется при длительном нажатии (задержка зависит от плагина платформы). Параметр event предоставляет информацию о нажатии, включая координаты x и y нажатия и нажатую кнопку.
Примечание: Соответствующий обработчик — onPressAndHold.
[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.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qml-qtquick-controls2-textfield.html