InputEngine QML Type

Met en correspondance l'entrée de l'utilisateur avec les méthodes d'entrée. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• activeKey : int
• inputMethod : InputMethod
• inputMode : int
• inputModes : list<int>
• patternRecognitionModes : list<int> (since QtQuick.VirtualKeyboard 2.0)
• previousKey : int
• wordCandidateListModel : SelectionListModel
• wordCandidateListVisibleHint : bool

Signaux

• 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éthodes

• 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)

Description détaillée

Le moteur de saisie est responsable de l'acheminement des événements de saisie vers les méthodes de saisie. La logique d'entrée proprement dite est mise en œuvre par les méthodes d'entrée.

Le moteur de saisie comprend également la méthode de saisie par défaut, qui se charge du traitement par défaut si la méthode de saisie active ne gère pas l'événement.

Documentation sur les propriétés

activeKey : int [read-only]

Touche actuellement enfoncée.

inputMethod : InputMethod

Cette propriété permet de définir la méthode d'entrée active ou de surveiller le changement de méthode d'entrée active.

inputMode : int

Utilisez cette propriété pour obtenir ou définir le mode de saisie actuel. La propriété InputEngine::inputModes fournit la liste des modes de saisie valides pour la méthode de saisie et la locale actuelles.

Les modes de saisie prédéfinis sont les suivants :

• InputEngine.InputMode.Latin Le mode de saisie par défaut pour le texte latin.
• InputEngine.InputMode.Numeric Seule la saisie numérique est autorisée.
• InputEngine.InputMode.Dialable Seule la saisie numérique est autorisée.
• InputEngine.InputMode.Pinyin Mode de saisie Pinyin pour le chinois.
• InputEngine.InputMode.Cangjie Mode de saisie Cangjie pour le chinois.
• InputEngine.InputMode.Zhuyin Mode de saisie Zhuyin pour le chinois.
• InputEngine.InputMode.Hangul Mode de saisie Hangul pour le coréen.
• InputEngine.InputMode.Hiragana Mode de saisie Hiragana pour le japonais.
• InputEngine.InputMode.Katakana Mode de saisie Katakana pour le japonais.
• InputEngine.InputMode.FullwidthLatin Mode d'entrée latin pleine largeur pour les langues d'Asie de l'Est.
• InputEngine.InputMode.Greek Mode de saisie en grec.
• InputEngine.InputMode.Cyrillic Mode de saisie cyrillique.
• InputEngine.InputMode.Arabic Mode de saisie arabe.
• InputEngine.InputMode.Hebrew Mode de saisie de l'hébreu.
• InputEngine.InputMode.ChineseHandwriting Écriture chinoise.
• InputEngine.InputMode.JapaneseHandwriting Écriture japonaise.
• InputEngine.InputMode.KoreanHandwriting Écriture coréenne.
• InputEngine.InputMode.Thai Mode de saisie pour le thaïlandais.
• InputEngine.InputMode.Stroke Mode de saisie des traits pour le chinois.
• InputEngine.InputMode.Romaji Mode de saisie Romaji pour le japonais.
• InputEngine.InputMode.HiraganaFlick Mode de saisie en pichenette pour le japonais.

inputModes : list<int> [read-only]

La liste des modes de saisie disponibles dépend de la méthode de saisie et de la locale. Cette propriété est mise à jour lorsque l'une ou l'autre de ces dépendances change.

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

Liste des modes de reconnaissance des formes disponibles.

Valeurs possibles :

Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.0.

previousKey : int [read-only]

Touche précédemment pressée.

wordCandidateListModel : SelectionListModel [read-only]

Cette propriété permet d'accéder au modèle de liste pour la liste des mots candidats.

wordCandidateListVisibleHint : bool [read-only]

Utilisez cette propriété pour vérifier si la liste des mots candidats doit être visible dans l'interface utilisateur.

Documentation sur le signal

void activeKeyChanged(int key)

