TextRange-Schnittstelle
Aktualisiert: November 2007
Stellt einen einzelnen, zusammenhängenden Textabschnitt in einem Textdokument dar.
Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Syntax
<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")> _
Public Interface TextRange
Dim instance As TextRange
[GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface TextRange
[GuidAttribute(L"72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface class TextRange
public interface TextRange
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 ("*/");
}
}