InputMethod QML Type

Type de base permettant de créer une méthode de saisie en QML. En savoir plus...

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

Propriétés

• inputContext : InputContext
• inputEngine : InputEngine

Signaux

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

Méthodes

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

Description détaillée

Le type InputMethod vous permet de créer une méthode de saisie personnalisée pouvant être attribuée à InputEngine.

Documentation des propriétés

inputContext : InputContext [read-only]

Le contexte de saisie.

inputEngine : InputEngine [read-only]

Le moteur de saisie.

Documentation sur Signal

selectionListActiveItemChanged(int type, int index)

La méthode d'entrée émet ce signal lorsque l'index e actuelle a changé dans la liste de sélection identifiée par type.

selectionListChanged(int type)

La méthode d'entrée émet ce signal lorsque le contenu de la liste de sélection est modifié. Le paramètre type indique quelle liste de sélection a été modifiée.

[since QtQuick.VirtualKeyboard 2.2] selectionListsChanged()

La méthode de saisie émet ce signal lorsque les types de la liste de sélection ont changé. Ce signal déclenche un appel à la méthode ` selectionLists()`, permettant ainsi à la méthode de saisie de mettre à jour les types de la liste de sélection.

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

Documentation de la méthode

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

Appelée lorsque l'utilisateur clique sur du texte pré-édité à l'adresse cursorPosition.

La fonction doit renvoyer true si elle gère l'événement. Sinon, la saisie est redirigée vers reselect() pour un traitement ultérieur.

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

list<int> inputModes(string locale)

Renvoie une liste des modes de saisie pour ` locale`.

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

Cette méthode a pour but de gérer les événements de touche générés par le moteur de saisie.

Le paramètre key spécifie le code de la touche à traiter. Le code de la touche ne fait pas la distinction entre les majuscules et les minuscules. Le paramètre text contient le texte Unicode correspondant à la touche. Le paramètre modifiers contient les modificateurs de touche qui s'appliquent à key.

Cette méthode renvoie « true » si l'événement de touche a été traité avec succès. Si la valeur renvoyée est « false », l'événement de touche est redirigé vers la méthode de saisie par défaut pour un traitement ultérieur.

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

Renvoie la liste des modes de reconnaissance de formes pris en charge.

Cette méthode est appelée par le moteur de saisie pour interroger la liste des modes de reconnaissance de motifs pris en charge.

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

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

Cette méthode tente de resélectionner un mot situé à l'cursorPosition. Les reselectFlags définissent les règles de sélection du mot par rapport à la position du curseur.

• InputEngine.WordBeforeCursor Activer le mot précédant le curseur. Lorsque cet indicateur est utilisé seul, le mot doit se terminer exactement au niveau du curseur.
• InputEngine.WordAfterCursor Activer le mot situé après le curseur. Lorsque cet indicateur est utilisé seul, le mot doit commencer exactement au niveau du curseur.
• InputEngine.WordAtCursor Activer le mot situé au niveau du curseur. Ce drapeau est une combinaison des drapeaux ci-dessus, à l’exception que le mot ne peut ni commencer ni se terminer au niveau du curseur.

La méthode renvoie « true » si le mot a été resélectionné avec succès.

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

void reset()

Cette méthode est appelée par le moteur de saisie lorsque cette méthode de saisie doit être réinitialisée. La méthode de saisie doit uniquement réinitialiser son état interne. La principale différence par rapport à la méthode ` update()` réside dans le fait que `reset()` ne modifie que l’état de la méthode de saisie ; elle ne doit en aucun cas modifier le contexte de saisie.

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

Renvoie les données d'un élément d'une liste de sélection identifiée par type. Le paramètre role spécifie les données demandées. Le paramètre index correspond à un index (à partir de zéro) dans la liste de sélection.

int selectionListItemCount(int type)

Renvoie le nombre d'éléments de la liste de sélection identifiée par type.

void selectionListItemSelected(int type, int index)

Cette méthode est appelée lorsqu'un élément de la liste « index » a été sélectionné par l'utilisateur. La liste de sélection est identifiée par le paramètre « type ».

list<int> selectionLists()

Renvoie la liste des types de sélection utilisés pour cette méthode de saisie.

Cette méthode est appelée par le moteur de saisie lors de l’activation de la méthode de saisie et à chaque mise à jour des suggestions de la méthode de saisie. La méthode de saisie peut réserver des listes de sélection en renvoyant les types de listes de sélection souhaités.

La méthode de saisie peut demander au moteur de saisie de mettre à jour les listes de sélection à tout moment en émettant un signal « selectionListsChanged() ». Ce signal déclenche un appel à cette méthode, permettant ainsi à la méthode de saisie de mettre à jour les types de listes de sélection.

bool setInputMode(string locale, int inputMode)

Modifie les paramètres inputMode et locale pour cette méthode de saisie. La méthode renvoie true en cas de succès.

bool setTextCase(int textCase)

Mise à jour de la méthode « textCase » pour cette méthode de saisie. La méthode renvoie « true » en cas de réussite.

Les valeurs possibles pour la casse du texte sont les suivantes :

• InputEngine.Lower Texte en minuscules.
• InputEngine.Upper Texte en majuscules.

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

Cette méthode est appelée lorsqu'une interaction de trace débute avec l'patternRecognitionMode spécifié. La trace est identifiée de manière unique par l'traceId. L'traceCaptureDeviceInfo fournit des informations sur l'appareil source et l'traceScreenInfo fournit des informations sur le contexte d'écran.

Si la méthode de saisie accepte l’événement et souhaite capturer la saisie de la trace, elle doit renvoyer un nouvel objet Trace. Cet objet doit rester valide jusqu’à ce que la méthode InputMethod.traceEnd() soit appelée. Si la trace est affichée à l’écran, elle y reste jusqu’à ce que l’objet Trace soit détruit.

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

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

Cette méthode est appelée lorsque l'interaction de trace prend fin. La méthode de saisie doit détruire l'objet ` trace ` à un moment donné après l'appel de cette fonction. Renvoie ` true ` en cas de succès.

Consultez l’API de trace pour les méthodes de saisie pour savoir comment accéder aux données collectées.

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

void update()

Cette méthode est appelée par le moteur de saisie lorsque la méthode de saisie doit être mise à jour. La méthode de saisie doit fermer le texte en pré-édition et rétablir l'état interne par défaut.