InputEngine QML Type (Uncreatable)

Associe les saisies de l'utilisateur aux méthodes de saisie. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié dans QML.

• 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 chargé d'acheminer les événements de saisie vers les méthodes de saisie. La logique de saisie proprement dite est mise en œuvre par les méthodes de saisie.

Le moteur de saisie inclut é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 prend pas en charge l'événement.

Documentation des propriétés

activeKey : int [read-only]

Touche actuellement enfoncée.

inputMethod : InputMethod

Utilisez cette propriété pour définir la méthode de saisie active ou pour détecter les changements de méthode de saisie 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 les paramètres régionaux actuels.

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

• InputEngine.InputMode.Latin Mode de saisie par défaut pour le texte en caractères latins.
• InputEngine.InputMode.Numeric Seule la saisie numérique est autorisée.
• InputEngine.InputMode.Dialable Seule la saisie par numérotation 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 de saisie en caractères latins pleine largeur pour les langues d'Asie de l'Est.
• InputEngine.InputMode.Greek Mode de saisie grec.
• InputEngine.InputMode.Cyrillic Mode de saisie cyrillique.
• InputEngine.InputMode.Arabic Mode de saisie en arabe.
• InputEngine.InputMode.Hebrew Mode de saisie en hébreu.
• InputEngine.InputMode.ChineseHandwriting Écriture manuscrite chinoise.
• InputEngine.InputMode.JapaneseHandwriting Écriture manuscrite japonaise.
• InputEngine.InputMode.KoreanHandwriting Écriture manuscrite coréenne.
• InputEngine.InputMode.Thai Mode de saisie thaï.
• InputEngine.InputMode.Stroke Mode de saisie par traits pour le chinois.
• InputEngine.InputMode.Romaji Mode de saisie en romaji pour le japonais.
• InputEngine.InputMode.HiraganaFlick Mode de saisie par glissement pour le japonais.

inputModes : list<int> [read-only]

La liste des modes de saisie disponibles dépend de la méthode de saisie et des paramètres régionaux. Cette propriété est mise à jour dès que l'une de ces dépendances change.

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

Liste des modes de reconnaissance de formes disponibles.

Valeurs possibles :

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

previousKey : int [read-only]

Touche précédemment enfoncée.

wordCandidateListModel : SelectionListModel [read-only]

Utilisez cette propriété pour accéder au modèle de liste correspondant à la liste des suggestions de mots.

wordCandidateListVisibleHint : bool [read-only]

Utilisez cette propriété pour déterminer si la liste des suggestions de mots doit être affichée dans l'interface utilisateur.

Documentation Signal

void activeKeyChanged(int key)

Indique que l'key e active a changé.

void inputMethodChanged()

Indique que la méthode de saisie a changé.

void inputMethodReset()

Émis lorsque la méthode de saisie doit être réinitialisée.

void inputMethodUpdate()

void inputModeChanged()

Indique que le mode de saisie a changé.

void inputModesChanged()

Indique que les modes de saisie disponibles ont changé.

[since QtQuick.VirtualKeyboard 2.0] void patternRecognitionModesChanged()

Indique que les modes de reconnaissance de motifs disponibles ont changé.

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

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

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

void previousKeyChanged(int key)

Indique que l'key e précédente a été modifiée.

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

Indique que l'on a cliqué sur l'key virtuelle avec les paramètres text et modifiers fournis. Ce signal est émis une fois que la méthode de saisie a traité l'événement de touche.

Documentation de la méthode

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

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

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

L'patternRecognitionMode spécifie le mode de reconnaissance utilisé pour le motif.

Si la méthode de saisie actuelle accepte l’événement, elle renvoie un objet Trace associé à cette interaction. Si la méthode de saisie rejette l’événement, elle renvoie une valeur nulle.

La méthode ` traceCaptureDeviceInfo ` fournit des informations sur le périphérique source et la méthode ` traceScreenInfo ` fournit des informations sur le contexte d’écran.

Par définition, l’objet Trace reste valide jusqu’à ce que la méthode traceEnd() soit appelée.

L'interaction de 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 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 déclencher d'événement de touche. Cette méthode est utile lorsque l'utilisateur annule la touche actuelle et qu'il faut rétablir l'état de la touche.

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

Déclenche un événement de frappe pour les éléments key, text et modifiers. Renvoie true si l'événement de frappe a été accepté par le moteur de saisie.

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

Appelée par la couche clavier pour indiquer qu'une touche ( key ) a été enfoncée, avec les paramètres text et modifiers fournis.

L'key est définie comme touche active (touche enfoncée). L'événement de touche proprement dit est déclenché lorsque la touche est relâchée par la méthode virtualKeyRelease(). L'événement de pression de touche peut être ignoré en appelant virtualKeyCancel().

La pression sur la touche déclenche également le minuteur de répétition si repeat est défini sur 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 déclenche un événement de touche pour la méthode de saisie si cet événement n'a pas été généré par une minuterie récurrente. Les paramètres text et modifiers sont transmis à la méthode de saisie.

Renvoie ` true ` si la touche a été acceptée par le moteur de saisie.