TextPoint Schnittstelle

Definition

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.

Gilt für