En esta página

InputMethod QML Type

Tipo base para crear un método de entrada en QML. Más...

Import Statement: import QtQuick.VirtualKeyboard

Propiedades

Señales

Métodos

Descripción detallada

El tipo InputMethod te permite crear un método de entrada personalizado que se puede asignar a InputEngine.

Documentación de las propiedades

inputContext : InputContext [read-only]

El contexto de entrada.

inputEngine : InputEngine [read-only]

El motor de entrada.

Documentación de Signal

selectionListActiveItemChanged(int type, int index)

El método de entrada emite esta señal cuando el elemento « index » actual ha cambiado en la lista de selección identificada por « type ».

Nota: El controlador correspondiente es onSelectionListActiveItemChanged.

selectionListChanged(int type)

El método de entrada emite esta señal cuando se modifica el contenido de la lista de selección. El parámetro « type » especifica qué lista de selección ha cambiado.

Nota: El controlador correspondiente es onSelectionListChanged.

[since QtQuick.VirtualKeyboard 2.2] selectionListsChanged()

El método de entrada emite esta señal cuando cambian los tipos de la lista de selección. Esta señal activará una llamada al método ` selectionLists()`, lo que permitirá al método de entrada actualizar los tipos de la lista de selección.

Nota: El controlador correspondiente es onSelectionListsChanged.

Esta señal se introdujo en QtQuick.VirtualKeyboard 2.2.

Documentación del método

[since QtQuick.VirtualKeyboard 2.4] bool clickPreeditText(int cursorPosition)

Se invoca cuando el usuario hace clic en el texto de preedición en cursorPosition.

La función debe devolver ` true ` si gestiona el evento. De lo contrario, la entrada se redirige a ` reselect()` para su posterior procesamiento.

Este método se introdujo en QtQuick.VirtualKeyboard 2.4.

list<int> inputModes(string locale)

Devuelve una lista de modos de entrada para ` locale`.

bool keyEvent(int key, string text, int modifiers)

El objetivo de este método es gestionar los eventos de teclas generados por el motor de entrada.

El parámetro ` key ` especifica el código de la tecla que se va a gestionar. El código de la tecla no distingue entre mayúsculas y minúsculas. El parámetro ` text ` contiene el texto Unicode correspondiente a la tecla. El parámetro ` modifiers ` contiene los modificadores de tecla que se aplican a ` key`.

Este método devuelve « true » si el evento de tecla se ha gestionado correctamente. Si el valor devuelto es « false », el evento de tecla se redirige al método de entrada predeterminado para su posterior procesamiento.

[since QtQuick.VirtualKeyboard 2.0] list<int> patternRecognitionModes()

Devuelve una lista de los modos de reconocimiento de patrones compatibles.

El motor de entrada invoca este método para consultar la lista de modos de reconocimiento de patrones compatibles.

Este método se introdujo en QtQuick.VirtualKeyboard 2.0.

[since QtQuick.VirtualKeyboard 2.0] bool reselect(int cursorPosition, int reselectFlags)

Este método intenta volver a seleccionar una palabra situada en la cursorPosition. El reselectFlags define las reglas sobre cómo debe seleccionarse la palabra en relación con la posición del cursor.

  • InputEngine.WordBeforeCursor Activar la palabra situada antes del cursor. Cuando se utiliza esta opción de forma exclusiva, la palabra debe terminar exactamente en el cursor.
  • InputEngine.WordAfterCursor Activar la palabra situada después del cursor. Cuando se utiliza esta opción de forma exclusiva, la palabra debe comenzar exactamente en el cursor.
  • InputEngine.WordAtCursor Activa la palabra en la que se encuentra el cursor. Esta opción es una combinación de las anteriores, con la excepción de que la palabra no puede comenzar ni terminar en el cursor.

El método devuelve un true o si la palabra se ha vuelto a seleccionar correctamente.

Este método se introdujo en QtQuick.VirtualKeyboard 2.0.

void reset()

El motor de entrada invoca este método cuando es necesario restablecer este método de entrada. El método de entrada solo debe restablecer su estado interno. La principal diferencia con respecto al método update() es que reset() solo modifica el estado del método de entrada; no debe modificar el contexto de entrada.

var selectionListData(int type, int index, int role)

Devuelve los datos de los elementos de una lista de selección identificada por ` type`. El parámetro ` role ` especifica qué datos se solicitan. El parámetro ` index ` es un índice, con base en cero, dentro de la lista de selección.

int selectionListItemCount(int type)

Devuelve el número de elementos de la lista de selección identificada por ` type`.

void selectionListItemSelected(int type, int index)

Este método se invoca cuando el usuario ha seleccionado un elemento de « index ». La lista de selección se identifica mediante el parámetro « type ».

list<int> selectionLists()

Devuelve la lista de tipos de selección utilizados para este método de entrada.

El motor de entrada invoca este método cuando se activa el método de entrada y cada vez que se actualizan las sugerencias del método de entrada. El método de entrada puede reservar listas de selección devolviendo los tipos de lista de selección deseados.

El método de entrada puede solicitar al motor de entrada que actualice las listas de selección en cualquier momento emitiendo una señal « selectionListsChanged()». Esta señal activará una llamada a este método, lo que permitirá al método de entrada actualizar los tipos de listas de selección.

bool setInputMode(string locale, int inputMode)

Modifica inputMode y locale para este método de entrada. El método devuelve true si se ejecuta correctamente.

bool setTextCase(int textCase)

Actualiza ` textCase ` para este método de entrada. El método devuelve ` true ` si se ejecuta correctamente.

Los valores posibles para el tipo de texto son:

  • InputEngine.Lower Texto en minúsculas.
  • InputEngine.Upper Texto en mayúsculas.

[since QtQuick.VirtualKeyboard 2.0] Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)

Este método se invoca cuando se inicia una interacción de rastreo con el patternRecognitionMode especificado. El rastreo se identifica de forma única mediante el traceId. El traceCaptureDeviceInfo proporciona información sobre el dispositivo de origen y el traceScreenInfo proporciona información sobre el contexto de pantalla.

Si el método de entrada acepta el evento y desea capturar la entrada de rastreo, debe devolver un nuevo objeto Trace. Este objeto debe permanecer válido hasta que se llame al método InputMethod.traceEnd(). Si el rastreo se muestra en pantalla, permanece allí hasta que se destruya el objeto Trace.

Este método se introdujo en QtQuick.VirtualKeyboard 2.0.

[since QtQuick.VirtualKeyboard 2.0] bool traceEnd(Trace trace)

Este método se invoca cuando finaliza la interacción de rastreo. El método de entrada debe destruir el objeto ` trace ` en algún momento tras la invocación de esta función. Devuelve ` true ` si se ejecuta correctamente.

Consulta la API de seguimiento para métodos de entrada para saber cómo acceder a los datos recopilados.

Este método se introdujo en QtQuick.VirtualKeyboard 2.0.

void update()

El motor de entrada invoca este método cuando es necesario actualizar el método de entrada. El método de entrada debe cerrar el texto de preedición actual y restablecer el estado interno a los valores predeterminados.

© 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.