En esta página

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

Señales

Métodos

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.Latin El modo de entrada predeterminado para texto en alfabeto latino.
  • InputEngine.InputMode.Numeric Solo se permite la entrada numérica.
  • InputEngine.InputMode.Dialable Solo se permite la entrada mediante marcación.
  • InputEngine.InputMode.Pinyin Modo de entrada Pinyin para chino.
  • InputEngine.InputMode.Cangjie Modo de entrada Cangjie para chino.
  • InputEngine.InputMode.Zhuyin Modo de entrada «Zhuyin» para chino.
  • InputEngine.InputMode.Hangul Modo de entrada Hangul para coreano.
  • InputEngine.InputMode.Hiragana Modo de entrada Hiragana para japonés.
  • InputEngine.InputMode.Katakana Modo de entrada Katakana para japonés.
  • InputEngine.InputMode.FullwidthLatin Modo de entrada de caracteres latinos de ancho completo para lenguas de Asia Oriental.
  • InputEngine.InputMode.Greek Modo de entrada griego.
  • InputEngine.InputMode.Cyrillic Modo de entrada cirílico.
  • InputEngine.InputMode.Arabic Modo de entrada en árabe.
  • InputEngine.InputMode.Hebrew Modo de entrada en hebreo.
  • InputEngine.InputMode.ChineseHandwriting Escritura manuscrita china.
  • InputEngine.InputMode.JapaneseHandwriting Escritura manuscrita en japonés.
  • InputEngine.InputMode.KoreanHandwriting Escritura manuscrita coreana.
  • InputEngine.InputMode.Thai Modo de entrada tailandés.
  • InputEngine.InputMode.Stroke Modo de entrada por trazos para chino.
  • InputEngine.InputMode.Romaji Modo de entrada «Romaji» para japonés.
  • InputEngine.InputMode.HiraganaFlick Modo 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:

ConstanteDescripción
InputEngine.PatternRecognitionMode.NoneEl reconocimiento de patrones no está disponible.
InputEngine.PatternRecognitionMode.PatternRecognitionDisabledobsolete - Utiliza en su lugar « None ».
InputEngine.PatternRecognitionMode.HandwritingModo de reconocimiento de patrones para el reconocimiento de escritura manuscrita.
InputEngine.PatternRecognitionMode.HandwritingRecoginitionobsolete - 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.None El reconocimiento de patrones no está disponible.
  • InputEngine.PatternRecognitionMode.PatternRecognitionDisabled obsolete Utilice ` .PatternRecognitionMode.None` InputEngine
  • InputEngine.PatternRecognitionMode.Handwriting Modo de reconocimiento de patrones para el reconocimiento de escritura manuscrita.
  • InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete Utiliza ` .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.