Crear una extensión con una plantilla de elementos de editorCreate 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, los elementos gráficos 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 Install the Visual Studio SDK.

Crear una extensión de clasificadorCreate 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) 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 cuatro archivos de código, como sigue:There are four 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 elemento gráfico relacionados con textoCreate a text-relative adornment extension

La plantilla de elemento gráfico de texto del Editor crea un elemento de gráfico relacionados con el texto que está contenido en todas las instancias del carácter 'a' mediante un cuadro que tiene un contorno 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 relativo a texto porque el cuadro siempre superpuestas "a" caracteres, incluso cuando se mueven o cambian.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 elemento gráfico 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 sigue: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, se describen todos los 'a' caracteres en el texto 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 de gráfico relativa a la ventanillaCreate a viewport-relative adornment extension

La plantilla de elemento de gráfico de área de visualización de Editor crea un elemento de gráfico de ventanilla relativa que agrega un cuadro violeta que tiene un contorno 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 elemento gráfico 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 elemento gráfico 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 sigue:There are two code files, as follows:

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

    • ViewportAdornment1TextViewCreationListener.cs contiene el ViewportAdornment1TextViewCreationListener claseViewportAdornment1TextViewCreationListener.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 que tiene un contorno 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 margenCreate a margin extension

La plantilla de margen del Editor crea un margen verde que aparece junto con las palabras *Hola mundo!The Editor Margin template creates a green margin that appears together with the words *Hello world! debajo de la barra de desplazamiento horizontal.below the horizontal scroll bar.

Para crear una extensión de margen usando la plantilla del margen del 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 margen del Editor.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 sigue: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. Compilar el proyecto 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 de color verde que contiene 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 scroll bar.

Vea tambiénSee also

Puntos de extensión de editor y el servicio de lenguajeLanguage service and editor extension points