Compartir a través de

Invalidación de los valores predeterminados del Visor de Ayuda

  • Artículo

Puede modificar el comportamiento predeterminado del Visor de Ayuda de Microsoft y las características relacionadas con la Ayuda en el IDE de Visual Studio.

Help Content Manager es una herramienta que puede usar para implementar y administrar el contenido local del Visor de Ayuda. Para cambiar el comportamiento del Visor de Ayuda, puede invalidar la configuración predeterminada del programa ejecutable Help Content Manager, HlpCtntMgr.exe.

Hay diferentes maneras de establecer las opciones de Help Content Manager:

  • Cree un archivo .pkgdef para establecer los valores de clave del Registro.
  • Establezca las opciones directamente en el Registro.

Uso de un archivo .pkgdef para cambiar el comportamiento del Visor de Ayuda

Un archivo .pkgdef almacena información de configuración que usa el Visor de Ayuda. Puede usar un archivo .pkgdef para ajustar los valores de clave del Registro que se enumeran en la tabla siguiente:

Valor de la clave del Registro Tipo data Descripción
NewContentAndUpdateService string <URL del punto de conexión de servicio> Define un punto de conexión de servicio único.
UseOnlineHelp dword 0 para especificar Ayuda local, 1 para especificar Ayuda en línea Define el valor predeterminado de la Ayuda en línea o sin conexión.
OnlineBaseUrl string <URL del punto de conexión de servicio> Define un punto de conexión F1 único.
OnlineHelpPreferenceDisabled dword 0 para habilitar o 1 para deshabilitar la opción de preferencia de Ayuda en línea Deshabilita la opción de preferencia de Ayuda en línea.
DisableManageContent dword 0 para habilitar o 1 para deshabilitar la pestaña Administrar contenido en el Visor de Ayuda Deshabilite la pestaña Administrar contenido
DisableFirstRunHelpSelection dword 0 para habilitar o 1 para deshabilitar las características de ayuda que se configuran la primera vez que se inicia Visual Studio. Deshabilita la instalación de contenido en el primer inicio de Visual Studio.

Para establecer los valores de clave del Registro en un archivo .pkgdef, siga estos pasos:

  1. Cree un archivo y asígnele la extensión .pkgdef.

  2. Agregue el texto siguiente a la primera línea del archivo:

    [$RootKey$\Help]

  3. En líneas independientes, agregue cualquiera de los valores de clave del Registro que describe la tabla anterior. Por ejemplo, puede agregar esta línea para configurar el valor de UseOnlineHelp:

    "UseOnlineHelp"=dword:00000001

  4. Copie el archivo en la carpeta CommonExtensions de la instalación de Visual Studio. Por ejemplo:

    • Si usa la edición Community de Visual Studio 2017, agregue el archivo .pkgdef a esta carpeta:

      C:\Archivos de programa (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions

    • Si usa la edición Community de Visual Studio 2022, agregue el archivo .pkgdef a esta carpeta:

      C:\Archivos de programa\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions

  5. En el símbolo del sistema para desarrolladores, ejecute este comando:

    devenv /updateconfiguration

Contenido del archivo .pkgdef de ejemplo

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

Uso del Editor del Registro para cambiar el comportamiento del Visor de Ayuda

Puede controlar los siguientes tipos de comportamiento estableciendo los valores de clave del Registro en el Editor del Registro.

Tarea Clave del Registro Value data
Invalidar la prioridad de trabajos del servicio BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (en un equipo de 64 bits)\Microsoft\Help\v2.3 BITSPriority foreground, high, normal o low
Apuntar al almacén de contenido local en un recurso compartido de red HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 LocationPath ContentStoreNetworkShare

Contenido relacionado