Freigeben über

Exemplarische Vorgehensweise: Übereinstimmende geschweifte Klammern angezeigt werden

  • Artikel

Sie können LANGUAGE-basierte Funktionen, z. B. geschweifte Klammer implementieren, indem Sie die geschweiften Klammern entspricht, die Sie definieren, finden möchten, und dann ein Textmarkierungs tag auf passende Klammern hinzu, wenn die Einfügemarke an einer der Klammern ist. Sie können geschweifte Klammern innerhalb des Bereichs einer Sprache definieren, oder Sie können definieren, Erweiterung und Inhaltstyp besitzen und die Tags für diesen Typ zuweisen, oder Sie können die Tags zu einem vorhandenen Inhaltstyp anwenden (z. B. „text“). Die folgenden exemplarischen Vorgehensweise wird veranschaulicht, wie mit übereinstimmenden Tags von Klammern um „Text“ Inhaltstyp anwendet.

Vorbereitungsmaßnahmen

Zum Abschließen dieser exemplarischen Vorgehensweise müssen Sie Visual Studio 2010 SDKinstallieren.

Hinweis

Weitere Informationen über das Visual Studio-SDK finden Sie unter Erweitern von Visual Studio Overview.Um herauszufinden finden Sie unter wie das Visual Studio-SDK, auf Visual Studio Extensibility Developer Center der MSDN-Website herunterlädt.

Ein Projekt des Managed Extensibility Framework (MEF)

So erstellen Sie ein MEF-Projekt

  1. Erstellen Sie ein Projekt Editor-Klassifizierungs. Geben Sie der Projektmappe BraceMatchingTest.

  2. Öffnen Sie die Datei source.extension.vsixmanifest im VSIX-Manifest-Editor.

  3. Überprüfen Sie, ob die Content Überschrift einen MEF-Komponenten-Inhaltstyp enthält und dass Path zu BraceMatchingTest.dll festgelegt ist.

  4. Speichern und schließen Sie Source.extension.vsixmanifest.

  5. Löschen Sie die vorhandenen Klassendateien.

Erstellen eines entsprechenden Tagger Implementieren von Klammern

Um einen effekt Hervorhebung von Klammern ähnelt dem der abzurufenden in Visual Studio verwendet wird, können Sie einen Tagger des Typs TextMarkerTagimplementieren. Der folgende Code zeigt, wie der Tagger für Paare von Klammern für eine beliebige Schachtelungsebene definiert. In diesem Beispiel die Paare von Klammern []. [] {} und im Tagger Konstruktor definiert, aber in einer vollständigen Sprachen Implementierung die relevanten Paare von Klammern wäre definiert in der Spezifikation für Sprachen.

Um einen übereinstimmenden Tagger Implementieren von Klammern

  1. Fügen Sie eine Klassendatei hinzu, und nennen Sie sie BraceMatching.

  2. Importieren Sie die folgenden Namespaces.

    Imports System.ComponentModel.Composition
Imports Microsoft.VisualStudio.Text
Imports Microsoft.VisualStudio.Text.Editor
Imports Microsoft.VisualStudio.Text.Tagging
Imports Microsoft.VisualStudio.Utilities

    using System;
using System.Linq;
using System.Collections.Generic;
using System.ComponentModel.Composition;
using Microsoft.VisualStudio.Text;
using Microsoft.VisualStudio.Text.Editor;
using Microsoft.VisualStudio.Text.Tagging;
using Microsoft.VisualStudio.Utilities;

  3. Definieren Sie eine Klasse, die von BraceMatchingTaggerITagger des Typs TextMarkerTagerbt.

    Friend Class BraceMatchingTagger
    Implements ITagger(Of TextMarkerTag)

    internal class BraceMatchingTagger : ITagger<TextMarkerTag>

  4. Hinzufügen von Eigenschaften für die Textansicht, der als Quellpuffer bezeichnet, und der aktuelle Momentaufnahmepunkt und außerdem ein Satz von Paaren von Klammern hinzu.

    Private _View As ITextView
