Share via


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.

Erstellen einer Klassifizierererweiterung

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

  1. Erweitern Sie im Dialogfeld "Neues Projekt" Visual C# oder Visual Basic, und klicken Sie dann auf "Erweiterbarkeit". Wählen Sie im Bereich "Vorlagen " die Option "VSIX-Projekt" aus. Geben Sie im Feld NameTestClassifierein. Klicken Sie auf OK.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie Hinzufügen>Neues Element aus. Wechseln Sie zum Visual C# -Erweiterungsknoten , und wählen Sie editor-Klassifizierer aus. Behalten Sie den Standarddateinamen bei (EditorClassifier1.cs).

  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 Debugging. 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 textrelativ, da das Feld immer die Zeichen "a" überlagert, auch wenn sie verschoben oder neu formatiert werden.

  1. Erweitern Sie im Dialogfeld "Neues Projekt" Visual C# oder Visual Basic, und klicken Sie dann auf "Erweiterbarkeit". Wählen Sie im Bereich "Vorlagen " die Option "VSIX-Projekt" aus. Geben Sie im Feld NameTestAdornmentein. Klicken Sie auf OK.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie Hinzufügen>Neues Element aus. Wechseln Sie zum Visual C# -Erweiterungsknoten , und wählen Sie "Editor-Textzierer" 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 Debugging. Die experimentelle Instanz wird geöffnet. Wenn Sie eine Textdatei öffnen, werden alle Zeichen im Text rot 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. Erweitern Sie im Dialogfeld "Neues Projekt" Visual C# oder Visual Basic, und klicken Sie dann auf "Erweiterbarkeit". Wählen Sie im Bereich "Vorlagen " die Option "VSIX-Projekt" aus. Geben Sie im Feld NameViewportAdornmentein. Klicken Sie auf OK.

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

  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 Debugging. Die experimentelle Instanz wird geöffnet. Wenn Sie eine neue Textdatei erstellen, wird ein violettes Feld mit einer roten Kontur in der oberen rechten Ecke des Viewports angezeigt.

Erstellen einer Seitenranderweiterung

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 Seitenranderweiterung mithilfe der Editor margin-Vorlage

  1. Erweitern Sie im Dialogfeld "Neues Projekt" Visual C# oder Visual Basic, und klicken Sie dann auf "Erweiterbarkeit". Wählen Sie im Bereich "Vorlagen " die Option "VSIX-Projekt" aus. Geben Sie im Feld NameMarginExtensionein. Klicken Sie auf OK.

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

  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 geöffnet. Wenn Sie eine Textdatei öffnen, wird unter der horizontalen Bildlaufleiste ein grüner Rand mit den Wörtern Hello EditorMargin1 angezeigt.