Créer une extension avec un modèle d’élément d’éditeur

Vous pouvez utiliser des modèles d’élément inclus dans le Kit de développement logiciel (SDK) Visual Studio pour créer des extensions d’éditeur de base qui ajoutent des classifieurs, des ornements et des marges à l’éditeur. Les modèles d’élément d’éditeur sont disponibles pour les projets Visual C# ou Visual Basic VSIX.

Créer une extension classifieur

Le modèle d’élément Classifieur d’éditeur crée un classifieur d’éditeur qui colore le texte approprié (dans ce cas, tout) dans n’importe quel fichier texte.

  1. Dans la boîte de dialogue Nouveau projet , développez Visual C# ou Visual Basic , puis cliquez sur Extensibilité. Dans le volet Modèles , sélectionnez Projet VSIX. Dans le champ Nom, saisissez TestClassifier. Cliquez sur OK.

  2. Dans le Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet, puis sélectionnez Ajouter>un nouvel élément. Accédez au nœud d’extensibilité Visual C# et sélectionnez Classifieur de l’éditeur. Laissez le nom de fichier par défaut (EditorClassifier1.cs).

  3. Il existe quatre fichiers de code, comme suit :

    • EditorClassifier1.cs contient la EditorClassifier1 classe.

    • EditorClassifier1ClassificationDefinition.cs contient la EditorClassifier1ClassificationDefinition classe.

    • EditorClassifier1Format.cs contient la EditorClassifier1Format classe.

    • EditorClassifier1Provider.cs contient la EditorClassifier1Provider classe.

  4. Générez le projet et commencez le débogage. L’instance expérimentale de Visual Studio s’affiche.

    Si vous ouvrez un fichier texte, tout le texte est souligné sur un arrière-plan violet.

Créer une extension d’ornement relative de texte

Le modèle d’ornement de texte de l’éditeur crée un ornement relatif de texte 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. Il s’agit d’un texte relatif, car la zone superpose toujours les caractères « a », même lorsqu’ils sont déplacés ou reformatés.

  1. Dans la boîte de dialogue Nouveau projet , développez Visual C# ou Visual Basic , puis cliquez sur Extensibilité. Dans le volet Modèles , sélectionnez Projet VSIX. Dans le champ Nom, saisissez TestAdornment. Cliquez sur OK.

  2. Dans le Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet, puis sélectionnez Ajouter>un nouvel élément. Accédez au nœud d’extensibilité Visual C#, puis sélectionnez Ornement du texte de l’éditeur. Laissez le nom de fichier par défaut (TextAdornment1.cs/vb).

  3. Il existe deux fichiers de code, comme suit :

    • TextAdornment1.cs contient la TextAdornment1 classe.

    • TextAdornment1TextViewCreationListener.cs contient la TextAdornment1TextViewCreationListener classe.

  4. Générez le projet et commencez le débogage. L’instance expérimentale s’affiche. Si vous ouvrez un fichier texte, tous les caractères « a » du texte sont décrits en rouge sur un arrière-plan bleu.

Créer une extension d’ornement relative à la fenêtre d’affichage

Le modèle d’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 dans le coin supérieur droit de la fenêtre d’affichage.

Remarque

La fenêtre d’affichage est la zone de la vue de texte actuellement affichée.

Pour créer une extension d’ornement de fenêtre d’affichage à l’aide du modèle d’ornement de la fenêtre d’affichage de l’éditeur

  1. Dans la boîte de dialogue Nouveau projet , développez Visual C# ou Visual Basic , puis cliquez sur Extensibilité. Dans le volet Modèles , sélectionnez Projet VSIX. Dans le champ Nom, saisissez ViewportAdornment. Cliquez sur OK.

  2. Dans le Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet, puis sélectionnez Ajouter>un nouvel élément. Accédez au nœud d’extensibilité Visual C# et sélectionnez Ornement de la fenêtre d’affichage de l’éditeur. Laissez le nom de fichier par défaut (ViewportAdornment1.cs/vb).

  3. Il existe deux fichiers de code, comme suit :

    • ViewportAdornment1.cs contient la ViewportAdornment1 classe.

    • ViewportAdornment1TextViewCreationListener.cs contient la ViewportAdornment1TextViewCreationListener classe

  4. Générez le projet et commencez le débogage. L’instance expérimentale s’affiche. Si vous créez un fichier texte, une zone violette comportant un contour rouge s’affiche dans le coin supérieur droit de la fenêtre d’affichage.

Créer une extension de marge

Le modèle Marge de l’éditeur crée une marge verte qui apparaît avec les mots *Hello world ! sous la barre de défilement horizontale.

Pour créer une extension de marge à l’aide du modèle Marge de l’éditeur

  1. Dans la boîte de dialogue Nouveau projet , développez Visual C# ou Visual Basic , puis cliquez sur Extensibilité. Dans le volet Modèles , sélectionnez Projet VSIX. Dans le champ Nom, saisissez MarginExtension. Cliquez sur OK.

  2. Dans le Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet, puis sélectionnez Ajouter>un nouvel élément. Accédez au nœud d’extensibilité Visual C#, puis sélectionnez Marge de l’éditeur. Laissez le nom de fichier par défaut (EditorMargin1.cs/vb).

  3. Il existe deux fichiers de code, comme suit :

    • EditorMargin1.cs contient la EditorMargin1 classe.

    • EditorMargin1Factory.cs contient la EditorMargin1Factory classe.

  4. Générez ce projet et démarrez le débogage. L’instance expérimentale s’affiche. Si vous ouvrez un fichier texte, une marge verte contenant les mots Hello EditorMargin1 s’affiche sous la barre de défilement horizontale.