InputEngine QML Type (Uncreatable)
Asigna la entrada del usuario a los métodos de entrada. Más...
| Import Statement: | import QtQuick.VirtualKeyboard |
| In C++: | QVirtualKeyboardInputEngine |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
- activeKey : int
- inputMethod : InputMethod
- inputMode : int
- inputModes : list<int>
- patternRecognitionModes : list<int>
(since QtQuick.VirtualKeyboard 2.0) - previousKey : int
- wordCandidateListModel : SelectionListModel
- wordCandidateListVisibleHint : bool
Señales
- void activeKeyChanged(int key)
- void inputMethodChanged()
- void inputMethodReset()
- void inputMethodUpdate()
- void inputModeChanged()
- void inputModesChanged()
- void patternRecognitionModesChanged()
(since QtQuick.VirtualKeyboard 2.0) - void previousKeyChanged(int key)
- void virtualKeyClicked(int key, string text, int modifiers)
Métodos
- Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
(since QtQuick.VirtualKeyboard 2.0) - bool traceEnd(Trace trace)
- void virtualKeyCancel()
- bool virtualKeyClick(int key, string text, int modifiers)
- bool virtualKeyPress(int key, string text, int modifiers, bool repeat)
- bool virtualKeyRelease(int key, string text, int modifiers)
Descripción detallada
El motor de entrada se encarga de dirigir los eventos de entrada a los métodos de entrada. La lógica de entrada propiamente dicha la implementan los métodos de entrada.
El motor de entrada también incluye el método de entrada predeterminado, que se encarga del procesamiento por defecto si el método de entrada activo no gestiona el evento.
Documentación de propiedades
activeKey : int [read-only]
Tecla pulsada actualmente.
inputMethod : InputMethod
Utiliza esta propiedad para establecer el método de entrada activo o para detectar cuándo cambia el método de entrada activo.
inputMode : int
Utiliza esta propiedad para obtener o establecer el modo de entrada actual. La propiedad « InputEngine::inputModes » proporciona la lista de modos de entrada válidos para el método de entrada y la configuración regional actuales.
Los modos de entrada predefinidos son:
InputEngine.InputMode.LatinEl modo de entrada predeterminado para texto en alfabeto latino.InputEngine.InputMode.NumericSolo se permite la entrada numérica.InputEngine.InputMode.DialableSolo se permite la entrada mediante marcación.InputEngine.InputMode.PinyinModo de entrada Pinyin para chino.InputEngine.InputMode.CangjieModo de entrada Cangjie para chino.InputEngine.InputMode.ZhuyinModo de entrada «Zhuyin» para chino.InputEngine.InputMode.HangulModo de entrada Hangul para coreano.InputEngine.InputMode.HiraganaModo de entrada Hiragana para japonés.InputEngine.InputMode.KatakanaModo de entrada Katakana para japonés.InputEngine.InputMode.FullwidthLatinModo de entrada de caracteres latinos de ancho completo para lenguas de Asia Oriental.InputEngine.InputMode.GreekModo de entrada griego.InputEngine.InputMode.CyrillicModo de entrada cirílico.InputEngine.InputMode.ArabicModo de entrada en árabe.InputEngine.InputMode.HebrewModo de entrada en hebreo.InputEngine.InputMode.ChineseHandwritingEscritura manuscrita china.InputEngine.InputMode.JapaneseHandwritingEscritura manuscrita en japonés.InputEngine.InputMode.KoreanHandwritingEscritura manuscrita coreana.InputEngine.InputMode.ThaiModo de entrada tailandés.InputEngine.InputMode.StrokeModo de entrada por trazos para chino.InputEngine.InputMode.RomajiModo de entrada «Romaji» para japonés.InputEngine.InputMode.HiraganaFlickModo de entrada «flick» para japonés.
inputModes : list<int> [read-only]
La lista de modos de entrada disponibles depende del método de entrada y de la configuración regional. Esta propiedad se actualiza cuando cambia cualquiera de estas dependencias.
patternRecognitionModes : list<int> [read-only, since QtQuick.VirtualKeyboard 2.0]
La lista de modos de reconocimiento de patrones disponibles.
Valores posibles:
| Constante | Descripción |
|---|---|
InputEngine.PatternRecognitionMode.None | El reconocimiento de patrones no está disponible. |
InputEngine.PatternRecognitionMode.PatternRecognitionDisabled | obsolete - Utiliza en su lugar « None ». |
InputEngine.PatternRecognitionMode.Handwriting | Modo de reconocimiento de patrones para el reconocimiento de escritura manuscrita. |
InputEngine.PatternRecognitionMode.HandwritingRecoginition | obsolete - Utiliza « Handwriting » en su lugar. |
Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.0.
previousKey : int [read-only]
Tecla pulsada anteriormente.
wordCandidateListModel : SelectionListModel [read-only]
Utiliza esta propiedad para acceder al modelo de lista de palabras candidatas.
wordCandidateListVisibleHint : bool [read-only]
Utiliza esta propiedad para comprobar si la lista de palabras sugeridas debe aparecer en la interfaz de usuario.
Documentación de Signal
void activeKeyChanged(int key)
Indica que el controlador « key » activo ha cambiado.
Nota: El controlador correspondiente es onActiveKeyChanged.
void inputMethodChanged()
Indica que el método de entrada ha cambiado.
Nota: El controlador correspondiente es onInputMethodChanged.
void inputMethodReset()
Se emite cuando es necesario restablecer el método de entrada.
Nota: Esta señal se conecta automáticamente a QVirtualKeyboardAbstractInputMethod::reset() y InputMethod::reset() cuando se activa el método de entrada.
Nota: El controlador correspondiente es onInputMethodReset.
void inputMethodUpdate()
Nota: Esta señal se conecta automáticamente a QVirtualKeyboardAbstractInputMethod::update() y InputMethod::update() cuando se activa el método de entrada.
Nota: El controlador correspondiente es onInputMethodUpdate.
void inputModeChanged()
Indica que el modo de entrada ha cambiado.
Nota: El controlador correspondiente es onInputModeChanged.
void inputModesChanged()
Indica que los modos de entrada disponibles han cambiado.
Nota: El controlador correspondiente es onInputModesChanged.
[since QtQuick.VirtualKeyboard 2.0] void patternRecognitionModesChanged()
Indica que los modos de reconocimiento de patrones disponibles han cambiado.
Los modos de reconocimiento de patrones predefinidos son:
InputEngine.PatternRecognitionMode.NoneEl reconocimiento de patrones no está disponible.InputEngine.PatternRecognitionMode.PatternRecognitionDisabledobsoleteUtilice ` .PatternRecognitionMode.None` InputEngineInputEngine.PatternRecognitionMode.HandwritingModo de reconocimiento de patrones para el reconocimiento de escritura manuscrita.InputEngine.PatternRecognitionMode.HandwritingRecoginitionobsoleteUtiliza ` .PatternRecognitionMode.Handwriting` InputEngine
Nota: El controlador correspondiente es onPatternRecognitionModesChanged.
Esta señal se introdujo en QtQuick.VirtualKeyboard 2.0.
void previousKeyChanged(int key)
Indica que el key anterior ha cambiado.
Nota: El controlador correspondiente es onPreviousKeyChanged.
void virtualKeyClicked(int key, string text, int modifiers)
Indica que se ha pulsado el botón virtual « key » con los valores « text » y « modifiers » especificados. Esta señal se emite una vez que el método de entrada ha procesado el evento de tecla.
Nota: El controlador correspondiente es onVirtualKeyClicked.
Documentación del método
[since QtQuick.VirtualKeyboard 2.0] Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
Inicia una interacción de seguimiento con el motor de entrada.
El seguimiento se identifica de forma única mediante el traceId. El motor de entrada asignará el identificador al objeto Trace si el método de entrada acepta el evento.
El ` patternRecognitionMode ` especifica el modo de reconocimiento utilizado para el patrón.
Si el método de entrada actual acepta el evento, devuelve un objeto «Trace» asociado a esta interacción. Si el método de entrada descarta el evento, devuelve un valor nulo.
El método ` traceCaptureDeviceInfo ` proporciona información sobre el dispositivo de origen y el método ` traceScreenInfo ` proporciona información sobre el contexto de pantalla.
Por definición, el objeto `Trace` permanece válido hasta que se llama al método ` traceEnd()`.
La interacción de seguimiento finaliza al llamar al método ` InputEngine.traceEnd()`.
Este método se introdujo en QtQuick.VirtualKeyboard 2.0.
bool traceEnd(Trace trace)
Finaliza la interacción de rastreo con el motor de entrada.
El objeto ` trace ` puede descartarse en cualquier momento tras llamar a esta función.
La función devuelve «true» si se ha aceptado la interacción de seguimiento (es decir, los eventos táctiles no deben utilizarse para ningún otro fin).
void virtualKeyCancel()
Restablece el estado de la tecla activa sin generar el evento de tecla. Este método resulta útil cuando el usuario descarta la tecla actual y es necesario restablecer el estado de la tecla.
bool virtualKeyClick(int key, string text, int modifiers)
Emite un evento de pulsación de tecla para los valores indicados: key, text y modifiers. Devuelve true si el motor de entrada ha aceptado el evento de tecla.
bool virtualKeyPress(int key, string text, int modifiers, bool repeat)
La capa del teclado llama a esta función para indicar que se ha pulsado la tecla « key », con los valores « text » y « modifiers » especificados.
La tecla key se establece como tecla activa (tecla pulsada). El evento de tecla propiamente dicho se activa cuando se suelta la tecla mediante el método virtualKeyRelease(). El evento de pulsación de tecla puede descartarse llamando a virtualKeyCancel().
La pulsación de tecla también inicia el temporizador de repetición de teclas si repeat es true.
Devuelve true si la tecla ha sido aceptada por este motor de entrada.
Véase también virtualKeyCancel() y virtualKeyRelease().
bool virtualKeyRelease(int key, string text, int modifiers)
Suelta la tecla en key. El método emite un evento de tecla para el método de entrada si el evento no ha sido generado por un temporizador de repetición. Los valores text y modifiers se pasan al método de entrada.
Devuelve true si el motor de entrada ha aceptado la tecla.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.