Remplacer les valeurs par défaut de la Visionneuse d’aide
Vous pouvez changer le comportement par défaut de Microsoft Help Viewer et des fonctionnalités d’aide dans l’IDE Visual Studio.
Help Content Manager est un outil que vous pouvez utiliser pour déployer et gérer le contenu de la Visionneuse d’aide locale. Pour modifier le comportement de la Visionneuse d’aide, vous pouvez remplacer les paramètres par défaut du programme exécutable Help Content Manager, HlpCtntMgr.exe.
Il existe différentes façons de définir les options du Gestionnaire de contenu d’aide :
- Créez un fichier .pkgdef pour définir les valeurs de clé de registre.
- Définissez les options directement dans le registre.
Un fichier .pkgdef stocke les informations de configuration que la Visionneuse d’aide utilise. Vous pouvez utiliser un fichier .pkgdef pour ajuster les valeurs de clé de registre répertoriées par le tableau suivant :
Valeur de la clé de Registre | Type | Données | Description |
---|---|---|---|
NewContentAndUpdateService | string | <URL du point de terminaison de service> | Définir un point de terminaison de service unique |
UseOnlineHelp | dword | 0 pour spécifier l’aide locale, 1 pour spécifier l’aide en ligne |
Définir l’aide en ligne ou l’aide locale comme option par défaut |
OnlineBaseUrl | string | <URL du point de terminaison de service> | Définir un point de terminaison unique F1 |
OnlineHelpPreferenceDisabled | dword | 0 pour activer ou 1 pour désactiver l’option de préférence d’aide en ligne |
Désactiver l’option de préférence d’aide en ligne |
DisableManageContent | dword | 0 pour activer ou 1 pour désactiver l’onglet Gérer le contenu dans Help Viewer |
Désactiver l’onglet Gérer le contenu |
DisableFirstRunHelpSelection | dword | 0 pour activer ou 1 pour désactiver les fonctionnalités d’aide configurées au premier démarrage de Visual Studio. |
Désactiver l’installation du contenu au premier démarrage de Visual Studio |
Pour définir des valeurs de clé de registre dans un fichier .pkgdef, procédez comme suit :
Créez un fichier et donnez-lui l’extension .pkgdef.
Ajoutez le texte suivant à la première ligne du fichier :
[$RootKey$\Help]
Sur des lignes distinctes, ajoutez l’une des valeurs de clé de registre décrites par le tableau précédent. Par exemple, vous pouvez ajouter cette ligne pour configurer la valeur
UseOnlineHelp
:"UseOnlineHelp"=dword:00000001
Copiez le fichier dans le dossier CommonExtensions de votre installation de Visual Studio. Exemple :
Si vous utilisez l’édition Community de Visual Studio 2017, ajoutez le fichier .pkgdef à ce dossier :
C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions
Si vous utilisez l’édition Community de Visual Studio 2022, ajoutez le fichier .pkgdef à ce dossier :
C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions
Sur l’invite de commandes développeur, exécutez cette commande :
devenv /updateconfiguration
[$RootKey$\Help]
"NewContentAndUpdateService"="https://some.service.endpoint"
"UseOnlineHelp"=dword:00000001
"OnlineBaseUrl"="https://some.service.endpoint"
"OnlineHelpPreferenceDisabled"=dword:00000000
"DisableManageContent"=dword:00000000
"DisableFirstRunHelpSelection"=dword:00000001
Vous pouvez contrôler les types de comportement suivants en définissant des valeurs de clé de registre dans l’Éditeur de registre.
Tâche | Clé de Registre | Valeur | Données |
---|---|---|---|
Substituer la priorité des travaux BITS | HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (sur un ordinateur 64 bits)\Microsoft\Help\v2.3 | BITSPriority | premier plan, haute, normale ou faible |
Pointer vers le magasin de contenu local sur un partage réseau | HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 | LocationPath | ContentStoreNetworkShare |