QKeySequence Class

Description détaillée

Dans sa forme la plus courante, une séquence de touches décrit une combinaison de touches qui doivent être utilisées ensemble pour effectuer une action. Les séquences de touches sont utilisées avec les objets ` QAction ` pour spécifier quels raccourcis clavier peuvent être utilisés pour déclencher des actions.

Les séquences de touches peuvent être créées de trois manières différentes pour être utilisées comme raccourcis clavier :

• Pour les raccourcis standard, un objet ` standard key ` peut être utilisé pour récupérer la séquence de touches spécifique à la plateforme associée à chaque raccourci.
• Pour les raccourcis personnalisés, des chaînes lisibles par l’utilisateur, telles que « Ctrl+X », peuvent être utilisées ; celles-ci peuvent ensuite être traduites en raccourcis appropriés pour les utilisateurs de différentes langues. Les traductions sont effectuées dans le contexte «QShortcut ».
• Pour les raccourcis codés en dur, des codes de touche entiers peuvent être spécifiés à l’aide d’une combinaison de valeurs définies par les valeurs d’énumération « Qt::Key » et « Qt::KeyboardModifier ». Chaque code de touche se compose d’une seule valeur d’ Qt::Key et de zéro ou plusieurs modificateurs, tels que « Qt::ShiftModifier », « Qt::ControlModifier », « Qt::AltModifier » et « Qt::MetaModifier ».

Par exemple, « Ctrl P » peut être une séquence utilisée comme raccourci pour imprimer un document, et peut être spécifiée de l’une des manières suivantes :

QKeySequence(QKeySequence::Print);
QKeySequence(tr("Ctrl+P"));
QKeySequence(tr("Ctrl+p"));
QKeySequence(Qt::CTRL | Qt::Key_P);
QKeySequence(Qt::CTRL + Qt::Key_P); // deprecated

Notez que, pour les lettres, la casse utilisée dans la chaîne de spécification n’a pas d’importance. Dans les exemples ci-dessus, l’utilisateur n’a pas besoin de maintenir la touche Shift enfoncée pour activer un raccourci spécifié par « Ctrl+P ». Cependant, pour d’autres touches, l’utilisation de Shift comme touche de modification supplémentaire non spécifiée peut prêter à confusion pour les utilisateurs d’une application dont les claviers ont des dispositions différentes de celles utilisées par les développeurs. Reportez-vous à la section « Keyboard Layout Issues » ci-dessous pour plus de détails.

Il est préférable d’utiliser des raccourcis standard dans la mesure du possible. Lors de la création de séquences de touches pour des raccourcis non standard, vous devez privilégier l’utilisation de chaînes de caractères lisibles par l’utilisateur plutôt que de valeurs entières codées en dur.

L'objet `QKeySequence` peut être sérialisé en chaînes lisibles par l'utilisateur à l'aide de la fonction ` toString()`.

Une autre façon de spécifier des codes de touches codés en dur consiste à utiliser le point de code Unicode du caractère ; par exemple, « A » donne la même séquence de touches que Qt::Key_A.

Raccourcis standard

QKeySequence définit de nombreuses séquences de touches ( standard keyboard shortcuts ) afin de réduire l’effort nécessaire à la configuration des actions dans une application type. Le tableau ci-dessous présente certaines séquences de touches courantes souvent utilisées pour ces raccourcis standard par les applications sur quatre plateformes largement répandues. Notez que sur les plateformes Apple, la valeur « Ctrl » correspond aux touches « Command » du clavier Macintosh, et la valeur « Meta » correspond aux touches « Control ».

Notez que, comme les combinaisons de touches utilisées pour les raccourcis standard varient d'une plateforme à l'autre, vous devez tout de même tester vos raccourcis sur chaque plateforme pour vous assurer de ne pas attribuer involontairement la même combinaison de touches à plusieurs actions.

Problèmes liés à la disposition du clavier

De nombreuses spécifications de combinaisons de touches sont choisies par les développeurs en fonction de la disposition de certains types de claviers, plutôt que de choisir des touches correspondant à la première lettre du nom d’une action, comme « Ctrl S » (« Ctrl+S ») ou « Ctrl C » (« Ctrl+C »). De plus, comme certains symboles ne peuvent être saisis qu’à l’aide de touches de modification sur certaines dispositions de clavier, les combinaisons de touches destinées à une disposition particulière peuvent correspondre à une touche différente, ne correspondre à aucune touche, ou nécessiter l’utilisation d’une touche de modification supplémentaire sur d’autres dispositions.

Par exemple, les raccourcis « Ctrl plus » et « Ctrl minus » sont souvent utilisés pour les opérations de zoom dans les applications graphiques, et peuvent être spécifiés respectivement comme « Ctrl++ » et « Ctrl+- ». Cependant, la manière dont ces raccourcis sont spécifiés et interprétés dépend de la disposition du clavier. Les utilisateurs de claviers norvégiens remarqueront que les touches « + » et « - » ne sont pas adjacentes sur le clavier, mais pourront tout de même activer ces deux raccourcis sans avoir à appuyer sur la touche « Shift ». En revanche, les utilisateurs de claviers britanniques devront maintenir enfoncée la touche « Shift » pour saisir le symbole « + », ce qui rendra le raccourci équivalent à « Ctrl+Shift+= ».

Bien que certains développeurs puissent être tentés de spécifier en détail tous les modificateurs qu’ils utilisent sur leur clavier pour activer un raccourci, cela entraînera également un comportement inattendu pour les utilisateurs disposant de dispositions de clavier différentes.

Par exemple, un développeur utilisant un clavier britannique pourrait décider de spécifier « Ctrl+Maj+= » comme séquence de touches afin de créer un raccourci qui, par coïncidence, se comporte de la même manière que Ctrl plus. Cependant, la touche « = » doit être accessible via la touche « Shift » sur un clavier norvégien, ce qui rend le raccourci requis équivalent à « Ctrl Shift Shift = » (une combinaison de touches impossible).

Par conséquent, tant les chaînes lisibles par l’utilisateur que les codes de touches codés en dur peuvent poser problème lors de la définition d’une séquence de touches destinée à être utilisée sur diverses dispositions de clavier. Seule l’utilisation de standard shortcuts garantit que l’utilisateur pourra utiliser les raccourcis prévus par le développeur.

Malgré cela, nous pouvons résoudre ce problème en veillant à utiliser des chaînes lisibles par l’utilisateur, ce qui permet de traduire les séquences de touches pour les utilisateurs de différentes langues. Cette approche fonctionnera pour les utilisateurs dont les claviers présentent la disposition la plus courante pour la langue qu’ils utilisent.

Séquences de touches de type GNU Emacs

Des séquences de touches similaires à celles utilisées dans GNU Emacs, autorisant jusqu’à quatre codes de touche, peuvent être créées à l’aide du constructeur à arguments multiples, ou en transmettant une chaîne lisible par l’utilisateur contenant des séquences de touches séparées par des virgules.

Par exemple, la séquence de touches « Ctrl X » suivie de « Ctrl C » peut être spécifiée de l’une des deux manières suivantes :

QKeySequence(tr("Ctrl+X, Ctrl+C"));
QKeySequence(Qt::CTRL | Qt::Key_X, Qt::CTRL | Qt::Key_C);
QKeySequence(Qt::CTRL + Qt::Key_X, Qt::CTRL + Qt::Key_C); // deprecated