Crear una extensión con una plantilla de elemento de EditorCreating an Extension with an Editor Item Template

Puede usar plantillas de elementos que se incluyen en el SDK de Visual Studio para crear extensiones de editor básico que aumenta el editor de clasificadores, opciones gráficas y los márgenes.You can use item templates that are included in the Visual Studio SDK to create basic editor extensions that add classifiers, adornments, and margins to the editor. Las plantillas de elementos de editor están disponibles para los proyectos de Visual C# o Visual Basic VSIX.The editor item templates are available for Visual C# or Visual Basic VSIX projects.

Requisitos previosPrerequisites

A partir de Visual Studio 2015, no instale el SDK de Visual Studio desde el centro de descarga.Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. Se incluye como una característica opcional en el programa de instalación de Visual Studio.It is included as an optional feature in Visual Studio setup. También puede instalar el SDK de VS más adelante.You can also install the VS SDK later on. Para obtener más información, consulte instalar el SDK de Visual Studio.For more information, see Installing the Visual Studio SDK.

Crear una extensión de clasificadorCreating a Classifier Extension

La plantilla de elemento de clasificador de Editor crea un clasificador de editor que colorea el texto adecuado (en este caso, todo el contenido) en cualquier archivo de texto.The Editor Classifier item template creates an editor classifier that colors the appropriate text (in this case, everything) in any text file.

  1. En el nuevo proyecto cuadro de diálogo, expanda Visual C# o Visual Basic y, a continuación, haga clic en extensibilidad.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. En el plantillas panel, seleccione proyecto VSIX.In the Templates pane, select VSIX Project. En el cuadro Nombre, escriba TestClassifier.In the Name box, type TestClassifier. Haga clic en Aceptar.Click OK.

  2. En el el Explorador de soluciones, haga clic en el nodo del proyecto y seleccione Agregar / nuevo elemento.In the Solution Explorer, right-click the project node and select Add / New Item. Vaya a Visual C# extensibilidad nodo y seleccione clasificador de Editor.Go to the Visual C# Extensibility node and select Editor Classifier. Deje el nombre de archivo predeterminado (EditorClassifier1.cs).Leave the default file name (EditorClassifier1.cs).

  3. Hay tres archivos de código, como se indica a continuación:There are three code files, as follows:

    • EditorClassifier1.cs contiene el EditorClassifier1 clase.EditorClassifier1.cs contains the EditorClassifier1 class.

    • EditorClassifier1ClassificationDefinition.cs contiene el EditorClassifier1ClassificationDefinition clase.EditorClassifier1ClassificationDefinition.cs contains the EditorClassifier1ClassificationDefinition class.

    • EditorClassifier1Format.cs contiene el EditorClassifier1Format clase.EditorClassifier1Format.cs contains the EditorClassifier1Format class.

    • EditorClassifier1Provider.cs contiene el EditorClassifier1Provider clase.EditorClassifier1Provider.cs contains the EditorClassifier1Provider class.

  4. Compile la solución y comience la depuración.Build the project and start debugging. Aparece la instancia experimental de Visual Studio.The experimental instance of Visual Studio appears.

    Si abre un archivo de texto, todo el texto está subrayado con un fondo violeta.If you open a text file, all the text is underlined against a violet background.

Crear una extensión de elementos gráficos relacionados con textoCreating a Text-Relative Adornment Extension

La plantilla de elementos gráficos de texto del Editor crea un elemento de gráfico de texto relativo que decora todas las instancias de los caracteres de texto 'a' mediante el uso de un cuadro con un contorno de color rojo y un fondo azul.The Editor Text Adornment template creates a text-relative adornment that decorates all instances of the text character 'a' by using a box that has a red outline and a blue background. Es texto relativo porque el cuadro siempre se superpone 'a' caracteres, incluso cuando se mueven o se vuelve a dar formato.It is text-relative because the box always overlays the 'a' characters, even when they are moved or reformatted.

  1. En el nuevo proyecto cuadro de diálogo, expanda Visual C# o Visual Basic y, a continuación, haga clic en extensibilidad.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. En el plantillas panel, seleccione proyecto VSIX.In the Templates pane, select VSIX Project. En el cuadro Nombre, escriba TestAdornment.In the Name box, type TestAdornment. Haga clic en Aceptar.Click OK.

  2. En el el Explorador de soluciones, haga clic en el nodo del proyecto y seleccione Agregar / nuevo elemento.In the Solution Explorer, right-click the project node and select Add / New Item. Vaya a Visual C# extensibilidad nodo y seleccione elementos de gráficos de Editor de texto.Go to the Visual C# Extensibility node and select Editor Text Adornment. Deje el nombre de archivo predeterminado (TextAdornment1.cs/vb).Leave the default file name (TextAdornment1.cs/vb).

  3. Hay dos archivos de código, como se indica a continuación:There are two code files, as follows:

    • TextAdornment1.cs contiene el TextAdornment1 clase.TextAdornment1.cs contains the TextAdornment1 class.

    • TextAdornment1TextViewCreationListener.cs contiene el TextAdornment1TextViewCreationListener clase.TextAdornment1TextViewCreationListener.cs contains the TextAdornment1TextViewCreationListener class.

  4. Compile la solución y comience la depuración.Build the project and start debugging. Aparece la instancia experimental.The experimental instance appears. Si abre un archivo de texto, la 'a' de los caracteres en el texto aparecen destacados en rojo con un fondo azul.If you open a text file, all the 'a' characters in the text are outlined in red against a blue background.

