QInputMethodEvent Class

Description détaillée

Les événements relatifs aux méthodes de saisie sont envoyés aux widgets lorsqu'une méthode de saisie est utilisée pour entrer du texte dans un widget. Les méthodes de saisie sont largement utilisées pour saisir du texte dans les langues dont l'alphabet n'est pas latin.

Lors de la création de widgets d'édition de texte personnalisés, l'attribut de fenêtre Qt::WA_InputMethodEnabled doit être défini explicitement (à l'aide de la fonction QWidget::setAttribute()) afin de recevoir les événements liés aux méthodes de saisie.

Ces événements intéressent les auteurs de gadgets de saisie au clavier qui souhaitent pouvoir gérer correctement les langues dont la saisie de caractères est complexe. La saisie de texte dans ces langues se fait généralement en trois étapes :

1. Commencer à composer

   Lorsque l'utilisateur appuie sur la première touche d'un clavier, un contexte de saisie est créé. Ce contexte de saisie contiendra une chaîne de caractères tapés.

2. Composer

   À chaque fois que l'utilisateur appuie sur une nouvelle touche, la méthode de saisie tente de créer une chaîne de caractères correspondant au texte tapé jusqu'à présent, appelée chaîne de pré-modification. Tant que le contexte de saisie est actif, l'utilisateur ne peut déplacer le curseur qu'à l'intérieur de la chaîne de caractères appartenant à ce contexte de saisie.

3. Terminer

   À un moment donné, l'utilisateur activera un composant de l'interface utilisateur (peut-être en utilisant une touche particulière) où il pourra choisir parmi un certain nombre de chaînes de caractères correspondant au texte qu'il a tapé jusqu'à présent. L'utilisateur peut soit confirmer son choix, soit annuler la saisie ; dans les deux cas, le contexte de saisie est fermé.

QInputMethodEvent modélise ces trois étapes et transfère les informations nécessaires au rendu correct du résultat intermédiaire. Un QInputMethodEvent a deux paramètres principaux : preeditString() et commitString(). Le paramètre preeditString() indique la chaîne de pré-édition actuellement active. Le paramètre commitString() indique un texte qui doit être ajouté au texte du widget de l'éditeur (ou en remplacer des parties). Il s'agit généralement d'un résultat des opérations de saisie et il doit être inséré dans le texte du widget directement avant la chaîne preedit.

Si commitString() doit remplacer des parties du texte de l'éditeur, replacementLength() contiendra le nombre de caractères à remplacer. replacementStart() contient la position à laquelle les caractères doivent être remplacés par rapport au début de la chaîne de prédiction.

Un certain nombre d'attributs contrôlent l'aspect visuel de la chaîne de pré-édition (l'aspect visuel du texte en dehors de la chaîne de pré-édition n'est contrôlé que par le widget). L'énumération AttributeType décrit les différents attributs qui peuvent être définis.

Une classe implémentant QWidget::inputMethodEvent() ou QGraphicsItem::inputMethodEvent() doit au moins comprendre et respecter les attributs TextFormat et Cursor.

Étant donné que les méthodes de saisie doivent pouvoir interroger certaines propriétés du widget ou de l'élément graphique, les sous-classes doivent également implémenter QWidget::inputMethodQuery() et QGraphicsItem::inputMethodQuery(), respectivement.

Lorsqu'il reçoit un événement de méthode d'entrée, le widget de texte doit effectuer les étapes suivantes :

1. Si le widget a sélectionné du texte, le texte sélectionné doit être supprimé.
2. Supprimer le texte commençant à replacementStart() avec la longueur replacementLength() et le remplacer par commitString(). Si replacementLength() est égal à 0, replacementStart() donne la position d'insertion de commitString().

   Lors du remplacement, la zone de la chaîne preedit est ignorée, ainsi un remplacement commençant à -1 avec une longueur de 2 enlèvera le dernier caractère avant la chaîne preedit et le premier caractère après, et insérera la chaîne commit directement avant la chaîne preedit.

   Si le widget implémente undo/redo, cette opération est ajoutée à la pile undo.

3. S'il n'y a pas de chaîne preedit actuelle, insérer le preeditString() à la position actuelle du curseur ; sinon, remplacer le preeditString précédent par celui reçu de cet événement.

   Si le widget implémente undo/redo, le preeditString() ne devrait pas influencer la pile undo/redo de quelque manière que ce soit.

   Le widget doit examiner la liste des attributs à appliquer à la chaîne de pré-édition. Il doit comprendre au moins les attributs TextFormat et Cursor et les rendre comme spécifié.