Spec-Zone.ru › Qt 5.11

Тип QML TextField

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

Заявление об импорте: import QtQuick.Controls 2.4
С момента: Qt 5.7
Наследует:

TextInput

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

Свойства

  • background : Элемент
  • focusReason : перечисление
  • hoverEnabled : bool
  • hovered : bool
  • palette : палитра
  • placeholderText : строка

Сигналы

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

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

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

Поле ввода текста в обычном состоянии.

Поле ввода текста с активным фокусом.

Поле ввода текста, которое отключено.
TextField {
    placeholderText: qsTr("Enter name")
}

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

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

background : Элемент

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

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

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

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

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

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

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

Константа Описание
Qt.MouseFocusReason Произошло действие мыши.
Qt.TabFocusReason Нажата клавиша Tab.
Qt.BacktabFocusReason Произошла Backtab. Ввод может включать клавиши Shift или Ctrl; например, Shift+Tab.
Qt.ActiveWindowFocusReason Система окон сделала этот окно активным или неактивным.
Qt.PopupFocusReason Приложение открыло/закрыло всплывающее окно, которое захватило/освободило фокус клавиатуры.
Qt.ShortcutFocusReason Пользователь ввел ярлык метки.
Qt.MenuBarFocusReason Панель меню получила фокус.
Qt.OtherFocusReason Другая причина, обычно специфичная для приложения.

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

hoverEnabled : bool

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

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

См. также hovered.

[только для чтения] hovered : bool

Это свойство содержит значение, указывает ли поле ввода наведение.

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

См. также hoverEnabled.

palette : палитра

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

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

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

placeholderText : строка

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

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

pressAndHold(MouseEvent event)

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

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

pressed(MouseEvent event)

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

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

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

released(MouseEvent event)

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

Этот сигнал был введен в 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/archives/qt-5.11/qml-qtquick-controls2-textfield.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API