Créer une extension avec un éditeur de modèle d’élémentCreate an extension with an editor item template

Vous pouvez utiliser des modèles d’éléments qui sont inclus dans le SDK de Visual Studio pour créer des extensions de l’éditeur de base qui ajoutent des classifieurs, les ornements et les marges pour l’éditeur.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. Les modèles d’élément de l’éditeur sont disponibles pour les projets Visual c# ou Visual Basic VSIX.The editor item templates are available for Visual C# or Visual Basic VSIX projects.

PrérequisPrerequisites

À partir de Visual Studio 2015, vous n’installez pas le Kit de développement logiciel Visual Studio à partir du centre de téléchargement.Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. Il est inclus comme fonctionnalité facultative dans le programme d’installation de Visual Studio.It is included as an optional feature in Visual Studio setup. Vous pouvez également installer le kit SDK VS par la suite.You can also install the VS SDK later on. Pour plus d’informations, consultez installer le SDK Visual Studio.For more information, see Install the Visual Studio SDK.

Créer une extension de classifieurCreate a classifier extension

Le modèle d’élément de classifieur d’éditeur crée un classifieur d’éditeur qui le colore le texte approprié (dans ce cas, tous les éléments) dans n’importe quel fichier texte.The Editor Classifier item template creates an editor classifier that colors the appropriate text (in this case, everything) in any text file.

  1. Dans le nouveau projet boîte de dialogue, développez Visual C# ou Visual Basic puis cliquez sur extensibilité.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. Dans le modèles volet, sélectionnez projet VSIX.In the Templates pane, select VSIX Project. Dans la zone Nom, tapez TestClassifier.In the Name box, type TestClassifier. Cliquez sur OK.Click OK.

  2. Dans le l’Explorateur de solutions, cliquez sur le nœud du projet et sélectionnez ajouter > un nouvel élément.In the Solution Explorer, right-click the project node and select Add > New Item. Accédez à Visual c# extensibilité nœud et sélectionnez classifieur d’éditeur.Go to the Visual C# Extensibility node and select Editor Classifier. Laissez le nom de fichier par défaut (EditorClassifier1.cs).Leave the default file name (EditorClassifier1.cs).

  3. Il existe quatre fichiers de code, comme suit :There are four code files, as follows:

    • EditorClassifier1.cs contient la EditorClassifier1 classe.EditorClassifier1.cs contains the EditorClassifier1 class.

    • EditorClassifier1ClassificationDefinition.cs contient la EditorClassifier1ClassificationDefinition classe.EditorClassifier1ClassificationDefinition.cs contains the EditorClassifier1ClassificationDefinition class.

    • EditorClassifier1Format.cs contient la EditorClassifier1Format classe.EditorClassifier1Format.cs contains the EditorClassifier1Format class.

    • EditorClassifier1Provider.cs contient la EditorClassifier1Provider classe.EditorClassifier1Provider.cs contains the EditorClassifier1Provider class.

  4. Générez le projet et commencez le débogage.Build the project and start debugging. L’instance expérimentale de Visual Studio s’affiche.The experimental instance of Visual Studio appears.

    Si vous ouvrez un fichier texte, tout le texte est souligné par rapport à un arrière-plan violet.If you open a text file, all the text is underlined against a violet background.

Créer une extension de l’ornement de texte relatifCreate a text-relative adornment extension

Le modèle de l’ornement de texte de l’éditeur crée un ornement de texte relative qui décore toutes les instances du caractère de texte « a » à l’aide d’une zone qui a un contour rouge et un arrière-plan bleu.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. Il est relatif de texte, car la zone toujours superpositions les caractères 'a', même lorsqu’ils sont déplacés ou remis en forme.It is text-relative because the box always overlays the 'a' characters, even when they are moved or reformatted.

  1. Dans le nouveau projet boîte de dialogue, développez Visual C# ou Visual Basic puis cliquez sur extensibilité.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. Dans le modèles volet, sélectionnez projet VSIX.In the Templates pane, select VSIX Project. Dans la zone Nom, tapez TestAdornment.In the Name box, type TestAdornment. Cliquez sur OK.Click OK.

  2. Dans le l’Explorateur de solutions, cliquez sur le nœud du projet et sélectionnez ajouter > un nouvel élément.In the Solution Explorer, right-click the project node and select Add > New Item. Accédez à Visual c# extensibilité nœud et sélectionnez ornement de texte éditeur.Go to the Visual C# Extensibility node and select Editor Text Adornment. Laissez le nom de fichier par défaut (TextAdornment1.cs/vb).Leave the default file name (TextAdornment1.cs/vb).

  3. Il existe deux fichiers de code, comme suit :There are two code files, as follows:

    • TextAdornment1.cs contient la TextAdornment1 classe.TextAdornment1.cs contains the TextAdornment1 class.

    • TextAdornment1TextViewCreationListener.cs contient la TextAdornment1TextViewCreationListener classe.TextAdornment1TextViewCreationListener.cs contains the TextAdornment1TextViewCreationListener class.

  4. Générez le projet et commencez le débogage.Build the project and start debugging. L’instance expérimentale s’affiche.The experimental instance appears. Si vous ouvrez un fichier texte, « a » caractères dans le texte sont surlignées en rouge sur un arrière-plan bleu.If you open a text file, all the 'a' characters in the text are outlined in red against a blue background.