Private Property View() As ITextView
    Get 
        Return _View
    End Get 
    Set(ByVal value As ITextView)
        _View = value
    End Set 
End Property 
Private _SourceBuffer As ITextBuffer
Private Property SourceBuffer() As ITextBuffer
    Get 
        Return _SourceBuffer
    End Get 
    Set(ByVal value As ITextBuffer)
        _SourceBuffer = value
    End Set 
End Property 
Private _CurrentChar As System.Nullable(Of SnapshotPoint)
Private Property CurrentChar() As System.Nullable(Of SnapshotPoint)
    Get 
        Return _CurrentChar
    End Get 
    Set(ByVal value As System.Nullable(Of SnapshotPoint))
        _CurrentChar = value
    End Set 
End Property 
Private m_braceList As Dictionary(Of Char, Char)

    ITextView View { get; set; }
ITextBuffer SourceBuffer { get; set; }
SnapshotPoint? CurrentChar { get; set; }
private Dictionary<char, char> m_braceList;

  5. Im Tagger Konstruktors legen Sie die Eigenschaften fest, und abonnieren Sie Ereignisse und PositionChanged Änderung der Ansicht den LayoutChanged. In diesem Beispiel zur Veranschaulichung werden die übereinstimmenden Paare auch im Konstruktor definiert.

    Friend Sub New(ByVal view As ITextView, ByVal sourceBuffer As ITextBuffer)
    'here the keys are the open braces, and the values are the close braces
    m_braceList = New Dictionary(Of Char, Char)()
    m_braceList.Add("{"c, "}"c)
    m_braceList.Add("["c, "]"c)
    m_braceList.Add("("c, ")"c)
    Me.View = view
    Me.SourceBuffer = sourceBuffer
    Me.CurrentChar = Nothing 

    AddHandler Me.View.Caret.PositionChanged, AddressOf Me.CaretPositionChanged
    AddHandler Me.View.LayoutChanged, AddressOf Me.ViewLayoutChanged
End Sub

    internal BraceMatchingTagger(ITextView view, ITextBuffer sourceBuffer)
{
    //here the keys are the open braces, and the values are the close braces
    m_braceList = new Dictionary<char, char>();
    m_braceList.Add('{', '}');
    m_braceList.Add('[', ']');
    m_braceList.Add('(', ')');
    this.View = view;
    this.SourceBuffer = sourceBuffer;
    this.CurrentChar = null;

    this.View.Caret.PositionChanged += CaretPositionChanged;
    this.View.LayoutChanged += ViewLayoutChanged;
}

  6. Gemäß der Implementierung ITagger deklarieren Sie ein TagsChanged-Ereignis.

    Public Event TagsChanged As EventHandler(Of SnapshotSpanEventArgs) _
    Implements ITagger(Of TextMarkerTag).TagsChanged

    public event EventHandler<SnapshotSpanEventArgs> TagsChanged;

  7. Die Ereignishandler aktualisiert die aktuelle Position der Einfügemarke der CurrentChar-Eigenschaft und lösen das TagsChanged-Ereignis aus.

    Private Sub ViewLayoutChanged(ByVal sender As Object, ByVal e As TextViewLayoutChangedEventArgs)
    If e.NewSnapshot IsNot e.OldSnapshot Then 
        'make sure that there has really been a change
        UpdateAtCaretPosition(View.Caret.Position)
    End If 
End Sub 

Private Sub CaretPositionChanged(ByVal sender As Object, ByVal e As CaretPositionChangedEventArgs)
    UpdateAtCaretPosition(e.NewPosition)
End Sub 

Private Sub UpdateAtCaretPosition(ByVal caretPosition As CaretPosition)
    CurrentChar = caretPosition.Point.GetPoint(SourceBuffer, caretPosition.Affinity)

    If Not CurrentChar.HasValue Then 
        Exit Sub 
    End If 

    RaiseEvent TagsChanged(Me, New SnapshotSpanEventArgs(New SnapshotSpan(SourceBuffer.CurrentSnapshot, 0, SourceBuffer.CurrentSnapshot.Length)))
