Partager via

Procédure pas - à - pas : afficher l'accolade correspondante

  • Article

Vous pouvez implémenter les fonctionnalités basées sur un langage telles que les accolades correspondantes en définissant l'accolade que vous souhaitez faire correspondre, puis ajouter une balise de marqueur de texte à les accolades correspondantes lorsque le signe insertion est sur un d'accolades. Vous pouvez définir des accolades dans le contexte d'un langage, ou vous pouvez définir votre propre extension de nom de fichier et type de contenu et appliquer les balises uniquement à ce type, ou vous pouvez appliquer des balises à un type de contenu existant (tel que « texte »). La procédure pas - à - pas suivante montre comment appliquer des accolades correspondantes au type de contenu de « texte ».

Composants requis

Pour exécuter cette procédure, vous devez installer Kit de développement logiciel Visual Studio 2010.

Notes

Pour plus d'informations sur le kit de développement Visual Studio, consultez Étendre la présentation de Visual Studio.Pour savoir comment télécharger le kit de développement Visual Studio, consultez Visual Studio Extensibility Developer Center sur le site Web MSDN.

Créer un projet managé (MEF) managed extensibility framework

Pour créer un projet MEF

  1. Créez un projet de classifieur d'éditeur. nommez la solution BraceMatchingTest.

  2. Ouvrez le fichier source.extension.vsixmanifest dans l'éditeur de manifeste VSIX.

  3. Assurez -vous que le titre d' Content contient un type de contenu composant MEF et qu' Path est défini à BraceMatchingTest.dll.

  4. Enregistrez et fermez le fichier Source.extension.vsixmanifest.

  5. supprimez les fichiers de classe existants.

Implémenter un balises correspondant d'accolade

Pour obtenir une accolade mise en surbrillance l'effet qui ressemble à celui utilisé dans Visual Studio, vous pouvez implémenter un balises de type TextMarkerTag. Le code suivant montre comment définir le balises pour les paires d'accolades à tout niveau d'imbrication. dans cet exemple, l'accolade couple []. [out], et {} sont définis dans le constructeur de balises, mais dans une implémentation complète de langage les paires appropriées d'accolades serait définie dans la spécification du langage.

Pour implémenter un balises correspondant d'accolade

  1. ajoutez un fichier de classe et nommez-le BraceMatching.

  2. importez les espaces de noms suivants.

    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. définissez une classe BraceMatchingTagger qui hérite d' ITagger de type TextMarkerTag.

    Friend Class BraceMatchingTagger
    Implements ITagger(Of TextMarkerTag)

    internal class BraceMatchingTagger : ITagger<TextMarkerTag>

  4. Ajoutez des propriétés pour l'affichage de texte, la mémoire tampon source, et le point d'instantané actuel, et également un ensemble de paires d'accolades.

    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. Dans le constructeur de balises, définissez les propriétés et abonnez -vous aux événements PositionChanged et LayoutChangedde modification de l'affichage. Dans cet exemple, à des fins de illustration, les paires correspondantes sont également définies dans le constructeur.

    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. Dans le cadre de l'implémentation d' ITagger , déclarez un événement TagsChanged.

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

    public event EventHandler<SnapshotSpanEventArgs> TagsChanged;

  7. Les gestionnaires d'événements mettre à jour l'emplacement actuel du signe insertion de la propriété d' CurrentChar et déclenchent l'événement TagsChanged.

    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. Implémentez la méthode d' GetTags pour correspondre à l'accolade l'un ou l'autre lorsque le caractère actuel est une accolade ouvrante ou lorsque le caractère précédent est une accolade proche, comme dans Visual Studio. Lorsque la correspondance est trouvée, les instanciés de cette méthode deux balises, une pour l'accolade ouvrante et une pour les accolades proche.

    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. Les méthodes privées suivantes permettent de trouver l'accolade correspondante à tout niveau d'imbrication. La première méthode recherche le caractère proche qui correspond au caractère ouvert :

    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. La méthode d'assistance suivante recherche le caractère ouvert qui correspond à un caractère proche :

    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;
}

Implémenter un fournisseur correspondant de balises d'accolades

En plus de l'implémentation un balises, vous devez également implémenter et exporter un fournisseur de balises. dans ce cas, le type de contenu du fournisseur est « texte ». Cela signifie que les accolades correspondantes s'affichera dans tous les types de fichiers texte, mais une implémentation plus intégrale appliquerait l'accolade correspondant à un seul type de contenu spécifique.

Pour implémenter un fournisseur correspondant de balises d'accolades

  1. Déclarez un fournisseur de balises qui hérite d' IViewTaggerProvider, le nom BraceMatchingTaggerProvider, et l'exportation avec ContentTypeAttribute « texte » et TagTypeAttribute d' 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. Implémentez la méthode d' CreateTagger``1 pour instancier un BraceMatchingTagger.

    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>;
}

Génération et test de code

Pour tester ce code, générez la solution de BraceMatchingTest et exécutez -la dans l'instance expérimentale.

Pour générer et tester la solution de BraceMatchingTest

  1. Générez la solution.

  2. Lorsque vous exécutez ce projet dans le débogueur, une deuxième instance de Visual Studio est instanciée.

  3. Créez un fichier texte et tapez du texte qui inclut l'accolade correspondante.

    hello {
goodbye}

{}

{hello}

  4. Lorsque vous positionnez le signe insertion avant une accolade ouvrante, chacune attachent et les accolades proche correspondante doivent être mis en surbrillance. Lorsque vous positionnez le curseur immédiatement après l'accolade proche, chacune attachent et l'accolade ouvrante correspondant doit être mis en surbrillance.

Voir aussi

Tâches

Procédure pas - à - pas : lier un type de contenu à une extension de nom de fichier