Lire en anglais

Partager via


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.

Utiliser un fichier .pkgdef pour modifier le comportement de la Visionneuse d’aide

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 :

  1. Créez un fichier et donnez-lui l’extension .pkgdef.

  2. Ajoutez le texte suivant à la première ligne du fichier :

    [$RootKey$\Help]

  3. 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

  4. 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

  5. Sur l’invite de commandes développeur, exécutez cette commande :

    devenv /updateconfiguration

Exemple de contenu de fichier .pkgdef

[$RootKey$\Help]
"NewContentAndUpdateService"="https://some.service.endpoint"
"UseOnlineHelp"=dword:00000001
"OnlineBaseUrl"="https://some.service.endpoint"
"OnlineHelpPreferenceDisabled"=dword:00000000
"DisableManageContent"=dword:00000000
"DisableFirstRunHelpSelection"=dword:00000001

Utiliser l’Éditeur du Registre pour modifier le comportement de l’application Help Viewer

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