Comment inscrire des éléments exécutables Panneau de configuration
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
Rubriques connexes