QInputMethodEvent Class

Description détaillée

Les événements de méthode de saisie sont envoyés aux widgets lorsqu'une méthode de saisie est utilisée pour saisir du texte dans un widget. Les méthodes de saisie sont largement utilisées pour saisir du texte dans les langues utilisant des alphabets non latins.

Notez que 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 développeurs de widgets 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 déroule généralement en trois étapes :

1. Début de la saisie

   Lorsque l’utilisateur appuie sur la première touche du clavier, un contexte de saisie est créé. Ce contexte de saisie contiendra une chaîne de caractères correspondant aux caractères saisis.

2. Composition

   À chaque nouvelle touche enfoncée, la méthode de saisie tente de créer une chaîne correspondant au texte saisi jusqu’à présent, appelée « chaîne de pré-édition ». Tant que le contexte de saisie est actif, l’utilisateur ne peut déplacer le curseur qu’à l’intérieur de la chaîne appartenant à ce contexte de saisie.

3. Finalisation

   À un moment donné, l’utilisateur activera un composant de l’interface utilisateur (éventuellement à l’aide d’une touche spécifique) dans lequel il pourra choisir parmi plusieurs chaînes correspondant au texte saisi jusqu’à présent. L’utilisateur peut soit confirmer son choix, soit annuler la saisie ; dans les deux cas, le contexte de saisie sera fermé.

QInputMethodEvent modélise ces trois étapes et transmet les informations nécessaires pour afficher correctement le résultat intermédiaire. Un objet QInputMethodEvent possède deux paramètres principaux : preeditString() et commitString(). Le paramètre preeditString() fournit la chaîne de pré-édition actuellement active. Le paramètre commitString() fournit un texte qui doit être ajouté au texte du widget d’édition (ou en remplacer certaines parties). Il s’agit généralement du résultat des opérations de saisie et doit être inséré dans le texte du widget immédiatement avant la chaîne de pré-édition.

Si la fonction ` commitString()` doit remplacer des parties du texte dans l'éditeur, la fonction ` replacementLength()` contiendra le nombre de caractères à remplacer. La fonction ` replacementStart()` contient la position à partir du début de la chaîne de pré-édition à laquelle les caractères doivent être remplacés.

Plusieurs attributs contrôlent l’apparence visuelle de la chaîne de pré-édition (l’apparence visuelle du texte en dehors de la chaîne de pré-édition est contrôlée uniquement par le widget). L’énumération ` AttributeType ` décrit les différents attributs pouvant être définis.

Une classe implémentant les méthodes QWidget::inputMethodEvent() ou QGraphicsItem::inputMethodEvent() doit au minimum 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 respectivement les méthodes QWidget::inputMethodQuery() et QGraphicsItem::inputMethodQuery().

Lorsqu’il reçoit un événement de méthode de saisie, le widget de texte doit effectuer les étapes suivantes :

1. Si le widget contient du texte sélectionné, celui-ci doit être supprimé.
2. Supprimer le texte commençant à l’index replacementStart() et ayant une longueur de replacementLength(), puis le remplacer par la chaîne commitString(). Si replacementLength() vaut 0, la fonction replacementStart() renvoie la position d’insertion pour la chaîne commitString().

   Lors du remplacement, la zone de la chaîne de pré-édition est ignorée ; ainsi, un remplacement commençant à -1 et d’une longueur de 2 supprimera le dernier caractère avant la chaîne de pré-édition et le premier caractère après celle-ci, puis insérera la chaîne de validation directement avant la chaîne de pré-édition.

   Si le widget prend en charge les fonctions « annuler » et « refaire », cette opération est ajoutée à la pile d’annulation.

3. S’il n’y a pas de chaîne de pré-édition actuelle, insérez la chaîne « preeditString() » à la position actuelle du curseur ; sinon, remplacez la chaîne « preeditString » précédente par celle reçue via cet événement.

   Si le widget implémente les fonctions d’annulation et de rétablissement, la méthode preeditString() ne doit en aucun cas influencer la pile d’annulation/rétablissement.

   Le widget doit examiner la liste des attributs à appliquer à la chaîne de pré-édition. Il doit au moins prendre en charge les attributs « TextFormat » et « Cursor » et les afficher conformément aux spécifications.