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 les raccourcis clavier à utiliser pour déclencher des actions.

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

• Pour les raccourcis standard, une adresse standard key peut être utilisée pour demander la séquence de touches spécifique à la plate-forme associée à chaque raccourci.
• Pour les raccourcis personnalisés, il est possible d'utiliser des chaînes lisibles par l'homme, telles que "Ctrl+X", qui peuvent ê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 touches entières peuvent être spécifiés avec une combinaison de valeurs définies par les valeurs de l'énumération Qt::Key et Qt::KeyboardModifier. Chaque code clé se compose d'une seule valeur 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 l'impression d'un document et peut être spécifié 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". Toutefois, pour d'autres touches, l'utilisation de Shift en tant que touche modificatrice 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. Voir 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. Lorsque vous créez des séquences de touches pour des raccourcis non standard, vous devez utiliser des chaînes lisibles par l'homme plutôt que des valeurs entières codées en dur.

Les objets QKeySequence peuvent être sérialisés en chaînes lisibles par l'homme à l'aide de la fonction toString().

Une autre façon de spécifier des codes de touches codés en dur est d'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 nombreux standard keyboard shortcuts pour réduire l'effort nécessaire à la mise en place d'actions dans une application type. Le tableau ci-dessous présente quelques séquences de touches courantes qui sont souvent utilisées pour ces raccourcis standard par des applications sur quatre plates-formes 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.

Étant donné que les séquences de touches utilisées pour les raccourcis standard diffèrent d'une plate-forme à l'autre, vous devez tester vos raccourcis sur chaque plate-forme afin de vous assurer que vous n'attribuez pas involontairement la même séquence de touches à plusieurs actions.

Questions relatives à la disposition du clavier

De nombreuses spécifications de séquences de touches sont choisies par les développeurs en fonction de la disposition de certains types de clavier, plutôt que de choisir des touches qui représentent la première lettre du nom d'une action, comme Ctrl S ("Ctrl+S") ou Ctrl C ("Ctrl+C"). En outre, comme certains symboles ne peuvent être saisis qu'à l'aide de touches de modification sur certaines configurations de clavier, les séquences de touches destinées à être utilisées sur une configuration de clavier peuvent correspondre à une touche différente, ne correspondre à aucune touche ou nécessiter une touche de modification supplémentaire pour être utilisées sur des configurations de clavier différentes.

Par exemple, les raccourcis Ctrl plus et Ctrl minus sont souvent utilisés comme raccourcis pour les opérations de zoom dans les applications graphiques et peuvent être spécifiés comme "Ctrl++" et "Ctrl+-" respectivement. 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 ils pourront quand même activer les deux raccourcis sans avoir à appuyer sur la touche Shift. En revanche, les utilisateurs de claviers britanniques devront maintenir la touche Shift enfoncée pour saisir le symbole +, ce qui revient à dire que le raccourci est identique à "Ctrl+Shift+=".

Bien que certains développeurs aient recours à la spécification complète de tous les modificateurs qu'ils utilisent sur leurs claviers pour activer un raccourci, cela entraînera également un comportement inattendu pour les utilisateurs de différentes dispositions de clavier.

Par exemple, un développeur utilisant un clavier britannique peut décider de spécifier "Ctrl+Shift+=" 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 à l'aide de la touche Shift sur un clavier norvégien, ce qui rend le raccourci requis effectivement Ctrl Shift Shift = (une combinaison de touches impossible).

Par conséquent, les chaînes lisibles par l'homme et les codes de touches codés en dur peuvent tous deux poser des problèmes lorsqu'il s'agit de spécifier une séquence de touches pouvant être utilisée sur une variété de claviers différents. 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 à ce que des chaînes lisibles par l'homme soient utilisées, ce qui permet de traduire les séquences de touches pour les utilisateurs de différentes langues. Cette approche sera efficace pour les utilisateurs dont les claviers ont la disposition la plus typique de la langue qu'ils utilisent.

Séquences de touches de style GNU Emacs

Des séquences de touches similaires à celles utilisées dans GNU Emacs, permettant jusqu'à quatre codes de touches, peuvent être créées en utilisant le constructeur à arguments multiples, ou en passant une chaîne lisible par l'homme de séquences de touches séparées par des virgules.

Par exemple, la séquence de clés Ctrl X suivie de Ctrl C peut être spécifiée de l'une ou l'autre des 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