TextRanges-Schnittstelle

Enthält ein TextRange-Objekt für jeden der markierten Unterausdrücke aus einem Suchmuster.TextRanges wird auch für die Suche nach der Schnittmenge einer Feldauswahl mit den einzelnen Textzeilen verwendet.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
<GuidAttribute("B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")> _
Public Interface TextRanges _
    Inherits IEnumerable
[GuidAttribute("B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")]
public interface TextRanges : IEnumerable
[GuidAttribute(L"B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")]
public interface class TextRanges : IEnumerable
[<GuidAttribute("B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")>]
type TextRanges =  
    interface
        interface IEnumerable
    end
public interface TextRanges extends IEnumerable

Der TextRanges-Typ macht die folgenden Member verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Count Ruft einen Wert ab, der die Anzahl von Objekten in der Auflistung angibt.
Öffentliche Eigenschaft DTE Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
Öffentliche Eigenschaft Parent Ruft das unmittelbar übergeordnete Objekt einer TextRanges-Auflistung ab.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode GetEnumerator() Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
Öffentliche Methode GetEnumerator() Ruft eine Enumeration für Elemente in einer Auflistung ab.
Öffentliche Methode Item Gibt ein TextRange-Objekt in einer TextRanges-Auflistung zurück.

Zum Seitenanfang

Hinweise

Eine TextRanges-Auflistung wird bei einem Suchvorgang zurückgegeben, wenn das Suchmuster aus einem regulären Ausdruck mit markierten Unterausdrücken besteht.Die TextRanges-Auflistung enthält ein TextRange-Objekt für jeden markierten Unterausdruck.

TextRanges-Auflistungen werden außerdem verwendet, um Feldauswahlen vom TextSelection-Objekt abzurufen, wenn Sie nach der Schnittmenge der Feldauswahl mit den einzelnen Zeilen suchen.

Beispiele

Sub TextRangeExample(ByVal dte As EnvDTE.DTE)
    Dim objTxtSel As TextSelection
    Dim colRanges As TextRanges
    Dim objRange As TextRange
    Dim objEP As EditPoint

    objTxtSel = dte.ActiveDocument.Selection
    colRanges = objTxtSel.TextRanges
    For Each objRange In colRanges
        objRange.StartPoint.Insert("/*")
        objRange.EndPoint.Insert("*/")
    Next
End Sub
public void TextRangeExample(_DTE dte)
{
    TextSelection ts;
    TextRanges trs;

    ts = (TextSelection)dte.ActiveDocument.Selection;
    trs = ts.TextRanges;
    MessageBox.Show (trs.Count.ToString ());
    foreach (TextRange tr in trs)
    {
        tr.StartPoint.Insert ("/*");
        tr.EndPoint.Insert ("*/");
    }
}

Siehe auch

Referenz

EnvDTE-Namespace