Тип QML BaseKey
Общий родитель для всех типов ключей. Подробнее...
| Описание импорта: | import QtQuick.VirtualKeyboard |
| Наследует: | |
| Наследуется от: | BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, HideKeyboardKey, Ключ, и ShiftKey |
Свойства
- active : bool
- alternativeKeys : var
- displayAlternativeKeys : var
- displayText : string
- effectiveAlternativeKeys : var
- effectiveAlternativeKeysHighlightIndex : int
- functionKey : bool
- highlighted : bool
- key : int
- keyPanelDelegate : alias
- keyType : int
- noKeyEvent : bool
- noModifier : bool
- pressed : bool
- repeat : bool
- showPreview : bool
- smallText : string
- smallTextVisible : bool
- soundEffect : url
- text : string
- uppercased : bool
- weight : real
Сигналы
- clicked()
Подробное описание
BaseKey — это общий тип для всех клавиш в раскладке клавиатуры.
Этот тип не следует использовать напрямую в макетах. Вместо этого следует использовать специализированные типы ключей, такие как Key или EnterKey.
Документация по свойствам
active : bool
Это свойство хранит активное состояние клавиши.
Это свойство автоматически устанавливается в значение true при нажатии клавиши.
alternativeKeys : var
Устанавливает список альтернативных клавиш.
Это свойство можно установить в строку или список строк. Если значением является строка, альтернативные клавиши представлены отдельными символами этой строки. Если значением является список строк, используется этот список.
Альтернативные клавиши отображаются пользователю при удерживании клавиши с установленным этим свойством.
Примечание: Если альтернативные клавиши содержат ключ text, он будет отфильтрован из effectiveAlternativeKeys , а его позиция будет использована как показатель выделенного элемента.
Значение по умолчанию — пустой список.
[since QtQuick.VirtualKeyboard 6.2] displayAlternativeKeys : var
Это свойство позволяет переопределить список строк клавиш, отображаемых пользователю в представлении альтернативных клавиш.
Это свойство было добавлено в QtQuick.VirtualKeyboard 6.2.
displayText : string
Устанавливает отображаемый текст.
Эта строка отображается в раскладке клавиатуры.
Значение по умолчанию — текст клавиши.
[только для чтения, начиная с QtQuick.VirtualKeyboard 2.0] effectiveAlternativeKeys : var
Это свойство содержит эффективные альтернативные клавиши, представленные пользователю.
Список содержит элементы из alternativeKeys за исключением элемента text.
Это свойство было добавлено в QtQuick.VirtualKeyboard 2.0.
[только для чтения, начиная с QtQuick.VirtualKeyboard 2.0] effectiveAlternativeKeysHighlightIndex : int
Это свойство содержит индекс выделенного элемента в effectiveAlternativeKeys.
Индекс рассчитывается из индекса клавиши text в alternativeKeys.
Например, если альтернативные клавиши содержат "çcċčć", а клавиша text — "c", этот индекс станет 1, а эффективные альтернативные клавиши, отображаемые пользователю, будут "ç[ċ]čć".
Это свойство было добавлено в QtQuick.VirtualKeyboard 2.0.
functionKey : bool
Устанавливает атрибут функциональной клавиши.
Значение по умолчанию — false.
highlighted : bool
Устанавливает состояние выделения клавиши.
Значение по умолчанию — false.
key : int
Устанавливает код клавиши для обработки ввода.
Значение по умолчанию — Qt.Key_unknown.
keyPanelDelegate : alias
Устанавливает делегата панели клавиш для клавиши.
Это свойство имеет важное значение для оформления клавиш. Без делегата панели клавиш клавиша не отображается. Это свойство должно быть назначено в наследуемом типе клавиш.
[since QtQuick.VirtualKeyboard 6.1] keyType : int
Тип клавиши.
QtVirtualKeyboard.BaseKeyQtVirtualKeyboard.BackspaceKeyQtVirtualKeyboard.ChangeLanguageKeyQtVirtualKeyboard.EnterKeyQtVirtualKeyboard.FillerKeyQtVirtualKeyboard.HandwritingModeKeyQtVirtualKeyboard.HideKeyboardKeyQtVirtualKeyboard.InputModeKeyQtVirtualKeyboard.KeyQtVirtualKeyboard.ModeKeyQtVirtualKeyboard.NumberKeyQtVirtualKeyboard.ShiftKeyQtVirtualKeyboard.SpaceKeyQtVirtualKeyboard.SymbolModeKeyQtVirtualKeyboard.FlickKey
Это свойство было добавлено в QtQuick.VirtualKeyboard 6.1.
[since QtQuick.VirtualKeyboard 1.3] noKeyEvent : bool
Это свойство управляет тем, отправляются ли события клавиши для обработки ввода. Если true, события клавиш отключены.
По умолчанию событие клавиши отправляется, если key не неизвестно или text не пусто.
Это свойство было добавлено в QtQuick.VirtualKeyboard 1.3.
[since QtQuick.VirtualKeyboard 1.3] noModifier : bool
Отключает модификаторы клавиш в отправляемом событии.
Значение по умолчанию — false.
Это свойство было добавлено в QtQuick.VirtualKeyboard 1.3.
pressed : bool
Это свойство хранит состояние нажатия клавиши.
Состояние нажатия может быть только true, если клавиша включена и активна. Когда состояние клавиши становится нажатым, это вызывает событие нажатия клавиши для движка ввода. Событие отпускания клавиши вызывается при отпускании клавиши.
repeat : bool
Устанавливает атрибут повтора клавиши.
Если повторение включено, клавиша будет повторять события ввода при удерживании. Повторение не следует использовать, если также установлено свойство alternativeKeys.
Значение по умолчанию — false.
showPreview : bool
Устанавливает атрибут отображения предварительного просмотра.
По умолчанию всплывающее окно предварительного просмотра символа не отображается для функциональных клавиш.
[since QtQuick.VirtualKeyboard 2.0] smallText : string
Устанавливает небольшой текст, отображаемый в углу клавиши.
Значение по умолчанию основано на значении по умолчанию элемента в эффективных альтернативных ключах.
Это свойство было добавлено в QtQuick.VirtualKeyboard 2.0.
[since QtQuick.VirtualKeyboard 2.0] smallTextVisible : bool
Устанавливает видимость малого текста.
Значение по умолчанию наследуется от родителя.
Это свойство было добавлено в QtQuick.VirtualKeyboard 2.0.
[только для чтения, начиная с QtQuick.VirtualKeyboard 1.1] soundEffect : url
Это свойство содержит звуковой эффект, который должен воспроизводиться при нажатии клавиши.
Это свойство является только для чтения, так как звуковые эффекты определяются в стиле клавиатуры.
Это свойство было добавлено в QtQuick.VirtualKeyboard 1.1.
text : string
Устанавливает текст клавиши для обработки методом ввода.
В большинстве случаев это уникод-представление кода клавиши.
Значение по умолчанию — пустая строка.
uppercased : bool
Это свойство содержит состояние заглавных букв клавиши.
По умолчанию это свойство отражает состояние заглавных букв клавиатуры.
weight : real
Устанавливает значение веса клавиши, определяющее её относительный размер.
Используйте это свойство для изменения размера клавиши в макете.
Значение по умолчанию наследуется от родительского элемента клавиши в иерархии макета.
Документация сигналов
clicked()
Этот сигнал срабатывает при нажатии клавиши, позволяя выполнять пользовательскую обработку клавиши.
Примечание: Соответствующий обработчик — onClicked.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtquick-virtualkeyboard-basekey.html