Indique que le site actif key a changé.

void inputMethodChanged()

Indique que la méthode d'entrée a changé.

void inputMethodReset()

Emis lorsque la méthode d'entrée doit être réinitialisée.

void inputMethodUpdate()

void inputModeChanged()

Indique que le mode d'entrée a changé.

void inputModesChanged()

Indique que les modes d'entrée disponibles ont changé.

[since QtQuick.VirtualKeyboard 2.0] void patternRecognitionModesChanged()

Indique que les modes de reconnaissance des formes disponibles ont changé.

Les modes de reconnaissance des formes prédéfinis sont les suivants :

• InputEngine.PatternRecognitionMode.None La reconnaissance des formes n'est pas disponible.
• InputEngine.PatternRecognitionMode.PatternRecognitionDisabled obsolete Utilisez InputEngine.PatternRecognitionMode.None
• InputEngine.PatternRecognitionMode.Handwriting Mode de reconnaissance des formes pour la reconnaissance de l'écriture manuscrite.
• InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete Utilisez InputEngine.PatternRecognitionMode.Handwriting

Ce signal a été introduit dans QtQuick.VirtualKeyboard 2.0.

void previousKeyChanged(int key)

Indique que l'adresse key a été modifiée.

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

Indique que le site virtuel key a été cliqué avec les adresses text et modifiers. Ce signal est émis après que la méthode d'entrée a traité l'événement clé.

Documentation de la méthode

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

Démarre une interaction de trace avec le moteur d'entrée.

La trace est identifiée de manière unique par l'adresse traceId. Le moteur d'entrée attribue l'identifiant à l'objet Trace si la méthode d'entrée accepte l'événement.

L'adresse patternRecognitionMode indique le mode de reconnaissance utilisé pour le motif.

Si la méthode d'entrée actuelle accepte l'événement, elle renvoie un objet Trace associé à cette interaction. Si la méthode d'entrée rejette l'événement, elle renvoie une valeur nulle.

Le site traceCaptureDeviceInfo fournit des informations sur le dispositif source et le site traceScreenInfo sur le contexte de l'écran.

Par définition, l'objet Trace reste valide jusqu'à l'appel de la méthode traceEnd().

L'interaction de la trace est terminée par l'appel de la méthode InputEngine.traceEnd().

Cette méthode a été introduite dans QtQuick.VirtualKeyboard 2.0.

bool traceEnd(Trace trace)

Met fin à l'interaction de la trace avec le moteur d'entrée.

L'objet trace peut être supprimé à tout moment après l'appel de cette fonction.

La fonction renvoie true si l'interaction de trace a été acceptée (c'est-à-dire que les événements tactiles ne doivent pas être utilisés à d'autres fins).

void virtualKeyCancel()

Rétablit l'état de la touche active sans émettre d'événement de touche. Cette méthode est utile lorsque l'utilisateur abandonne la touche en cours et que l'état de la touche doit être rétabli.

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

Emet un événement de clic de touche pour les valeurs données key, text et modifiers. Renvoie true si l'événement a été accepté par le moteur de saisie.

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

Appelé par la couche clavier pour indiquer que key a été pressé, avec les données text et modifiers.

La touche key est définie comme une touche active (touche vers le bas). L'événement touche réel est déclenché lorsque la touche est relâchée par la méthode virtualKeyRelease(). L'événement de pression sur la touche peut être supprimé en appelant virtualKeyCancel().

L'appui sur la touche déclenche également la minuterie de répétition de la touche si repeat est true.

Renvoie true si la touche a été acceptée par ce moteur d'entrée.

Voir également virtualKeyCancel() et virtualKeyRelease().

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

Libère la touche à l'adresse key. La méthode émet un événement clé pour la méthode d'entrée si l'événement n'a pas été généré par un minuteur répétitif. Les adresses text et modifiers sont transmises à la méthode d'entrée.

Retourne true si la clé a été acceptée par le moteur d'entrée.