Compartilhar via


Substituir padrões do Help Viewer

Você pode alterar o comportamento padrão do Microsoft Help Viewer e das funcionalidades relacionadas à Ajuda no IDE do Visual Studio.

O Gerenciador de Conteúdo da Ajuda é uma ferramenta que você pode usar para implantar e gerenciar o conteúdo local do Help Viewer. Para alterar o comportamento do Help Viewer, você pode substituir as configurações padrão do programa executável do Gerenciador de Conteúdo da Ajuda, HlpCtntMgr.exe.

Há diferentes maneiras de definir as opções do Gerenciador de Conteúdo da Ajuda:

  • Crie um arquivo .pkgdef para definir valores de chave do Registro.
  • Defina as opções diretamente no Registro.

Usar um arquivo .pkgdef para alterar o comportamento do Help Viewer

Um arquivo .pkgdef armazena informações de configuração usadas pelo Help Viewer. Você pode usar um arquivo .pkgdef para ajustar os valores de chave do Registro listadas na seguinte tabela:

Valor da chave do Registro Tipo Dados Descrição
NewContentAndUpdateService string <URL do ponto de extremidade de serviço> Define um ponto de extremidade de serviço exclusivo
UseOnlineHelp DWORD 0 para especificar a Ajuda local, 1 para especificar a Ajuda online Definir padrão de Ajuda online ou offline
OnlineBaseUrl string <URL do ponto de extremidade de serviço> Definir um ponto de extremidade F1 exclusivo
OnlineHelpPreferenceDisabled DWORD 0 para habilitar ou 1 para desabilitar a opção de preferência de Ajuda online Desabilitar a opção de preferência de Ajuda online
DisableManageContent DWORD 0 para habilitar ou 1 para desabilitar a guia Gerenciar Conteúdo no Help Viewer Desabilitar a guia Gerenciar Conteúdo
DisableFirstRunHelpSelection DWORD 0 para habilitar ou 1 para desabilitar os recursos da Ajuda que são configurados na primeira vez que o Visual Studio é iniciado Desabilitar a instalação de conteúdo na primeira inicialização do Visual Studio

Para definir valores de chave do Registro em um arquivo .pkgdef, siga estas etapas:

  1. Crie um arquivo e dê a ele a extensão .pkgdef.

  2. Adicione o seguinte texto à primeira linha do arquivo:

    [$RootKey$\Help]

  3. Em linhas separadas, adicione qualquer um dos valores de chave do Registro descritos na tabela anterior. Por exemplo, você pode adicionar essa linha para configurar o valor UseOnlineHelp:

    "UseOnlineHelp"=dword:00000001

  4. Copie o arquivo para a pasta CommonExtensions da instalação do Visual Studio. Por exemplo:

    • Se você usar a edição Community do Visual Studio 2017, adicione o arquivo .pkgdef a esta pasta:

      C:\Arquivos de Programas(x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions

    • Se você usar a edição Community do Visual Studio 2022, adicione o arquivo .pkgdef a esta pasta:

      C:\Arquivos de Programas\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions

  5. Em um prompt de comando do desenvolvedor, execute este comando:

    devenv /updateconfiguration

Conteúdo do arquivo .pkgdef de exemplo

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

Usar o Editor do Registro para alterar o comportamento do Help Viewer

Você pode controlar os tipos de comportamento a seguir definindo valores de chave do Registro no Editor do Registro.

Tarefa Chave do Registro Valor Dados
Substituir a prioridade do trabalho BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (em um computador de 64 bits)\Microsoft\Help\v2.3 BITSPriority foreground, high, normal ou low
Aponte para o repositório de conteúdo local no compartilhamento de rede HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 LocationPath ContentStoreNetworkShare