Guide pratique pour inscrire des éléments de Panneau de configuration DLL
Notes
Les instructions d’implémentation actuelles indiquent que les nouveaux éléments Panneau de configuration doivent être implémentés en tant que fichiers .exe plutôt qu’en tant que fichiers .cpl. Les informations suivantes sont incluses principalement à des fins héritées.
Panneau de configuration éléments implémentés dans une DLL qui exporte la fonction CPlApplet ont des exigences d’inscription différentes de celles des fichiers .exe. À partir de Windows XP, les dll de nouveaux éléments Panneau de configuration doivent être installées dans le dossier de l’application associée sous le dossier Program Files. Les éléments stockés dans le répertoire System32 avec une extension .cpl n’ont pas besoin d’être inscrits ; ils s’affichent automatiquement dans le Panneau de configuration. Tous les autres éléments Panneau de configuration qui utilisent CPlApplet doivent être inscrits de l’une des deux manières suivantes :
- Si l’élément Panneau de configuration doit être disponible pour tous les utilisateurs, inscrivez le chemin d’accès par ordinateur en ajoutant une valeur REG_EXPAND_SZ à la sous-clé HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Panneau de configuration\Cpls, définie sur le chemin d’accès DLL.
- Si l’élément Panneau de configuration doit être disponible par utilisateur, utilisez HKEY_CURRENT_USER comme clé racine au lieu de HKEY_LOCAL_MACHINE.
Les deux exemples suivants inscrivent l’élément Panneau de configuration MyCplApp. La DLL est nommée MyCpl.cpl et se trouve dans le répertoire de l’application MyCorp\MyApp . Ce premier exemple illustre l’inscription par ordinateur.
Instructions
Étape 1 :
Ajoutez ces informations au registre pour enregistrer l’existence du fichier .cpl.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Cpls
MyCpl = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl
Étape 2 :
Windows Vista et versions ultérieures : Ajoutez ces informations supplémentaires au Registre pour fournir un GUID pour l’élément Panneau de configuration.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.AppId
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = {A newly generated GUID}
En générant un GUID pour identifier de manière unique l’élément Panneau de configuration, vous pouvez ajouter des liens de tâche à la Panneau de configuration. Sans ce GUID, il n’existe aucun moyen d’associer les liens de tâche à l’élément Panneau de configuration. Consultez Création de liens de tâche pouvant faire l’objet d’une recherche pour un élément Panneau de configuration.
Étape 3 :
Windows Vista et versions ultérieures : Ajoutez les informations suivantes au Registre pour créer un nom canonique pour l’élément.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ApplicationName
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] MyCorporation.MyCpl
En ajoutant un nom canonique, les utilisateurs peuvent lancer l’élément Panneau de configuration à partir d’une ligne de commande en entrant control.exe /name MyCorporation.MyCpl. Cela permet également de changer une implémentation d’un fichier .cpl à un fichier .exe ultérieurement, sans nécessiter de modifications des programmes appelants, car ils peuvent continuer à ouvrir l’élément via son nom canonique. Pour plus d’informations sur les noms canoniques, consultez Exécution de Panneau de configuration éléments.
Étape 4 :
Windows Vista et versions ultérieures : Ajoutez les informations suivantes au Registre pour affecter un élément Panneau de configuration à une ou plusieurs catégories.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ControlPanel.Category
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
Windows XP : Ajoutez les informations suivantes au Registre pour affecter un élément Panneau de configuration à une ou plusieurs catégories.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
{305CA226-D286-468e-B848-2B2E8E697B74} 2
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
Cet exemple montre comment affecter l’élément à la catégorie 3, qui est Réseau et Internet. Pour ajouter un élément à plusieurs catégories, fournissez la liste sous la forme d’une valeur REG_SZ séparée par des virgules, telles que « 3,8 ». Les valeurs peuvent être fournies sous forme décimale ou hexadécimale. Notez que la possibilité d’ajouter un élément à plusieurs catégories n’est possible que dans Windows XP Service Pack 2 (SP2) et versions ultérieures. Pour connaître toutes les valeurs possibles, consultez Affectation de catégories Panneau de configuration.
Étape 5 :
Windows Vista et versions ultérieures : Ajoutez les informations suivantes au Registre pour créer et pointer vers un fichier XML pour contenir des liens de tâche pour l’élément. La valeur doit être un chemin d’accès REG_SZ comme indiqué ici ou un ID de module et de ressource (par exemple, « C:\Program Files\MyCorp\MyApp\MyApp.exe,-31 ») s’il s’agit d’une ressource incorporée. L’emplacement du fichier XML doit être entièrement spécifié. Il ne peut pas utiliser une variable d’environnement telle que %ProgramFiles%.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.TasksFileUrl
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] C:\ProgramFiles\MyCorp\MyApp\MyTasks.xml
Pour plus d’informations sur les liens de tâches et sur la façon de créer le fichier XML pour les contenir, consultez Création de liens de tâche pouvant faire l’objet d’une recherche pour un élément Panneau de configuration.
Rubriques connexes