Share via

Éditeur d’accélérateur (C++)

  • Article

Une table d’accélérateurs est une ressource Windows C++ qui contient une liste de touches d’accélérateur, appelées touches de raccourci, et les identificateurs de commande qui sont associés à ces touches. Un programme peut avoir plusieurs tables d’accélérateurs.

Normalement, les accélérateurs sont utilisés comme raccourcis clavier pour des commandes de programme qui sont également disponibles dans un menu ou une barre d’outils. Toutefois, vous pouvez utiliser la table d’accélérateurs pour définir des combinaisons de touches pour des commandes qui ne sont associées à aucun objet d’interface utilisateur.

Conseil

Lorsque vous utilisez l’éditeur d’accélérateur, cliquez avec le bouton droit pour afficher un menu contextuel de commandes fréquentes. Les commandes disponibles varient selon la cible du pointeur.

Vous pouvez utiliser Affichage de classes pour raccorder des commandes de touches accélérateur à du code. Pour obtenir la liste des touches d’accélérateur prédéfinies, consultez Touches d’accélérateur.

Remarque

Windows ne vous permet pas de créer des tables accélérateurs vides. Si vous créez une table d’accélérateurs sans entrée, elle est supprimée automatiquement lorsque vous l’enregistrez.

Propriétés de l’accélérateur

Vous pouvez définir les propriétés de l’accélérateur dans le Fenêtre Propriétés à tout moment. Vous pouvez également utiliser l’Éditeur d’accélérateur pour modifier les propriétés de l’accélérateur dans la table accélérateur. Les modifications apportées à l’aide de la fenêtre Propriétés ou de l’Éditeur d’accélérateur ont le même résultat, les modifications sont immédiatement reflétées dans la table accélérateur.

La propriété ID fait référence à chaque entrée de table accélérateur dans le code du programme. Cette entrée est la valeur de commande que le programme reçoit lorsqu’un utilisateur appuie sur la touche accélérateur ou une combinaison de touches. Pour faire d’un accélérateur le même qu’un élément de menu, rendez l’ID identique, tant que l’ID de la table accélérateur est identique à l’ID de la ressource de menu.

Chaque ID d’accélérateur a trois propriétés : Modificateur, Clé et Type

La propriété Modificateur définit les combinaisons de touches de contrôle pour l’accélérateur.

Remarque

Dans la fenêtre Propriétés, la propriété Modificateur apparaît sous la forme de trois propriétés booléennes distinctes, qui peuvent toutes être contrôlées indépendamment : Alt, Ctrl et Maj.

Voici les entrées légales pour la propriété Modificateur dans la table accélérateur :

Value Description
Aucun L’utilisateur appuie uniquement sur la valeur clé .

Cette valeur est utilisée plus efficacement avec les valeurs ASCII/ANSI 001 à 026, qui est interprétée comme ^A à ^Z (Ctrl+A à Ctrl+Z+ Z).
Alt L’utilisateur doit appuyer sur Alt avant la valeur de la touche .
Ctrl L’utilisateur doit appuyer sur Ctrl avant la valeur de la touche , non valide avec le type ASCII.
Maj L’utilisateur doit appuyer sur Maj avant la valeur clé.
Ctrl+Alt L’utilisateur doit appuyer sur Ctrl et Alt avant la valeur de la touche , non valide avec le type ASCII.
Ctrl+Maj L’utilisateur doit appuyer sur Ctrl et Maj avant la valeur de la touche , non valide avec le type ASCII.
Alt+Maj L’utilisateur doit appuyer sur Alt et Maj avant la valeur de la clé , non valide avec le type ASCII.
Ctrl+Alt+Maj L’utilisateur doit appuyer sur Ctrl, Alt et Maj avant la valeur de la touche, non valide avec le type ASCII.

La propriété Key définit la clé réelle à utiliser comme accélérateur.

Voici les entrées légales pour la propriété Clé dans la table accélérateur :

