Partager via


Remplacer les valeurs par défaut de la visionneuse d’aide

Vous pouvez modifier le comportement par défaut de La Visionneuse d’aide Microsoft et des fonctionnalités liées à l’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 l’Observateur 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 clé de Registre Type Data Descriptif
ServiceDeNouveauContenuEtDeMiseÀJour ficelle <URL du point de terminaison de service> Définir un point de terminaison de service unique
UtiliserAideEnLigne dword 0 pour spécifier l’aide locale, 1 pour spécifier l’aide en ligne Définir l’aide en ligne ou hors connexion par défaut
OnlineBaseUrl ficelle <URL du point de terminaison de service> Définir un point de terminaison F1 unique
PréférenceAideEnLigneDésactivée dword 0 pour activer ou 1 désactiver l’option de préférence d’aide en ligne Désactiver l’option de préférence d’aide en ligne
DésactiverGérerContenu dword 0 pour activer ou 1 désactiver l’onglet Gérer le contenu dans la Visionneuse d’aide Désactiver l’onglet Gérer le contenu
DisableFirstRunHelpSelection dword 0 pour activer ou 1 désactiver les fonctionnalités d’aide configurées la première fois que Visual Studio démarre Désactiver l’installation du contenu au premier lancement 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 UseOnlineHelp valeur :

    "UseOnlineHelp"=dword:00000001

  4. Copiez le fichier dans le dossier CommonExtensions de votre installation de Visual Studio. Par 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. À l’invite de commandes du 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 de Registre pour modifier le comportement de la Visionneuse d’aide

Vous pouvez contrôler les types de comportement suivants en définissant des valeurs de clé de Registre dans l’Éditeur du Registre.

Tâche Clé de registre Valeur Data
Outrepasser la priorité de la tâche BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (sur une machine 64 bits)\Microsoft\Help\v2.3 BITSPriority premier plan, élevé, normal ou faible
Pointer vers le stockage de contenu local sur le partage réseau HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 LocationPath ContentStoreNetworkShare