End Sub

    void ViewLayoutChanged(object sender, TextViewLayoutChangedEventArgs e)
{
    if (e.NewSnapshot != e.OldSnapshot) //make sure that there has really been a change
    {
        UpdateAtCaretPosition(View.Caret.Position);
    }
}

void CaretPositionChanged(object sender, CaretPositionChangedEventArgs e)
{
    UpdateAtCaretPosition(e.NewPosition);
}
void UpdateAtCaretPosition(CaretPosition caretPosition)
{
    CurrentChar = caretPosition.Point.GetPoint(SourceBuffer, caretPosition.Affinity);

    if (!CurrentChar.HasValue)
        return;

    var tempEvent = TagsChanged;
    if (tempEvent != null)
        tempEvent(this, new SnapshotSpanEventArgs(new SnapshotSpan(SourceBuffer.CurrentSnapshot, 0,
            SourceBuffer.CurrentSnapshot.Length)));
}

  8. Implementieren Sie die GetTags-Methode, um Übereinstimmung mit geschweiften Klammern ein, wenn das aktuelle Zeichen eine öffnende geschweifte Klammer ist oder wenn das vorherige Zeichen der schließenden geschweiften Klammer wird wie in Visual Studio. Wenn die Übereinstimmung gefunden wurde, instanziiert diese Methode zwei Tage; für die öffnende geschweifte Klammer und eine für die nah geschweifte Klammer.

    Public Function GetTags(ByVal spans As NormalizedSnapshotSpanCollection) As IEnumerable(Of ITagSpan(Of TextMarkerTag)) Implements ITagger(Of Microsoft.VisualStudio.Text.Tagging.TextMarkerTag).GetTags
    If spans.Count = 0 Then 
        'there is no content in the buffer 
        Exit Function 
    End If 

    'don't do anything if the current SnapshotPoint is not initialized or at the end of the buffer 
    If Not CurrentChar.HasValue OrElse CurrentChar.Value.Position >= CurrentChar.Value.Snapshot.Length Then 
        Exit Function 
    End If 

    'hold on to a snapshot of the current character 
    Dim currentChar__1 As SnapshotPoint = CurrentChar.Value

    'if the requested snapshot isn't the same as the one the brace is on, translate our spans to the expected snapshot 
    If spans(0).Snapshot IsNot currentChar__1.Snapshot Then
        currentChar__1 = currentChar__1.TranslateTo(spans(0).Snapshot, PointTrackingMode.Positive)
    End If 

    'get the current char and the previous char 
    Dim currentText As Char = currentChar__1.GetChar()
    Dim lastChar As SnapshotPoint = If(CInt(currentChar__1) = 0, currentChar__1, currentChar__1 - 1)
    'if currentChar is 0 (beginning of buffer), don't move it back 
    Dim lastText As Char = lastChar.GetChar()
    Dim pairSpan As New SnapshotSpan()

    If m_braceList.ContainsKey(currentText) Then 
        'the key is the open brace 
        Dim closeChar As Char
        m_braceList.TryGetValue(currentText, closeChar)
        If BraceMatchingTagger.FindMatchingCloseChar(currentChar__1, currentText, closeChar, View.TextViewLines.Count, pairSpan) = True Then 
            Exit Function 
        End If 
    ElseIf m_braceList.ContainsValue(lastText) Then 
        'the value is the close brace, which is the *previous* character  
        Dim open = From n In m_braceList _
            Where n.Value.Equals(lastText) _
            Select n.Key
        If BraceMatchingTagger.FindMatchingOpenChar(lastChar, CChar(open.ElementAt(0)), lastText, View.TextViewLines.Count, pairSpan) = True Then 
            Exit Function 
        End If 
    End If 
