Поделиться через

Переопределение значений по умолчанию средства просмотра справки

  • Статья

Вы можете изменить поведение microsoft Help Viewer по умолчанию и вспомогательные функции в интегрированной среде разработки Visual Studio.

Help Content Manager — это средство, которое можно использовать для развертывания и управления локальным содержимым средства просмотра справки. Чтобы изменить поведение средства просмотра справки, можно переопределить параметры по умолчанию исполняемой программы Help Content Manager, HlpCtntMgr.exe.

Существуют различные способы настройки параметров Диспетчера содержимого справки:

  • Создайте PKGDEF-файл, чтобы задать значения раздела реестра.
  • Задайте параметры непосредственно в реестре.

Изменение поведения средства просмотра справки с помощью PKGDEF-файла

PKGDEF-файл хранит сведения о конфигурации, которые использует средство просмотра справки. С помощью PKGDEF-файла можно настроить значения раздела реестра, перечисленные в следующей таблице:

Параметр раздела реестра Тип Data Description
NewContentAndUpdateService строка <URL-адрес конечной точки службы> Указание уникальной конечной точки службы
UseOnlineHelp dword 0 для указания справки в Интернете; 1 для указания сетевой справки Указание справки в Интернете или автономной справки в качестве справки по умолчанию
OnlineBaseUrl строка <URL-адрес конечной точки службы> Указание уникальной конечной точки F1
OnlineHelpPreferenceDisabled dword 0, чтобы включить параметр справки в Интернете, или 1, чтобы отключить его Отключение параметра справки в Интернете
DisableManageContent dword 0, чтобы включить вкладку Управление содержимым в окне справки, или 1, чтобы отключить ее Отключение вкладки Управление содержимым
DisableFirstRunHelpSelection dword 0, чтобы включить возможности справки, настраиваемые при первом запуске Visual Studio, или 1, чтобы отключить их Отключение установки содержимого при первом запуске Visual Studio

Чтобы задать значения разделов реестра в PKGDEF-файле, выполните следующие действия:

  1. Создайте файл и присвойте ему расширение PKGDEF.

  2. Добавьте следующий текст в первую строку файла:

    [$RootKey$\Help]

  3. В отдельных строках добавьте любые значения раздела реестра, описанные в предыдущей таблице. Например, можно добавить эту строку для настройки UseOnlineHelp значения:

    "UseOnlineHelp"=dword:00000001

  4. Скопируйте файл в папку CommonExtensions установки Visual Studio. Например:

    • Если вы используете выпуск Community Visual Studio 2017, добавьте pkgdef-файл в эту папку:

      C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions

    • Если вы используете выпуск Community Visual Studio 2022, добавьте pkgdef-файл в эту папку:

      C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions

  5. В командной строке разработчика выполните следующую команду:

    devenv /updateconfiguration

Пример содержимого файла 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

Использование редактора реестра для изменения поведения окна справки

Вы можете управлять следующими типами поведения, задав значения разделов реестра в редакторе реестра.

Задача Раздел реестра Значение Data
Переопределение приоритета задания BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (на 64-разрядном компьютере)\Microsoft\Help\v2.3 BITSPriority foreground, high, normal или low
Указание на хранилище локального содержимого в сетевой папке с общим доступом HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 LocationPath ContentStoreNetworkShare

Связанный контент