TextPoint Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Ort von Text in einem Textdokument dar.
public interface class TextPoint
public interface class TextPoint
__interface TextPoint
[System.Runtime.InteropServices.Guid("7F59E94E-4939-40D2-9F7F-B7651C25905D")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface TextPoint
[<System.Runtime.InteropServices.Guid("7F59E94E-4939-40D2-9F7F-B7651C25905D")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type TextPoint = interface
Public Interface TextPoint
- Abgeleitet
- Attribute
Beispiele
Sub TextPointExample()
' Comments a region of code.
Dim selection As TextSelection
selection = dte.ActiveDocument.selection()
Dim Start As Editpoint
Start = selection.TopPoint.CreateEditPoint()
Dim endpt As TextPoint endpt = selection.BottomPoint
Dim undoObj As UndoContext = dte.UndoContext
undoobj.Open("Comment Region")
Do While (Start.LessThan(endpt))
Start.Insert("//")
Start.LineDown()
Start.StartOfLine()
Loop
undoobj.Close()
End Sub
Hinweise
Mit dem- TextPoint Objekt können Sie Positionen in einem Dokument suchen. Mit den Eigenschaften des- TextPoint Objekts können Sie nach Text suchen, indem Sie Folgendes verwenden:
Zeilennummern
Zeichen Nummern in einer Zeile
Absolute Zeichen Positionen vom Anfang des Dokuments
Spalten anzeigen
TextPoint Objekte ähneln EditPoint Objekten, mit dem Unterschied, dass Sie Text verwenden, der in einem Code-Editor anstelle von Daten im Text Puffer angezeigt wird. Der Text in einem Dokument ist von globalen Editor Zuständen betroffen, z. b. durch die Wort Umbruch und virtuelle Leerzeichen, aber der Text Puffer ist nicht.
Wenn Sie ein Dokument bearbeiten, werden TextPoint Objekte nicht relativ zu dem umgebenden Text verschoben. Das heißt, wenn Text vor einem Textpunkt eingefügt wird, wird der Wert seiner- AbsoluteCharOffset Eigenschaft inkrementiert, um die neue Position weiter unten im Dokument widerzuspiegeln. Wenn sich mehrere TextPoint Objekte am gleichen Speicherort befinden und ein EditPoint Objekt zum Einfügen von neuem Text verwendet wird, werden die neuen Zeichen rechts von allen Objekten angezeigt, TextPoint mit Ausnahme derjenigen, die zum Einfügen des Texts verwendet wurde.
Jeder Vorgang, bei dem versucht wird, ein-Objekt zu ändern, TextDocument schlägt fehl, wenn der schreibgeschützt TextDocument ist.
Eigenschaften
| AbsoluteCharOffset |
Ruft das 1-basierte Zeichenoffset vom Anfang des Dokuments bis zum TextPoint-Objekt ab. |
| AtEndOfDocument |
Ruft ab, ob sich das Objekt am Ende des Dokuments befindet. |
| AtEndOfLine |
Ruft ab, ob sich das Objekt am Ende einer Zeile befindet. |
| AtStartOfDocument |
Ruft ab, ob sich das Objekt am Anfang des Dokuments befindet. |
| AtStartOfLine |
Ruft ab, ob sich das Objekt am Anfang einer Zeile befindet. |
| CodeElement[vsCMElement] |
Gibt das Codeelement zurück, das sich an der TextPoint-Position befindet. |
| DisplayColumn |
Ruft die Nummer der aktuell angezeigten Spalte ab, die das TextPoint-Objekt enthält. |
| DTE |
Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab. |
| Line |
Ruft die Zeilennummer des Objekts ab. |
| LineCharOffset |
Ruft den Zeichenoffset des Objekts ab. |
| LineLength |
Ruft die Anzahl der Zeichen in einer Zeile mit dem Objekt ab, wobei das Neue-Zeile-Zeichen nicht berücksichtigt wird. |
| Parent |
Ruft das unmittelbar übergeordnete Objekt eines TextPoint-Objekts ab. |
Methoden
| CreateEditPoint() |
Erstellt ein EditPoint-Objekt an der Position des aufrufenden Objekts und gibt es zurück. |
| EqualTo(TextPoint) |
Gibt zurück, ob der Wert der AbsoluteCharOffset-Eigenschaft des angegebenen Objekts größer ist als der des aufrufenden TextPoint-Objekts. |
| GreaterThan(TextPoint) |
Gibt an, ob der Wert der AbsoluteCharOffset-Eigenschaft des aufrufenden Objekts größer ist als der des angegebenen Point-Objekts. |
| LessThan(TextPoint) |
Gibt an, ob der Wert der AbsoluteCharOffset-Eigenschaft des aufgerufenen Objekts niedriger ist als der des angegebenen Objekts. |
| TryToShow(vsPaneShowHow, Object) |
Hiermit wird versucht, die Position des Textpunkts anzuzeigen. |