End Function

    public IEnumerable<ITagSpan<TextMarkerTag>> GetTags(NormalizedSnapshotSpanCollection spans)
{
    if (spans.Count == 0)   //there is no content in the buffer 
        yield break;

    //don't do anything if the current SnapshotPoint is not initialized or at the end of the buffer 
    if (!CurrentChar.HasValue || CurrentChar.Value.Position >= CurrentChar.Value.Snapshot.Length)
        yield break;

    //hold on to a snapshot of the current character
    SnapshotPoint currentChar = CurrentChar.Value;

    //if the requested snapshot isn't the same as the one the brace is on, translate our spans to the expected snapshot 
    if (spans[0].Snapshot != currentChar.Snapshot)
    {
        currentChar = currentChar.TranslateTo(spans[0].Snapshot, PointTrackingMode.Positive);
    }

    //get the current char and the previous char 
    char currentText = currentChar.GetChar();
    SnapshotPoint lastChar = currentChar == 0 ? currentChar : currentChar - 1; //if currentChar is 0 (beginning of buffer), don't move it back 
    char lastText = lastChar.GetChar();
    SnapshotSpan pairSpan = new SnapshotSpan();

    if (m_braceList.ContainsKey(currentText))   //the key is the open brace
    {
        char closeChar;
        m_braceList.TryGetValue(currentText, out closeChar);
        if (BraceMatchingTagger.FindMatchingCloseChar(currentChar, currentText, closeChar, View.TextViewLines.Count, out pairSpan) == true)
        {
            yield return new TagSpan<TextMarkerTag>(new SnapshotSpan(currentChar, 1), new TextMarkerTag("blue"));
            yield return new TagSpan<TextMarkerTag>(pairSpan, new TextMarkerTag("blue"));
        }
    }
    else if (m_braceList.ContainsValue(lastText))    //the value is the close brace, which is the *previous* character 
    {
        var open = from n in m_braceList
                   where n.Value.Equals(lastText)
                   select n.Key;
        if (BraceMatchingTagger.FindMatchingOpenChar(lastChar, (char)open.ElementAt<char>(0), lastText, View.TextViewLines.Count, out pairSpan) == true)
        {
            yield return new TagSpan<TextMarkerTag>(new SnapshotSpan(lastChar, 1), new TextMarkerTag("blue"));
            yield return new TagSpan<TextMarkerTag>(pairSpan, new TextMarkerTag("blue"));
        }
    }
}

  9. Die folgenden privaten Methode sucht die übereinstimmende geschweifte Klammer für eine beliebige Schachtelungsebene. Die erste Methode sucht das Nähe von Zeichen, das das geöffnete Zeichen entspricht:

    Private Shared Function FindMatchingCloseChar(ByVal startPoint As SnapshotPoint, ByVal open As Char, ByVal close As Char, ByVal maxLines As Integer, ByRef pairSpan As SnapshotSpan) As Boolean
    pairSpan = New SnapshotSpan(startPoint.Snapshot, 1, 1)
    Dim line As ITextSnapshotLine = startPoint.GetContainingLine()
    Dim lineText As String = line.GetText()
    Dim lineNumber As Integer = line.LineNumber
    Dim offset As Integer = startPoint.Position - line.Start.Position + 1

    Dim stopLineNumber As Integer = startPoint.Snapshot.LineCount - 1
    If maxLines > 0 Then
        stopLineNumber = Math.Min(stopLineNumber, lineNumber + maxLines)
    End If 

    Dim openCount As Integer = 0
    While True 
        'walk the entire line 
        While offset < line.Length
            Dim currentChar As Char = lineText(offset)
            If currentChar = close Then 
                'found the close character 
                If openCount > 0 Then
                    openCount -= 1
                Else 
                    'found the matching close
                    pairSpan = New SnapshotSpan(startPoint.Snapshot, line.Start + offset, 1)
                    Return True 
                End If 
            ElseIf currentChar = open Then 
                ' this is another open
                openCount += 1
            End If
            offset += 1
        End While 

        'move on to the next line 
        If System.Threading.Interlocked.Increment(lineNumber) > stopLineNumber Then 
            Exit While 
        End If

        line = line.Snapshot.GetLineFromLineNumber(lineNumber)
        lineText = line.GetText()
        offset = 0
    End While 

    Return False 
