Freigeben über


Erstellen einer Erweiterung mit einer Editorelementvorlage

Sie können Elementvorlagen verwenden, die im Visual Studio SDK enthalten sind, um grundlegende Editorerweiterungen zu erstellen, die Klassifizierer, Schmücken und Seitenränder zum Editor hinzufügen. Die Editorelementvorlagen sind für Visual C#- oder Visual Basic VSIX-Projekte verfügbar.

Voraussetzungen

  • Visual Studio mit installierter Entwicklungsarbeitslast für Visual Studio-Erweiterungen.

Erstellen einer Klassifizierererweiterung

Die Editorklassifiziererelementvorlage erstellt einen Editorklassifizierer, der den entsprechenden Text (in diesem Fall alles) in einer beliebigen Textdatei farbt.

  1. Erstellen Sie ein neues Projekt mithilfe der VSIX-Projektvorlage . Nennen Sie es TestClassifier.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie "Neues Element> aus. Wenn ein kompaktes Fenster angezeigt wird, klicken Sie auf "Alle Vorlagen anzeigen". Wechseln Sie zum Visual C# -Erweiterungsknoten , und wählen Sie editor-Klassifizierer aus. Behalten Sie den Standarddateinamen (EditorClassifier1.cs) bei.

  3. Es gibt vier Codedateien, wie folgt:

    • EditorClassifier1.cs enthält die EditorClassifier1 Klasse.

    • EditorClassifier1ClassificationDefinition.cs enthält die EditorClassifier1ClassificationDefinition Klasse.

    • EditorClassifier1Format.cs enthält die EditorClassifier1Format Klasse.

    • EditorClassifier1Provider.cs enthält die EditorClassifier1Provider Klasse.

  4. Erstellen Sie das Projekt, und starten Sie das Debuggen. Die experimentelle Instanz von Visual Studio wird angezeigt.

    Wenn Sie eine Textdatei öffnen, wird der gesamte Text vor einem violetten Hintergrund unterstrichen.

Erstellen einer textrelativen Ziererweiterung

Die Vorlage "Editor Text Adornment" erstellt ein textrelatives Zierelement, das alle Instanzen des Textzeichens "a" mit einem Feld mit einem roten Umriss und einem blauen Hintergrund schmückt. Dies ist textabhängig, da das Feld immer die Buchstaben "a" überlagert, auch wenn diese verschoben oder neu formatiert werden.

  1. Erstellen Sie ein neues Projekt mithilfe der VSIX-Projektvorlage . Nennen Sie es TestAdornment.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie "Neues Element> aus. Wechseln Sie zum Visual C# Erweiterbarkeitsknoten und wählen Sie Editor-Textschmuck aus. Behalten Sie den Standarddateinamen (TextAdornment1.cs/vb) bei.

  3. Es gibt zwei Codedateien:

    • TextAdornment1.cs enthält die TextAdornment1 Klasse.

    • TextAdornment1TextViewCreationListener.cs enthält die TextAdornment1TextViewCreationListener Klasse.

  4. Erstellen Sie das Projekt, und starten Sie das Debuggen. Die experimentelle Instanz wird angezeigt. Wenn Sie eine Textdatei öffnen, werden alle 'a'-Zeichen im Text rot umrandet vor einem blauen Hintergrund dargestellt.

Erstellen einer viewportrelativen Ziererweiterung

Die Vorlage "Editor Viewport Adornment" erstellt ein viewportrelatives Zierelement, das ein violettes Feld mit einer roten Kontur zur oberen rechten Ecke des Viewports hinzufügt.

Hinweis

Der Viewport ist der Bereich der Textansicht, der derzeit angezeigt wird.

So erstellen Sie eine Viewport-Verzierungserweiterung mithilfe der Vorlage "Editor Viewport Adornment"

  1. Erstellen Sie ein neues Projekt mithilfe der VSIX-Projektvorlage . Nennen Sie es ViewportAdornment.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie "Neues Element> aus. Wechseln Sie zum Visual C# Erweiterbarkeit-Knoten und wählen Sie Editor Viewport Verzierung aus. Behalten Sie den Standarddateinamen (ViewportAdornment1.cs/vb) bei.

  3. Es gibt zwei Codedateien:

    • ViewportAdornment1.cs enthält die ViewportAdornment1 Klasse.

    • ViewportAdornment1TextViewCreationListener.cs enthält die ViewportAdornment1TextViewCreationListener Klasse

  4. Erstellen Sie das Projekt, und starten Sie das Debuggen. Die experimentelle Instanz wird angezeigt. Wenn Sie eine neue Textdatei erstellen, wird ein violettes Feld mit einer roten Kontur in der oberen rechten Ecke des Viewports angezeigt.

Erstellen Sie eine Seitenrand-Erweiterung

Die Vorlage "Editor Margin" erstellt einen grünen Rand, der zusammen mit den Wörtern *Hello world! unterhalb der horizontalen Bildlaufleiste angezeigt wird.

So erstellen Sie eine Margen-Erweiterung mithilfe der Editor-Margen-Vorlage

  1. Erstellen Sie ein neues Projekt mithilfe der VSIX-Projektvorlage . Nennen Sie es MarginExtension.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie "Neues Element> aus. Wechseln Sie zum Visual C# -Erweiterungsknoten , und wählen Sie "Editor-Rand" aus. Behalten Sie den Standarddateinamen (EditorMargin1.cs/vb) bei.

  3. Es gibt zwei Codedateien:

    • EditorMargin1.cs enthält die EditorMargin1 Klasse.

    • EditorMargin1Factory.cs enthält die EditorMargin1Factory Klasse.

  4. Erstellen Sie dieses Projekt, und starten Sie das Debuggen. Die experimentelle Instanz wird angezeigt. Wenn Sie eine Textdatei öffnen, wird unter der horizontalen Bildlaufleiste ein grüner Rand mit den Wörtern Hello EditorMargin1 angezeigt.