TextRange-Schnittstelle

Artikel
10/24/2012

Stellt einen einzelnen, zusammenhängenden Textabschnitt in einem Textdokument dar.

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

Syntax

'Declaration
<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")> _
Public Interface TextRange

[GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface TextRange

[GuidAttribute(L"72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface class TextRange

[<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")>]
type TextRange =  interface end

public interface TextRange

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

Eigenschaften

	Name	Beschreibung
	Collection	Ruft die Auflistung mit dem TextRange-Objekt ab, das diese Eigenschaft unterstützt.
	DTE	Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
	EndPoint	Ruft einen EditPoint ab, der die Position am Ende des Bereichs angibt.
	StartPoint	Ruft das EditPoint-Objekt ab, das den Anfang des Textdokuments oder das erste im Bereich angezeigte Zeichen darstellt.

Zum Seitenanfang

Hinweise

Der Textabschnitt wird von zwei EditPoint-Objekten begrenzt.

TextRange-Objekte werden bei regulären Ausdrücken mit markierten Unterausdrücken verwendet.Eine Auflistung von Bereichen wird zurückgeben: ein Bereich je übereinstimmenden Unterausdruck. Die Eigenschaften dieser Bereiche sind schreibgeschützt.

Für die allgemeine Bearbeitung von Text wird empfohlen, stattdessen Objekte wie TextSelection oder EditPoint zu verwenden, da sich das TextSelection-Objekt direkt auf die auf dem Bildschirm sichtbare Auswahl bezieht.Beim Ändern des Auswahlbereichs werden auch die Objektkoordinaten geändert und umgekehrt.Daher kann eine Textauswahl nicht zur Darstellung eines beliebigen Textbereichs verwendet werden, ohne dass diese Textauswahl gleichzeitig aufgehoben wird.

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

Freigeben über