InputMethod QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• inputContext : InputContext
• inputEngine : InputEngine

Señales

• selectionListActiveItemChanged(int type, int index)
• selectionListChanged(int type)
• selectionListsChanged() (since QtQuick.VirtualKeyboard 2.2)

Métodos

• bool clickPreeditText(int cursorPosition) (since QtQuick.VirtualKeyboard 2.4)
• list<int> inputModes(string locale)
• bool keyEvent(int key, string text, int modifiers)
• list<int> patternRecognitionModes() (since QtQuick.VirtualKeyboard 2.0)
• bool reselect(int cursorPosition, int reselectFlags) (since QtQuick.VirtualKeyboard 2.0)
• void reset()
• var selectionListData(int type, int index, int role)
• int selectionListItemCount(int type)
• void selectionListItemSelected(int type, int index)
• list<int> selectionLists()
• bool setInputMode(string locale, int inputMode)
• bool setTextCase(int textCase)
• Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo) (since QtQuick.VirtualKeyboard 2.0)
• bool traceEnd(Trace trace) (since QtQuick.VirtualKeyboard 2.0)
• void update()

Descripción detallada

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

Documentación de Propiedades

inputContext : InputContext [read-only]

El contexto de entrada.

inputEngine : InputEngine [read-only]

El motor de entrada.

Documentación de señales

selectionListActiveItemChanged(int type, int index)

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

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.

[since QtQuick.VirtualKeyboard 2.2] selectionListsChanged()

El método de entrada emite esta señal cuando los tipos de la lista de selección han cambiado. Esta señal activará una llamada al método selectionLists(), permitiendo al método de entrada actualizar los tipos de la lista de selección.

Esta señal fue introducida en QtQuick.VirtualKeyboard 2.2.

Documentación del método

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

Llamada cuando el usuario hace click en el texto pre-editado en cursorPosition.

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

Este método fue introducido 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 propósito de este método es manejar los eventos clave generados por el motor de entrada.

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

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

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

Devuelve la lista de modos de reconocimiento de patrones soportados.

Este método es invocado por el motor de entrada para consultar la lista de modos de reconocimiento de patrones soportados.

Este método fue introducido 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 cursorPosition. En reselectFlags se definen las reglas de selección de la palabra en relación con la posición del cursor.

• InputEngine.WordBeforeCursor Activar la palabra antes del cursor. Cuando se utiliza exclusivamente esta bandera, la palabra debe terminar exactamente en el cursor.
• InputEngine.WordAfterCursor Activar la palabra después del cursor. Cuando se utiliza exclusivamente este indicador, la palabra debe comenzar exactamente en el cursor.
• InputEngine.WordAtCursor Activar la palabra en el cursor. Esta bandera es una combinación de las anteriores con la excepción de que la palabra no puede empezar o terminar en el cursor.

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

Este método fue introducido en QtQuick.VirtualKeyboard 2.0.

void reset()

Este método es llamado por el motor de entrada cuando este método de entrada necesita ser reiniciado. El método de entrada sólo debe restablecer su estado interno. La principal diferencia con el método update() es que reset() sólo 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 un elemento 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 basado 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 identificados por type.

void selectionListItemSelected(int type, int index)

Se llama a este método cuando el usuario ha seleccionado un elemento en 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.

Este método es llamado por el motor de entrada cuando el método de entrada está siendo activado y cada vez que las sugerencias del método de entrada son actualizadas. 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 la señal selectionListsChanged(). Esta señal activará una llamada a este método, permitiendo al método de entrada actualizar los tipos de lista de selección.

bool setInputMode(string locale, int inputMode)

Cambia inputMode y locale para este método de entrada. El método devuelve true si tiene éxito.

bool setTextCase(int textCase)

Actualiza textCase para este método de entrada. El método devuelve true si tiene éxito.

Los valores posibles para el caso 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)

Se llama a este método cuando se inicia una interacción de rastreo con el patternRecognitionMode especificado. La traza se identifica unívocamente por el traceId. El traceCaptureDeviceInfo proporciona información sobre el dispositivo de origen y el traceScreenInfo proporciona información sobre el contexto de la 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 Trace es renderizado en pantalla, permanecerá allí hasta que el objeto Trace sea destruido.

Este método fue introducido en QtQuick.VirtualKeyboard 2.0.

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

Se llama a este método cuando finaliza la interacción de rastreo. El método de entrada debe destruir el objeto trace en algún momento después de que se llame a esta función. Devuelve true en caso de éxito.

Vea la API de Rastreo para Métodos de Entrada cómo acceder a los datos recolectados.

Este método fue introducido en QtQuick.VirtualKeyboard 2.0.

void update()

Este método es llamado por el motor de entrada cuando el método de entrada necesita ser actualizado. El método de entrada debe cerrar el texto actual previo a la edición y restaurar el estado interno al predeterminado.