Partilhar via

Criar uma extensão com um modelo de item de editor

Você pode usar modelos de item incluídos no SDK do Visual Studio para criar extensões básicas do editor que adicionam classificadores, adornos e margens ao editor. Os modelos de item do editor estão disponíveis para projetos Visual C# ou Visual Basic VSIX.

Pré-requisitos

Criar uma extensão de classificador

O modelo de item Editor Classifier cria um classificador editor que colore o texto apropriado (neste caso, tudo) em qualquer arquivo de texto.

  1. Crie um novo projeto usando o modelo Projeto VSIX . Dê-lhe o nome de TestClassifier.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Adicionar>Novo Item. Se aparecer uma janela compacta, clique em Mostrar Todos os Modelos. Vá para o nó Extensibilidade do Visual C# e selecione Classificador do Editor. Deixe o nome de arquivo padrão (EditorClassifier1.cs).

  3. Há quatro arquivos de código, da seguinte maneira:

    • EditorClassifier1.cs contém a EditorClassifier1 classe.

    • EditorClassifier1ClassificationDefinition.cs contém a EditorClassifier1ClassificationDefinition classe.

    • EditorClassifier1Format.cs contém a EditorClassifier1Format classe.

    • EditorClassifier1Provider.cs contém a EditorClassifier1Provider classe.

  4. Compile o projeto e inicie o processo de depuração. A instância experimental do Visual Studio é exibida.

    Se você abrir um arquivo de texto, todo o texto será sublinhado contra um fundo violeta.

Criar uma extensão de decoração relativa ao texto

O modelo Adorno de Texto do Editor cria um adorno relativo ao texto que decora todas as ocorrências do carácter 'a', utilizando uma caixa com um contorno vermelho e um fundo azul. É relativo ao texto porque a caixa sempre sobrepõe os caracteres 'a', mesmo quando eles são movidos ou reformatados.

  1. Crie um novo projeto usando o modelo Projeto VSIX . Dê-lhe o nome de TestAdornment.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Adicionar>Novo Item. Vá para o nó Extensibilidade do Visual C# e selecione Adorno de texto do editor. Deixe o nome de arquivo padrão (TextAdornment1.cs/vb).

  3. Existem dois ficheiros de código, como se segue:

    • TextAdornment1.cs contém a TextAdornment1 classe.

    • TextAdornment1TextViewCreationListener.cs contém a TextAdornment1TextViewCreationListener classe.

  4. Construa o projeto e inicie a depuração. A instância experimental aparece. Se você abrir um arquivo de texto, todos os caracteres 'a' no texto serão delineados em vermelho contra um fundo azul.

Criar uma extensão de adereço relativo ao viewport

O modelo Editor Viewport Adornment cria um adorno relativo ao visor que adiciona uma caixa violeta com um contorno vermelho no canto superior direito do visor.

Observação

O janela de visualização é a área do modo de exibição de texto atualmente visível.

Para criar uma extensão de adorno de viewport usando o modelo Editor Viewport Adornment

  1. Crie um novo projeto usando o modelo Projeto VSIX . Dê-lhe o nome de ViewportAdornment.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Adicionar>Novo Item. Vá para o nó Extensibilidade do Visual C# e selecione Adorno do Editor de Janela de Visualização. Deixe o nome de arquivo padrão (ViewportAdornment1.cs/vb).

  3. Existem dois ficheiros de código, como se segue:

    • ViewportAdornment1.cs contém a ViewportAdornment1 classe.

    • ViewportAdornment1TextViewCreationListener.cs contém a ViewportAdornment1TextViewCreationListener classe

  4. Construa o projeto e inicie a depuração. A instância experimental aparece. Se você criar um novo arquivo de texto, uma caixa violeta com um contorno vermelho será exibida no canto superior direito do visor.

Criar uma extensão de margem

O modelo Margem do Editor cria uma margem verde que aparece junto com as palavras *Olá mundo! abaixo da barra de rolagem horizontal.

Para criar uma extensão de margem usando o modelo de Margem do Editor

  1. Crie um novo projeto usando o modelo Projeto VSIX . Dê-lhe o nome de MarginExtension.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Adicionar>Novo Item. Vá para o nó Extensibility do Visual C# e selecione Margem de Edição. Deixe o nome de arquivo padrão (EditorMargin1.cs/vb).

  3. Existem dois ficheiros de código, como se segue:

    • EditorMargin1.cs contém a EditorMargin1 classe.

    • EditorMargin1Factory.cs contém a EditorMargin1Factory classe.

  4. Inicie este projeto e comece a fazer o debug. A instância experimental aparece. Se você abrir um arquivo de texto, uma margem verde com as palavras Hello EditorMargin1 será exibida abaixo da barra de rolagem horizontal.

Conteúdo relacionado

  • Last updated on