Como: adicionar marcadores de texto padrão

Use o seguinte procedimento para criar um dos tipos de marcador de texto padrão fornecidos com o Visual Studio editor do núcleo.

Para criar um marcador de texto

• Dependendo se você estiver usando um ou dois - sistema de coordenadas tridimensional, chamada a CreateLineMarker método ou a CreateStreamMarker método para criar um novo marcador de texto.

  Na chamada de método, especifique um tipo de marcador, um intervalo de texto para criar o marcador e um IVsTextMarkerClient interface. Esse método retorna um ponteiro para o marcador de texto criado recentemente. Tipos de marcador são obtidos a partir do MARKERTYPE enumeração. Especificar um IVsTextMarkerClient se você quiser ser informado dos eventos de marcador de interface.

  Dica

  Crie marcadores de texto no principal segmento da interface do usuário.O editor de núcleo se baseia no conteúdo do buffer de texto para criar marcadores de texto e o buffer de texto não é thread-safe.

Adicionar um comando personalizado

Implementando o IVsTextMarkerClient interface e fornecendo um ponteiro para ela partir de um marcador aprimora o comportamento do marcador de várias maneiras. Em primeiro lugar, isso permite que você para fornecer dicas para o marcador e para executar comandos. Isso também permite que você para receber notificações de evento para marcadores individuais e para criar um menu de contexto personalizado sobre o marcador. Use o procedimento a seguir para adicionar um comando personalizado ao menu de contexto do marcador.

Para adicionar um comando personalizado ao menu de contexto

1. Antes que seja exibido o menu de contexto, o ambiente chama o GetMarkerCommandInfo método e passa um ponteiro para o marcador de texto para você afetado e o número do item comando no menu de contexto.

   Por exemplo, os comandos específicos do ponto de interrupção no menu de contexto incluem Remover ponto de interrupção por meio de Novo ponto de interrupção, conforme exibido na seguinte captura de tela.

   

2. Passe de volta um texto identificando o nome do comando personalizado. Por exemplo, Remover ponto de interrupção pode ser um comando personalizado, se o ambiente não já forneceu-lo. Você também passa novamente se o comando está disponível com suporte e habilitado e/ou uma alternância de liga-desliga. O ambiente usa essas informações para exibir o comando personalizado no menu de contexto da maneira correta.

3. Para executar o comando, as chamadas do ambiente de ExecMarkerCommand método, passando a você um ponteiro para o marcador de texto e o número do comando selecionado no menu de contexto.

   Use essas informações desta chamada para executar quaisquer ações do marcador de texto determina do comando personalizado.

Consulte também

Tarefas

Como: implementar marcadores de erro

Como: criar marcadores de texto personalizado

Conceitos

Como: usar marcadores de texto

Outros recursos

Através de marcadores de texto com a API Legacy