Comment inscrire et implémenter un gestionnaire de feuille de propriétés pour une application Panneau de configuration

De nombreuses applications Panneau de configuration affichent une feuille de propriétés pour permettre aux utilisateurs d’afficher et de modifier différents paramètres système et d’appareil. Deux de ces applications, souris et affichage, permettent aux gestionnaires de feuilles de propriétés de remplacer une ou plusieurs de leurs pages par une page personnalisée. La capture d’écran suivante montre la feuille de propriétés Propriétés de la souris .

Les gestionnaires de feuilles de propriétés pour les applications Panneau de configuration sont similaires à ceux des types de fichiers, à deux principales exceptions près :

• Ils sont appelés par une application Panneau de configuration, et non par l’interpréteur de commandes.
• Ils sont enregistrés différemment.

Bon à savoir

Technologies

• Shell

Prérequis

• Compréhension des Panneau de configuration
• Compréhension des menus contextuels

Instructions

Étape 1 : Inscription d’un gestionnaire de feuilles de propriétés pour une application Panneau de configuration

Un gestionnaire de feuilles de propriétés d’application Panneau de configuration doit être inscrit sous la sous-clé Panneau de configuration. Cette clé peut se trouver dans l’un des deux emplacements, selon que le gestionnaire doit être par utilisateur ou par ordinateur. Pour l’inscription par utilisateur, la sous-clé Panneau de configuration est HKEY_CURRENT_USER\Panneau de configuration. La macro REGSTR_PATH_CONTROLPANEL telle que définie dans Regstr.h peut être utilisée dans le code à la place de « Panneau de configuration ». Pour l’inscription par ordinateur, l’emplacement est :

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            Current Version
               Controls Folder

Ce chemin d’accès peut être appelé HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER dans le code, à l’aide de la macro REGSTR_PATH_CONTROLSFOLDER définie dans Regstr.h.

Le Panneau de configuration les applications qui autorisent les gestionnaires de feuilles de propriétés à remplacer des pages ont une sous-clé sous la sous-clé du Panneau de configuration, nommée pour l’application, telle que Souris et Affichage. La sous-clé de l’application doit avoir une sous-clé shellex avec une sous-clé PropertySheetHandlers . Pour inscrire un gestionnaire de feuilles de propriétés, ajoutez son GUID à la sous-clé PropertySheetHandlers associée à l’application Panneau de configuration. Pour ce faire, créez une sous-clé de la sous-clé PropertySheetHandlers , nommée pour le gestionnaire de feuille de propriétés, et définissez sa valeur par défaut sur la forme de chaîne du GUID du gestionnaire.

L’exemple suivant inscrit un gestionnaire de feuilles de propriétés pour l’application Mouse Panneau de configuration par ordinateur. Pour l’inscrire par utilisateur, remplacez HKEY_LOCAL_MACHINE REGSTR_PATH_CONTROLSFOLDER\ par HKEY_CURRENT_USER\REGSTR_PATH_CONTROLPANEL.

HKEY_LOCAL_MACHINE
   REGSTR_PATH_CONTROLSFOLDER
      Mouse
         shellex
            PropertySheetHandlers
               MyPropHandler
                  (Default) = {MyPropHandler CLSID GUID}

Étape 2 : Implémentation d’un gestionnaire de feuilles de propriétés pour une application Panneau de configuration

La procédure d’implémentation d’un gestionnaire de feuilles de propriétés Panneau de configuration est très similaire à celle décrite dans Comment inscrire et implémenter un gestionnaire de feuilles de propriétés pour un type de fichier. La principale différence est que maintenant IShellPropSheetExt::ReplacePage a besoin d’une implémentation non actuelle au lieu de IShellPropSheetExt::AddPages.

Lorsqu’une application Panneau de configuration est sur le point d’afficher sa feuille de propriétés, elle appelle une fois la méthode IShellPropSheetExt::ReplacePage du gestionnaire de feuilles de propriétés pour chaque page qui peut être remplacée. Le paramètre uPageID est défini sur l’ID de la page. Les ID des pages disponibles sont définis dans Cplext.h. Les ID actuellement disponibles sont répertoriés dans le tableau suivant.

ID de page	Description	application Panneau de configuration
CPLPAGE_MOUSE_BUTTONS	Page Boutons	Souris
CPLPAGE_MOUSE_PTRMOTION	Page Mouvement	Souris
CPLPAGE_MOUSE_WHEEL	Page Wheel	Souris
CPLPAGE_KEYBOARD_SPEED	Page Vitesse	Clavier
CPLPAGE_DISPLAY_BACKGROUND	Page Arrière-plan	Affichage

 

Notes

La procédure de création et de remplacement d’une page est identique à celle de l’ajout d’une page. Pour plus d’informations, consultez Inscription et implémentation d’un gestionnaire de feuilles de propriétés pour un type de fichier.