Compartilhar via

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

  • Artigo

Você pode usar modelos de item incluídos no SDK do Visual Studio para criar extensões de editor básicas 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.

Criar uma extensão de classificador

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

  1. Na caixa de diálogo Novo projeto , expanda Visual C# ou Visual Basic e, em seguida, clique em extensibilidade . No painel Modelos, selecione Projeto VSIX. Na caixa Nome, digite TestClassifier. Clique em OK.

  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 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 comece a depuração. A instância experimental do Visual Studio aparece.

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

Criar uma extensão de adorno relativo ao texto

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

  1. Na caixa de diálogo Novo projeto , expanda Visual C# ou Visual Basic e, em seguida, clique em extensibilidade . No painel Modelos, selecione Projeto VSIX. Na caixa Nome, digite TestAdornment. Clique em OK.

  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 Editor de adorno de texto. Deixe o nome de arquivo padrão (TextAdornment1.cs/vb).

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

    • TextAdornment1.cs contém a TextAdornment1 classe.

    • TextAdornment1TextViewCreationListener.cs contém a TextAdornment1TextViewCreationListener classe.

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

Criar uma extensão de adorno relativo ao visor

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

Observação

O visor é a área do modo de exibição de texto que é exibido no momento.

Para criar uma extensão de adorno de visor usando o modelo de Adorno de Porta de Exibição do Editor

  1. Na caixa de diálogo Novo projeto , expanda Visual C# ou Visual Basic e, em seguida, clique em extensibilidade . No painel Modelos, selecione Projeto VSIX. Na caixa Nome, digite ViewportAdornment. Clique em OK.

  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 Editor Viewport Adornment. Deixe o nome de arquivo padrão (ViewportAdornment1.cs/vb).

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

    • ViewportAdornment1.cs contém a ViewportAdornment1 classe.

    • ViewportAdornment1TextViewCreationListener.cs contém a ViewportAdornment1TextViewCreationListener classe

  4. Compile o projeto e comece a depuração. A instância experimental é exibida. 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 *Hello world! abaixo da barra de rolagem horizontal.

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

  1. Na caixa de diálogo Novo projeto , expanda Visual C# ou Visual Basic e, em seguida, clique em extensibilidade . No painel Modelos, selecione Projeto VSIX. Na caixa Nome, digite MarginExtension. Clique em OK.

  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 Margem do Editor. Deixe o nome de arquivo padrão (EditorMargin1.cs/vb).

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

    • EditorMargin1.cs contém a EditorMargin1 classe.

    • EditorMargin1Factory.cs contém a EditorMargin1Factory classe.

  4. Crie este projeto e comece a depuração. A instância experimental é exibida. 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