Crear una extensión de elemento gráfico relativa de la ventanillaCreating a Viewport-Relative Adornment Extension

La plantilla de elementos gráficos de área de visualización de Editor crea un elemento de gráfico relativa de la ventanilla que agrega un cuadro violeta con un contorno de color rojo a la esquina superior derecha de la ventanilla.The Editor Viewport Adornment template creates a viewport-relative adornment that adds a violet box that has a red outline to the top-right corner of the viewport.

Nota

El ventanilla es el área de la vista de texto que se muestra actualmente.The viewport is the area of the text view that is currently displayed.

Para crear una extensión de elementos gráficos de área de visualización mediante la plantilla de elemento de gráfico de área de visualización de EditorTo create a viewport adornment extension by using the Editor Viewport Adornment template

  1. En el nuevo proyecto cuadro de diálogo, expanda Visual C# o Visual Basic y, a continuación, haga clic en extensibilidad.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. En el plantillas panel, seleccione proyecto VSIX.In the Templates pane, select VSIX Project. En el cuadro Nombre, escriba ViewportAdornment.In the Name box, type ViewportAdornment. Haga clic en Aceptar.Click OK.

  2. En el el Explorador de soluciones, haga clic en el nodo del proyecto y seleccione Agregar / nuevo elemento.In the Solution Explorer, right-click the project node and select Add / New Item. Vaya a Visual C# extensibilidad nodo y seleccione elementos gráficos de área de visualización de Editor.Go to the Visual C# Extensibility node and select Editor Viewport Adornment. Deje el nombre de archivo predeterminado (ViewportAdornment1.cs/vb).Leave the default file name (ViewportAdornment1.cs/vb).

  3. Hay dos archivos de código, como se indica a continuación:There are two code files, as follows:

    • ViewportAdornment1.cs contiene el ViewportAdornment1 clase.ViewportAdornment1.cs contains the ViewportAdornment1 class.

    • ViewportAdornment1TextViewCreationListener.cs contiene el ViewportAdornment1TextViewCreationListener (clase)ViewportAdornment1TextViewCreationListener.cs contains the ViewportAdornment1TextViewCreationListener class

  4. Compile la solución y comience la depuración.Build the project and start debugging. Aparece la instancia experimental.The experimental instance appears. Si crea un nuevo archivo de texto, se muestra un cuadro violeta con un contorno de color rojo en la esquina superior derecha de la ventanilla.If you create a new text file, a violet box that has a red outline is displayed in the top-right corner of the viewport.

Crear una extensión de margenCreating a Margin Extension

La plantilla de margen de Editor crea un margen verde que aparece junto con las palabras "¡Hello world!"The Editor Margin template creates a green margin that appears together with the words "Hello world!" por debajo de la barra de desplazamiento horizontal.below the horizontal scrollbar.

Para crear una extensión de margen usando la plantilla de margen de EditorTo create a margin extension by using the Editor Margin template

  1. En el nuevo proyecto cuadro de diálogo, expanda Visual C# o Visual Basic y, a continuación, haga clic en extensibilidad.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. En el plantillas panel, seleccione proyecto VSIX.In the Templates pane, select VSIX Project. En el cuadro Nombre, escriba MarginExtension.In the Name box, type MarginExtension. Haga clic en Aceptar.Click OK.

  2. En el el Explorador de soluciones, haga clic en el nodo del proyecto y seleccione Agregar / nuevo elemento.In the Solution Explorer, right-click the project node and select Add / New Item. Vaya a Visual C# extensibilidad nodo y seleccione Editor margen.Go to the Visual C# Extensibility node and select Editor Margin. Deje el nombre de archivo predeterminado (EditorMargin1.cs/vb).Leave the default file name (EditorMargin1.cs/vb).

  3. Hay dos archivos de código, como se indica a continuación:There are two code files, as follows:

    • EditorMargin1.cs contiene el EditorMargin1 clase.EditorMargin1.cs contains the EditorMargin1 class.

    • EditorMargin1Factory.cs contiene el EditorMargin1Factory clase.EditorMargin1Factory.cs contains the EditorMargin1Factory class.

  4. Este proyecto de compilación e iniciar la depuración.Build this project and start debugging. Aparece la instancia experimental.The experimental instance appears. Si abre un archivo de texto, un margen verde con las palabras "Hello EditorMargin1" aparece debajo de la barra de desplazamiento horizontal.If you open a text file, a green margin that has the words "Hello EditorMargin1" is displayed below the horizontal scrollbar.

Vea tambiénSee Also

Servicio de lenguaje y puntos de extensión del editorLanguage Service and Editor Extension Points