TextRange-Schnittstelle
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 | |
|---|---|---|
.gif "Öffentliche Eigenschaft") |
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 ("*/");
}
}