Créer une extension de l’ornement de la fenêtre d’affichage relatifCreate a viewport-relative adornment extension

Le modèle de l’ornement de la fenêtre d’affichage de l’éditeur crée un ornement relatif à la fenêtre d’affichage qui ajoute une zone violette qui a un contour rouge à l’angle supérieur droit de la fenêtre d’affichage.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.

Note

Le viewport est la zone de l’affichage de texte qui est actuellement affiché.The viewport is the area of the text view that is currently displayed.

Pour créer une extension d’ornement de la fenêtre d’affichage en utilisant le modèle de l’ornement de la fenêtre d’affichage de l’éditeurTo create a viewport adornment extension by using the Editor Viewport Adornment template

  1. Dans le nouveau projet boîte de dialogue, développez Visual C# ou Visual Basic puis cliquez sur extensibilité.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. Dans le modèles volet, sélectionnez projet VSIX.In the Templates pane, select VSIX Project. Dans la zone Nom, tapez ViewportAdornment.In the Name box, type ViewportAdornment. Cliquez sur OK.Click OK.

  2. Dans le l’Explorateur de solutions, cliquez sur le nœud du projet et sélectionnez ajouter > un nouvel élément.In the Solution Explorer, right-click the project node and select Add > New Item. Accédez à Visual c# extensibilité nœud et sélectionnez ornement de la fenêtre d’affichage d’éditeur.Go to the Visual C# Extensibility node and select Editor Viewport Adornment. Laissez le nom de fichier par défaut (ViewportAdornment1.cs/vb).Leave the default file name (ViewportAdornment1.cs/vb).

  3. Il existe deux fichiers de code, comme suit :There are two code files, as follows:

    • ViewportAdornment1.cs contient la ViewportAdornment1 classe.ViewportAdornment1.cs contains the ViewportAdornment1 class.

    • ViewportAdornment1TextViewCreationListener.cs contient la ViewportAdornment1TextViewCreationListener classeViewportAdornment1TextViewCreationListener.cs contains the ViewportAdornment1TextViewCreationListener class

  4. Générez le projet et commencez le débogage.Build the project and start debugging. L’instance expérimentale s’affiche.The experimental instance appears. Si vous créez un nouveau fichier texte, une zone violette comportant un contour rouge s’affiche dans l’angle supérieur droit de la fenêtre d’affichage.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.

Créer une extension de margeCreate a margin extension

Le modèle de la marge de l’éditeur crée une marge verte s’affiche avec les mots *Hello world !The Editor Margin template creates a green margin that appears together with the words *Hello world! sous la barre de défilement horizontale.below the horizontal scroll bar.

Pour créer une extension de la marge en utilisant le modèle de la marge de l’éditeurTo create a margin extension by using the Editor Margin template

  1. Dans le nouveau projet boîte de dialogue, développez Visual C# ou Visual Basic puis cliquez sur extensibilité.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. Dans le modèles volet, sélectionnez projet VSIX.In the Templates pane, select VSIX Project. Dans la zone Nom, tapez MarginExtension.In the Name box, type MarginExtension. Cliquez sur OK.Click OK.

  2. Dans le l’Explorateur de solutions, cliquez sur le nœud du projet et sélectionnez ajouter > un nouvel élément.In the Solution Explorer, right-click the project node and select Add > New Item. Accédez à Visual c# extensibilité nœud et sélectionnez marge de l’éditeur.Go to the Visual C# Extensibility node and select Editor Margin. Laissez le nom de fichier par défaut (EditorMargin1.cs/vb).Leave the default file name (EditorMargin1.cs/vb).

  3. Il existe deux fichiers de code, comme suit :There are two code files, as follows:

    • EditorMargin1.cs contient la EditorMargin1 classe.EditorMargin1.cs contains the EditorMargin1 class.

    • EditorMargin1Factory.cs contient la EditorMargin1Factory classe.EditorMargin1Factory.cs contains the EditorMargin1Factory class.

  4. Générez ce projet et démarrer le débogage.Build this project and start debugging. L’instance expérimentale s’affiche.The experimental instance appears. Si vous ouvrez un fichier texte, une marge vert qui a les mots Hello EditorMargin1 s’affiche sous la barre de défilement horizontale.If you open a text file, a green margin that has the words Hello EditorMargin1 is displayed below the horizontal scroll bar.

Voir aussiSee also

Points d’extension éditeur et le service de langageLanguage service and editor extension points