Value Description
Entier compris entre 0 et 255 au format décimal. La valeur détermine si la valeur est traitée comme ASCII ou ANSI comme suit :

- Les nombres à un chiffre sont toujours interprétés comme la clé correspondante, plutôt que comme des valeurs ASCII ou ANSI.
- Les valeurs comprises entre 1 et 26, précédées de zéros, sont interprétées comme ^A à ^Z, qui représente la valeur ASCII des lettres de l’alphabet lorsqu’elles sont enfoncées avec la touche Ctrl enfoncée.
- Les valeurs comprises entre 27 et 32 sont toujours interprétées comme des valeurs décimales à trois chiffres 027 à 032.
- Les valeurs comprises entre 033 et 255, précédées ou non de 0 sont interprétées comme des valeurs ANSI.
Un seul caractère de clavier. Les majuscules A - Z ou les nombres 0 - 9 peuvent être des valeurs ascii ou de clé virtuelle. Tout autre caractère est ASCII uniquement.
Caractère de clavier unique dans la plage A - Z (majuscule uniquement), précédé d’un trait (^), par exemple ^ C. Cette option entre la valeur ASCII de la touche lorsqu’elle est enfoncée avec la touche Ctrl enfoncée.
Tout identificateur de clé virtuelle valide. La zone clé déroulante de la table accélérateur contient une liste d’identificateurs de clé virtuelle standard.

Remarque

Lorsque vous entrez une valeur ASCII, les options de propriété modificateur sont limitées. La seule touche de contrôle disponible pour l’utilisation est la touche Alt .

Conseil

Un raccourci pour définir une touche d’accélérateur consiste à cliquer avec le bouton droit sur une entrée ou plusieurs entrées dans la table de l’accélérateur, puis à choisir Touche suivante typée et appuyer sur l’une des touches ou combinaisons de touches sur le clavier.

Cette commande de touche suivante typée est également disponible dans le menu Modifier .

La propriété Type détermine si la combinaison de touches de raccourci associée à l’ID d’accélérateur est interprétée comme une valeur de clé ASCII/ANSI ou une combinaison de touches virtuelles (VIRTKEY).

  • Si la propriété Type est ASCII, la propriété Modificateur peut uniquement être None ou Alt, ou elle peut avoir un accélérateur qui utilise la touche Ctrl, comme spécifié en précédant la touche avec un ^.

  • Si la propriété Type est VIRTKEY, toute combinaison de valeurs modificateur et clé est valide.

Remarque

Si vous souhaitez entrer une valeur dans la table accélérateur et que la valeur est traitée comme ASCII/ANSI, sélectionnez le type de l’entrée dans la table et sélectionnez ASCII dans la liste déroulante. Toutefois, si vous utilisez la commande Next Key Typd dans le menu Modifier pour spécifier la clé, vous devez modifier la propriété Type de VIRTKEY en ASCIIavant d’entrer le code clé .

Tables accélérateurs

Dans un projet C++, vous pouvez modifier une table d’accélérateur directement avec une modification sur place dans l’éditeur d’accélérateur.

Les procédures ci-dessous font référence à l’utilisation de pages de propriétés standard. Toutefois, la modification sur place et la méthode de page de propriétés ont le même résultat. Les modifications apportées à l’aide de pages de propriétés ou d’une modification sur place sont immédiatement reflétées dans la table accélérateur.

Pour modifier une table d'accélérateurs

  1. Ouvrez la table de l’accélérateur en double-cliquant sur son icône dans l’affichage des ressources.

  2. Sélectionnez une entrée dans le tableau et sélectionnez cette option pour activer la modification sur place.

  3. Sélectionnez la zone de liste déroulante ou tapez en place pour apporter des modifications :

    • Pour l’ID, sélectionnez-le dans la liste ou tapez à modifier.

    • Pour modifier, sélectionnez-le dans la liste.

    • Pour Clé, sélectionnez dans la liste ou tapez pour modifier.

    • Pour Type, sélectionnez ASCII ou VIRTKEY dans la liste.

