Comment inscrire des éléments exécutables Panneau de configuration

  • Article

Pour Panneau de configuration éléments implémentés en tant que fichiers .exe, aucune exportation spéciale ni gestion des messages n’est requise. N’importe quel fichier .exe peut être inscrit en tant qu’objet de commande pour apparaître avec un point d’entrée dans le dossier Panneau de configuration.

Un exemple est utilisé ici pour illustrer les exigences d’inscription. L’exemple montre comment inscrire un élément Panneau de configuration appelé Mes paramètres en tant qu’objet de commande afin qu’il apparaisse dans la fenêtre Panneau de configuration. La fenêtre Mes paramètres s’affiche également lorsque la commande MyApp.exe /settings est exécutée.

Instructions

Étape 1 :

Générez un GUID pour l’élément Panneau de configuration. Le GUID identifie de manière unique l’élément Panneau de configuration. Dans cet exemple, {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40} est le GUID de l’élément Panneau de configuration.

Étape 2 :

En utilisant le GUID comme nom, ajoutez une sous-clé au Registre comme suit.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  ControlPanel
                     NameSpace
                        {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
                           (Default) = My Settings

Les données de l’entrée Par défaut sont simplement le nom REG_SZ de l’élément Panneau de configuration. L’entrée Par défaut peut être utile pour identifier l’entrée GUID, mais elle est facultative.

Étape 3 :

En utilisant le GUID comme nom, ajoutez une sous-clé et ses entrées au Registre comme suit.

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         (Default) = My Settings
         LocalizedString = @%ProgramFiles%\MyCorp\MyApp.exe,-9
         InfoTip = @%ProgramFiles%\MyCorp\MyApp.exe,-5
         System.ApplicationName = MyCorporation.MySettings
         System.ControlPanel.Category = 1,8
         System.Software.TasksFileUrl = %ProgramFiles%\MyCorp\MyApp\MyTaskLinks.xml

  • Par défaut. REG_SZ. Nom complet de l’élément Panneau de configuration.

  • LocalizedString. Optionnel. REG_SZ ou REG_EXPAND_SZ. Nom du module et ID de table de chaîne du nom localisé de l’élément Panneau de configuration. Le format est un signe « at » (@) suivi du nom de l'.exe ou .dll qui contient la table de chaînes d’interface utilisateur multilingue (MUI). Les variables d’environnement peuvent être utilisées comme substitut d’une partie du chemin d’accès. Le chemin d’accès et le nom de fichier sont suivis d’une virgule (,) et d’un trait d’union (-), suivis de l’ID dans la table de chaînes.

    Si le module n’a pas de table de chaînes, cette entrée peut simplement être la chaîne de nom d’affichage. Si vous utilisez uniquement la chaîne de nom d’affichage plutôt qu’une table de chaînes, le nom ne s’ajuste pas à la langue d’affichage actuelle.

  • Info-bulle. REG_SZ ou REG_EXPAND_SZ. Description de l’élément Panneau de configuration. Ces informations sont affichées dans une info-bulle qui s’affiche lorsque la souris pointe sur l’icône de l’élément. La syntaxe est la même que celle utilisée pour LocalizedString, y compris l’option de fournir simplement une chaîne plutôt qu’une référence de table de chaînes.

  • System.ApplicationName. REG_SZ. Nom canonique de l'élément. La commande de formulaire control.exe /name System.ApplicationName ouvre l’élément ; par exemple, control.exe /name MyCorporation.MySettings. Pour plus d’informations sur l’utilisation de Control.exe, consultez Exécution d’éléments Panneau de configuration.

  • System.ControlPanel.Category. REG_SZ. Valeur qui déclare le Panneau de configuration catégories où l’élément apparaît. Plusieurs catégories sont séparées par des virgules. Dans l’exemple ci-dessus, l’entrée spécifie que l’élément Mes paramètres doit apparaître dans les catégories Apparence et Personnalisation et Programmes . Pour connaître les valeurs de catégorie possibles, consultez Affectation de catégories Panneau de configuration.

  • System.Software.TasksFileUrl. REG_SZ ou REG_EXPAND_SZ. Chemin d’accès du fichier XML qui définit les liens de tâche. Il peut s’agir d’un chemin d’accès de fichier direct, comme indiqué dans l’exemple, ou d’une ressource incorporée spécifiée en tant que nom de module et ID de ressource tel que « %ProgramFiles%\MyCorp\MyApp\MyApp.exe,-31 ».

Étape 4 :

Sous cette même sous-clé GUID, ajoutez la sous-clé suivante au Registre pour fournir le chemin du fichier qui contient l’icône et l’ID de ressource de l’image dans ce fichier.

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         DefaultIcon
            (Default) = %ProgramFiles%\MyCorp\MyApp.exe,-2

Notez que bien que la syntaxe soit similaire aux entrées LocalizedString et InfoTip décrites précédemment, aucun caractère « @ » n’est utilisé comme préfixe dans l’entrée REG_SZ ou REG_EXPAND_SZ qui spécifie le chemin.

Étape 5 :

Ajoutez les informations suivantes au Registre pour fournir la commande appelée par le système lorsque l’utilisateur ouvre le Panneau de configuration.

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         Shell
            Open
               Command
                  (Default) = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp.exe /Settings

Inscription d’éléments Panneau de configuration

Comment inscrire des éléments de Panneau de configuration DLL