End Function

    private static bool FindMatchingCloseChar(SnapshotPoint startPoint, char open, char close, int maxLines, out SnapshotSpan pairSpan)
{
    pairSpan = new SnapshotSpan(startPoint.Snapshot, 1, 1);
    ITextSnapshotLine line = startPoint.GetContainingLine();
    string lineText = line.GetText();
    int lineNumber = line.LineNumber;
    int offset = startPoint.Position - line.Start.Position + 1;

    int stopLineNumber = startPoint.Snapshot.LineCount - 1;
    if (maxLines > 0)
        stopLineNumber = Math.Min(stopLineNumber, lineNumber + maxLines);

    int openCount = 0;
    while (true)
    {
        //walk the entire line 
        while (offset < line.Length)
        {
            char currentChar = lineText[offset];
            if (currentChar == close) //found the close character
            {
                if (openCount > 0)
                {
                    openCount--;
                }
                else     //found the matching close
                {
                    pairSpan = new SnapshotSpan(startPoint.Snapshot, line.Start + offset, 1);
                    return true;
                }
            }
            else if (currentChar == open) // this is another open
            {
                openCount++;
            }
            offset++;
        }

        //move on to the next line 
        if (++lineNumber > stopLineNumber)
            break;

        line = line.Snapshot.GetLineFromLineNumber(lineNumber);
        lineText = line.GetText();
        offset = 0;
    }

    return false;
}

  10. Die folgende Hilfsmethode sucht das geöffnete Zeichen, das ein nahes Zeichen entspricht:

    Private Shared Function FindMatchingOpenChar(ByVal startPoint As SnapshotPoint, ByVal open As Char, ByVal close As Char, ByVal maxLines As Integer, ByRef pairSpan As SnapshotSpan) As Boolean
    pairSpan = New SnapshotSpan(startPoint, startPoint)

    Dim line As ITextSnapshotLine = startPoint.GetContainingLine()

    Dim lineNumber As Integer = line.LineNumber
    Dim offset As Integer = startPoint - line.Start - 1
    'move the offset to the character before this one 
    'if the offset is negative, move to the previous line 
    If offset < 0 Then
        line = line.Snapshot.GetLineFromLineNumber(System.Threading.Interlocked.Decrement(lineNumber))
        offset = line.Length - 1
    End If 

    Dim lineText As String = line.GetText()

    Dim stopLineNumber As Integer = 0
    If maxLines > 0 Then
        stopLineNumber = Math.Max(stopLineNumber, lineNumber - maxLines)
    End If 

    Dim closeCount As Integer = 0

    While True 
        ' Walk the entire line 
        While offset >= 0
            Dim currentChar As Char = lineText(offset)

            If currentChar = open Then 
                If closeCount > 0 Then
                    closeCount -= 1
                Else 
                    ' We've found the open character
                    pairSpan = New SnapshotSpan(line.Start + offset, 1)
                    'we just want the character itself 
                    Return True 
                End If 
            ElseIf currentChar = close Then
                closeCount += 1
            End If
            offset -= 1
        End While 

        ' Move to the previous line 
        If System.Threading.Interlocked.Decrement(lineNumber) < stopLineNumber Then 
            Exit While 
        End If

        line = line.Snapshot.GetLineFromLineNumber(lineNumber)
        lineText = line.GetText()
        offset = line.Length - 1
    End While 
    Return False 
End Function

    private static bool FindMatchingOpenChar(SnapshotPoint startPoint, char open, char close, int maxLines, out SnapshotSpan pairSpan)
{
    pairSpan = new SnapshotSpan(startPoint, startPoint);

    ITextSnapshotLine line = startPoint.GetContainingLine();

    int lineNumber = line.LineNumber;
    int offset = startPoint - line.Start - 1; //move the offset to the character before this one 

    //if the offset is negative, move to the previous line 
    if (offset < 0)
    {
        line = line.Snapshot.GetLineFromLineNumber(--lineNumber);
        offset = line.Length - 1;
    }

    string lineText = line.GetText();

    int stopLineNumber = 0;
    if (maxLines > 0)
        stopLineNumber = Math.Max(stopLineNumber, lineNumber - maxLines);

    int closeCount = 0;

    while (true)
    {
        // Walk the entire line 
        while (offset >= 0)
        {
            char currentChar = lineText[offset];

            if (currentChar == open)
            {
                if (closeCount > 0)
                {
                    closeCount--;
                }
                else // We've found the open character
                {
                    pairSpan = new SnapshotSpan(line.Start + offset, 1); //we just want the character itself 
                    return true;
                }
            }
            else if (currentChar == close)
            {
                closeCount++;
            }
            offset--;
        }

        // Move to the previous line 
        if (--lineNumber < stopLineNumber)
            break;

        line = line.Snapshot.GetLineFromLineNumber(lineNumber);
        lineText = line.GetText();
        offset = line.Length - 1;
    }
    return false;
}

