Compartilhar via

Substituir configurações padrões do Help Viewer

Você pode alterar o comportamento padrão do Microsoft Help Viewer e os recursos relacionados à 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 Help Content Manager, 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 que o Help Viewer usa. Você pode usar um arquivo .pkgdef para ajustar os valores de chave do Registro que a tabela a seguir lista:

Valor da chave do Registro Tipo Dados Description
NovoServiçoDeConteúdoEAtualização cadeia <URL do ponto de extremidade de serviço> Definir um ponto de extremidade de serviço exclusivo
UseOnlineHelp dword 0 para especificar a Ajuda local, 1 para especificar a Ajuda online Definir o padrão de Ajuda online ou offline
OnlineBaseUrl cadeia <URL do endpoint de serviço> Definir um ponto de extremidade F1 exclusivo
PreferênciaAjudaOnlineDesativada dword 0 para habilitar ou 1 desabilitar a opção de preferência de Ajuda online Desabilitar a opção de preferência de Ajuda online
DesativarGerenciarConteúdo dword 0 para habilitar ou 1 desabilitar a guia Gerenciar Conteúdo no Help Viewer Desabilitar a guia Gerenciar Conteúdo
DesativarSeleçãoAjudaPrimeiraExecução dword 0 para habilitar ou 1 desabilitar recursos de ajuda configurados na primeira vez que o Visual Studio é iniciado Desabilitar a instalação do conteúdo no início do Visual Studio

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

  1. Crie um novo 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 pela tabela anterior. Por exemplo, você pode adicionar essa linha para configurar o UseOnlineHelp valor:

    "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

Exemplo de conteúdo do arquivo .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

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

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

Tarefa Chave do Registo Value Dados
Substituir a prioridade da tarefa do BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (em um computador de 64 bits)\Microsoft\Help\v2.3 BITSPriority primeiro plano, alto, normal ou baixo
Apontar para o repositório de conteúdo local no compartilhamento de rede HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 LocationPath ContentStoreNetworkShare

Conteúdo relacionado

  • Last updated on