Creación de una extensión con una plantilla de elemento de editor

Puede usar plantillas de elemento que se incluyen en el SDK de Visual Studio para crear extensiones de editor básicas que agreguen clasificadores, adornos y márgenes al editor. Las plantillas de elementos de editor están disponibles para proyectos VSIX de Visual C# o Visual Basic.

Creación de una extensión clasificadora

La plantilla de elemento Clasificador del editor crea un clasificador de editor que colorea el texto adecuado (en este caso, todo) en cualquier archivo de texto.

1. En el cuadro de diálogo Nuevo proyecto , expanda Visual C# o Visual Basic y, a continuación, haga clic en Extensibilidad. En el panel Plantillas , seleccione Proyecto VSIX. En el cuadro Nombre , escriba TestClassifier. Haga clic en OK.

2. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y seleccione Agregar>Nuevo elemento. Vaya al nodo Extensibilidad de Visual C# y seleccione Clasificador del editor. Deje el nombre de archivo predeterminado (EditorClassifier1.cs).

3. Hay cuatro archivos de código, como se indica a continuación:

   • EditorClassifier1.cs contiene la EditorClassifier1 clase .

   • EditorClassifier1ClassificationDefinition.cs contiene la EditorClassifier1ClassificationDefinition clase .

   • EditorClassifier1Format.cs contiene la EditorClassifier1Format clase .

   • EditorClassifier1Provider.cs contiene la EditorClassifier1Provider clase .

4. Compile la solución y comience la depuración. Aparece la instancia experimental de Visual Studio.

   Si abre un archivo de texto, todo el texto se subraya con un fondo violeta.

Crear una extensión de adorno relativa al texto

La plantilla Editor Text Adornment crea un adorno relativo al texto que decora todas las instancias del carácter de texto "a" mediante un cuadro que tiene un contorno rojo y un fondo azul. Es relativa al texto porque el cuadro siempre superpone los caracteres "a", incluso cuando se mueven o se vuelven a formatear.

1. En el cuadro de diálogo Nuevo proyecto , expanda Visual C# o Visual Basic y, a continuación, haga clic en Extensibilidad. En el panel Plantillas , seleccione Proyecto VSIX. En el cuadro Nombre , escriba TestAdornment. Haga clic en OK.

2. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y seleccione Agregar>Nuevo elemento. Vaya al nodo Extensibilidad de Visual C# y seleccione Editor Text Adornment (Adorno de texto del editor). Deje el nombre de archivo predeterminado (TextAdornment1.cs/vb).

3. Hay dos archivos de código, como se indica a continuación:

   • TextAdornment1.cs contiene la TextAdornment1 clase .

   • TextAdornment1TextViewCreationListener.cs contiene la TextAdornment1TextViewCreationListener clase .

4. Compile la solución y comience la depuración. Aparece la instancia experimental. Si abre un archivo de texto, todos los caracteres "a" del texto se describen en rojo con un fondo azul.

Crear una extensión de adorno relativa a la ventanilla

La plantilla Editor Viewport Adornment crea un adorno relativo a la ventanilla que agrega un cuadro violeta que tiene un contorno rojo a la esquina superior derecha de la ventanilla.

Nota:

La ventanilla es el área de la vista de texto que se muestra actualmente.

Para crear una extensión de adorno de ventanilla mediante la plantilla Editor Viewport Adornment

1. En el cuadro de diálogo Nuevo proyecto , expanda Visual C# o Visual Basic y, a continuación, haga clic en Extensibilidad. En el panel Plantillas , seleccione Proyecto VSIX. En el cuadro Nombre , escriba ViewportAdornment. Haga clic en OK.

2. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y seleccione Agregar>Nuevo elemento. Vaya al nodo Extensibilidad de Visual C# y seleccione Editor Viewport Adornment (Adorno de ventanilla del editor). Deje el nombre de archivo predeterminado (ViewportAdornment1.cs/vb).

3. Hay dos archivos de código, como se indica a continuación:

   • ViewportAdornment1.cs contiene la ViewportAdornment1 clase .

   • ViewportAdornment1TextViewCreationListener.cs contiene la ViewportAdornment1TextViewCreationListener clase

4. Compile la solución y comience la depuración. Aparece la instancia experimental. 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.

Creación de una extensión de margen

La plantilla Margen del editor crea un margen verde que aparece junto con las palabras *Hola mundo! debajo de la barra de desplazamiento horizontal.

Para crear una extensión de margen mediante la plantilla Margen del editor

1. En el cuadro de diálogo Nuevo proyecto , expanda Visual C# o Visual Basic y, a continuación, haga clic en Extensibilidad. En el panel Plantillas , seleccione Proyecto VSIX. En el cuadro Nombre , escriba MarginExtension. Haga clic en OK.

2. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y seleccione Agregar>Nuevo elemento. Vaya al nodo Extensibilidad de Visual C# y seleccione Margen del editor. Deje el nombre de archivo predeterminado (EditorMargin1.cs/vb).

3. Hay dos archivos de código, como se indica a continuación:

   • EditorMargin1.cs contiene la EditorMargin1 clase .

   • EditorMargin1Factory.cs contiene la EditorMargin1Factory clase .

4. Compile este proyecto e inicie la depuración. Aparece la instancia experimental. Si abre un archivo de texto, se muestra un margen verde con las palabras Hello EditorMargin1 debajo de la barra de desplazamiento horizontal.

Contenido relacionado

• Servicio de lenguaje y puntos de extensión del editor