Erstellen eines entsprechenden Tagger-Anbieter Implementieren von Klammern

Zusätzlich zum Implementieren eines Taggers, müssen Sie einen Anbieter Tagger ebenfalls implementieren und exportieren. In diesem Fall ist der Inhaltstyp des Anbieters „Text“. Dies bedeutet, dass die Zuordnung von Klammern in allen Typen von Textdateien angezeigt, das eine vollere Implementierung würde die öffnende geschweifte Klammer anwenden, die nur für einen bestimmten Inhaltstyp entspricht.

Um einen übereinstimmenden Tagger Textanbieter Implementieren von Klammern

  1. Deklarieren Sie Tagger einen Anbieter, der von IViewTaggerProvidererbt, geben Sie dieser BraceMatchingTaggerProvider exportieren und ihn mit ContentTypeAttribute „des Texts“ und TagTypeAttribute von TextMarkerTag.

    <Export(GetType(IViewTaggerProvider))> _
<ContentType("text")> _
<TagType(GetType(TextMarkerTag))> _
Friend Class BraceMatchingTaggerProvider
    Implements IViewTaggerProvider

    [Export(typeof(IViewTaggerProvider))]
[ContentType("text")]
[TagType(typeof(TextMarkerTag))]
internal class BraceMatchingTaggerProvider : IViewTaggerProvider

  2. Implementieren Sie die CreateTagger``1-Methode, um ein BraceMatchingTagger zu instanziieren.

    Public Function CreateTagger(Of T As ITag)(ByVal textView As ITextView, ByVal buffer As ITextBuffer) As ITagger(Of T) Implements IViewTaggerProvider.CreateTagger
    If textView Is Nothing Then 
        Return Nothing 
    End If 

    'provide highlighting only on the top-level buffer 
    If textView.TextBuffer IsNot buffer Then 
        Return Nothing 
    End If 

    Return TryCast(New BraceMatchingTagger(textView, buffer), ITagger(Of T))
End Function

    public ITagger<T> CreateTagger<T>(ITextView textView, ITextBuffer buffer) where T : ITag
{
    if (textView == null)
        return null;

    //provide highlighting only on the top-level buffer 
    if (textView.TextBuffer != buffer)
        return null;

    return new BraceMatchingTagger(textView, buffer) as ITagger<T>;
}

Erstellen und Testen von Code

Um diesen Code zu testen, erstellen Sie die BraceMatchingTest-Projektmappe und führen Sie sie in der experimentellen Instanz aus.

So erstellen und testen BraceMatchingTest-Projektmappe

  1. Erstellen Sie die Projektmappe.

  2. Wenn Sie dieses Projekt im Debugger ausführen, wird eine zweite Instanz von Visual Studio instanziiert.

  3. Erstellen Sie eine Textdatei, und geben Sie Text ein, der übereinstimmende geschweifte Klammern enthält.

    hello {
goodbye}

{}

{hello}

  4. Wenn Sie die Einfügemarke vor einer schließenden geschweiften Klammer links positionieren, sollten beide, die abstützen Nähe und die übereinstimmende geschweifte Klammer hervorgehoben werden. Wenn Sie den Cursor nach der gleich der Nähe geschweifte Klammer setzen sowohl die abstützen und die übereinstimmende geschweifte Klammer sollte hervorgehoben werden.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Verknüpfen einer Dateinamenerweiterung eines Inhaltstyps