Тип QML TextField
Однострочное поле ввода текста. Подробнее...
| Заявление об импорте: | import QtQuick.Controls |
| С тех пор: | Qt 5.7 |
| Наследует: |
Свойства
- background : Item
- bottomInset : вещественное
- focusReason : перечисление
- hoverEnabled : bool
- hovered : bool
- 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 : Item
Это свойство содержит элемент фона.
Примечание: Если элемент фона не имеет явно указанного размера, он автоматически следует за размером элемента управления. В большинстве случаев нет необходимости указывать ширину или высоту для элемента фона.
Примечание: Большинство элементов управления используют неявный размер элемента фона для расчета неявного размера самого элемента управления. Если вы заменяете элемент фона пользовательским, вы также должны рассмотреть возможность предоставления разумного неявного размера для него (если это не элемент, такой как 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 : 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 : вещественное
Это свойство содержит неявную высоту фона.
Значение равно 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.2/qml-qtquick-controls2-textfield.html
