Création d’une Extension avec un éditeur de modèle d’élémentCreating an Extension with an Editor Item Template

Vous pouvez utiliser des modèles d’éléments qui sont inclus dans le SDK Visual Studio pour créer des extensions d’éditeur de base qui ajoutent des classifieurs, motifs 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 une 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 ultérieurement.You can also install the VS SDK later on. Pour plus d’informations, consultez l’installation de Visual Studio SDK.For more information, see Installing the Visual Studio SDK.

Création d’une Extension de classifieurCreating a Classifier Extension

Le modèle d’élément classifieur d’éditeur crée un classifieur d’éditeur qui le colore le texte approprié (dans ce cas, tous les éléments) dans un 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 / 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 trois fichiers de code, comme suit :There are three code files, as follows:

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

    • EditorClassifier1ClassificationDefinition.cs contient la OEditorClassifier1ClassificationDefinition classe.EditorClassifier1ClassificationDefinition.cs contains the OEditorClassifier1ClassificationDefinition 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é sur un arrière-plan violet.If you open a text file, all the text is underlined against a violet background.

Création d’une Extension d’ornement de texte RelativeCreating a Text-Relative Adornment Extension

Le modèle d’ornement de texte de l’éditeur crée un ornement de texte relatif qui décore toutes les instances du caractère du texte « a » à l’aide d’une zone avec 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 recouvre 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 / 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 de l’é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.

    • extAdornment1TextViewCreationListener.cs contient la TextAdornment1TextViewCreationListener classe.extAdornment1TextViewCreationListener.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 indiqués 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éation d’une Extension d’ornement de la fenêtre d’affichage RelativeCreating a Viewport-Relative Adornment Extension

Le modèle d’ornement de la fenêtre d’affichage de l’éditeur crée un ornement relatifs à la fenêtre d’affichage qui ajoute une zone violette avec 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 la fenêtre d’affichage est la zone de l’affichage de texte qui est actuellement affichée.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 d’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 / 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 de l’é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 avec 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éation d’une Extension de margeCreating 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 scrollbar.

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 / 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 de l’éditeur.Go to the Visual C# Extensibility node and select Editor Viewport Adornment. 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 verte qui comporte le mot « 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 scrollbar.

Voir aussiSee Also

Points d’extension du service de langage et de l’éditeurLanguage Service and Editor Extension Points