Pour rechercher une entrée dans une table d'accélérateurs ouverte

  1. Ouvrez la table de l’accélérateur en double-cliquant sur son icône dans l’affichage des ressources.

  2. Sélectionnez une tête de colonne pour trier le contenu de la colonne par ordre alphabétique. Par exemple, sélectionnez l’ID pour afficher tous les ID de votre table d’accélérateurs par ordre alphabétique.

    Vous pouvez ensuite examiner la liste et rechercher l'entrée.

Pour ajouter une entrée à une table d'accélérateurs

  1. Ouvrez la table de l’accélérateur en double-cliquant sur son icône dans l’affichage des ressources.

  2. Cliquez avec le bouton droit dans la table de l’accélérateur et choisissez Nouvel accélérateur, ou sélectionnez l’entrée de ligne vide en bas de la table.

  3. Sélectionnez un ID dans la liste déroulante dans la zone ID ou tapez un nouvel ID dans la zone ID .

  4. Tapez la clé que vous souhaitez utiliser en tant qu’accélérateur, ou cliquez avec le bouton droit et choisissez Touche suivante typée pour définir une combinaison de touches, ou accédez au menu Modifier>la touche suivante typée.

  5. Modifiez le modificateur et le type, si nécessaire, puis appuyez sur Entrée.

Remarque

Assurez-vous que tous les accélérateurs définis sont uniques. Vous pouvez avoir plusieurs combinaisons de touches affectées au même ID sans effet incorrect, par exemple, Ctrl+P et F8 peuvent tous les deux être affectés à ID_PRINT. Toutefois, la combinaison de touches attribuée à plusieurs ID ne fonctionne pas correctement, par exemple, Ctrl+Z affectée à la fois ID_SPELL_CHECK et ID_THESAURUS.

Pour supprimer une entrée dans une table d'accélérateurs

  1. Ouvrez la table de l’accélérateur en double-cliquant sur son icône dans l’affichage des ressources.

  2. Sélectionnez l’entrée à supprimer, ou maintenez la touche Ctrl ou Maj enfoncée tout en sélectionnant pour choisir plusieurs entrées.

  3. Cliquez avec le bouton droit et choisissez Supprimer, ou accédez au menu Modifier>la suppression.

Conseil

Vous pouvez également appuyer sur la touche Supprimer pour supprimer.

Pour déplacer ou copier une entrée de table d'accélérateurs vers un autre fichier de script de ressources

  1. Ouvrez les tables accélérateurs dans les deux fichiers de script de ressources et sélectionnez l’entrée que vous souhaitez déplacer.

  2. Dans le menu Modifier , choisissez Copier ou Couper.

  3. Sélectionnez une entrée dans le fichier de script de ressource cible et, dans le menu Modifier , choisissez Coller.

Remarque

Vous pouvez également utiliser les touches de raccourci pour les opérations de copie et de collage.

Pour modifier les propriétés de plusieurs touches d’accélérateur

  1. Ouvrez la table de l’accélérateur en double-cliquant sur son icône dans l’affichage des ressources.

  2. Sélectionnez les touches d’accélérateur que vous souhaitez modifier en maintenant la touche Ctrl enfoncée lorsque vous sélectionnez chacune d’elles.

  3. Accédez au Fenêtre Propriétés et tapez les valeurs que vous souhaitez partager tous les accélérateurs sélectionnés.

Remarque

Chaque valeur de modificateur apparaît sous la forme d’une propriété booléenne dans la fenêtre Propriétés . Si vous modifiez une valeur de modificateur dans la fenêtre Propriétés , la table accélérateur traite le nouveau modificateur comme un ajout à tous les modificateurs qui y étaient précédemment présents. En raison de cela, si vous définissez des valeurs de modificateur, vous devez tous les définir pour vous assurer que chaque accélérateur partage les mêmes paramètres de modificateur .

Spécifications

Win32

Voir aussi

Resource Editors
Touches accélérateur