InputEngine QML Type

Asigna la entrada del usuario a los métodos de entrada. Más...

• Lista de todos los miembros, incluidos los heredados

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 es responsable de enrutar los eventos de entrada a los métodos de entrada. La lógica de entrada real es implementada por los métodos de entrada.

El motor de entrada también incluye el método de entrada por defecto, que se encarga del procesamiento por defecto si el método de entrada activo no maneja el evento.

Documentación de propiedades

activeKey : int [read-only]

Tecla pulsada actualmente.

inputMethod : InputMethod

Utilice esta propiedad para establecer el método de entrada activo, o para controlar cuándo cambia el método de entrada activo.

inputMode : int

Utilice 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 por defecto para texto latino.
• InputEngine.InputMode.Numeric Sólo se permite la entrada numérica.
• InputEngine.InputMode.Dialable Sólo se permite la entrada marcable.
• 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 Katakana para japonés.
• InputEngine.InputMode.FullwidthLatin Modo de introducción de caracteres latinos de ancho completo para las 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 hebreo.
• InputEngine.InputMode.ChineseHandwriting Escritura china.
• InputEngine.InputMode.JapaneseHandwriting Escritura japonesa.
• InputEngine.InputMode.KoreanHandwriting Escritura coreana.
• InputEngine.InputMode.Thai Modo de introducción del tailandés.
• InputEngine.InputMode.Stroke Modo de entrada Stroke 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 alguna de las dependencias.

patternRecognitionModes : list<int> [read-only, since QtQuick.VirtualKeyboard 2.0]

La lista de modos de reconocimiento de patrones disponibles.

Valores posibles:

Esta propiedad fue introducida en QtQuick.VirtualKeyboard 2.0.

previousKey : int [read-only]

Tecla pulsada anteriormente.

wordCandidateListModel : SelectionListModel [read-only]

Utilice esta propiedad para acceder al modelo de lista de la lista de palabras candidatas.

wordCandidateListVisibleHint : bool [read-only]

Utilice esta propiedad para comprobar si la lista de palabras candidatas debe ser visible en la interfaz de usuario.

Documentación de la señal

void activeKeyChanged(int key)

Indica que la dirección key activa ha cambiado.

void inputMethodChanged()

Indica que el método de entrada ha cambiado.

void inputMethodReset()

Se emite cuando es necesario reiniciar el método de entrada.

void inputMethodUpdate()

void inputModeChanged()

Indica que el modo de entrada ha cambiado.

void inputModesChanged()

Indica que los modos de entrada disponibles han cambiado.

[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 InputEngine.PatternRecognitionMode.None
• InputEngine.PatternRecognitionMode.Handwriting Modo de reconocimiento de patrones para el reconocimiento de escritura a mano.
• InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete Utilice InputEngine.PatternRecognitionMode.Handwriting

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

void previousKeyChanged(int key)

Indica que el anterior key ha cambiado.

void virtualKeyClicked(int key, string text, int modifiers)

Indica que se ha hecho clic en la dirección virtual key con las direcciones text y modifiers. Esta señal se emite después de que el método de entrada haya procesado el evento clave.

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 rastreo con el motor de entrada.

La traza se identifica unívocamente mediante el traceId. El motor de entrada asignará el id al objeto Traza si el método de entrada acepta el evento.

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.

traceCaptureDeviceInfo proporciona información sobre el dispositivo de origen y traceScreenInfo proporciona información sobre el contexto de la pantalla.

Por definición, el objeto Trace permanece válido hasta que se llama al método traceEnd().

La interacción Trace finaliza llamando al método InputEngine.traceEnd().

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

bool traceEnd(Trace trace)

Finaliza la interacción de rastreo con el motor de entrada.

El objeto trace puede ser descartado en cualquier momento después de llamar a esta función.

La función devuelve true si la interacción de rastreo fue aceptada (es decir, los eventos táctiles no deben utilizarse para otra cosa).

void virtualKeyCancel()

Revierte el estado de la tecla activa sin emitir el evento de tecla. Este método es útil cuando el usuario descarta la tecla actual y es necesario restaurar el estado de la tecla.

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

Emite un evento de pulsación de tecla para los campos key, text y modifiers. Devuelve true si el evento de tecla fue aceptado por el motor de entrada.

bool virtualKeyPress(int key, string text, int modifiers, bool repeat)

Llamada por la capa del teclado para indicar que se ha pulsado key, con las dadas text y modifiers.

key se establece como tecla activa (tecla abajo). El evento de tecla real 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 la tecla también inicia el temporizador de repetición de teclas si repeat es true.

Devuelve true si la tecla fue aceptada por este motor de entrada.

Véase también virtualKeyCancel() y virtualKeyRelease().

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

Libera la tecla en key. El método emite un evento de clave 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 la clave ha sido aceptada por el motor de entrada.