Interfaccia TextPoint

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rappresenta una posizione nel testo di un documento di testo.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")> _
Public Interface TextPoint

Dim instance As TextPoint

[GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface TextPoint

[GuidAttribute(L"7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface class TextPoint

public interface TextPoint

Note

L'oggetto TextPoint consente di trovare posizioni in un documento. Utilizzando le proprietà dell'oggetto TextPoint, è possibile trovare il testo in base a:

Numeri di riga
Numero di caratteri in una riga
Posizione assoluta dei caratteri dall'inizio del documento
Colonne visualizzate

Gli oggetti TextPoint sono simili agli oggetti EditPoint, con la differenza che opera sul testo visualizzato in un editor di codice anziché sui dati nel buffer di testo. Gli stati globali dell'editor, quali ritorno a capo automatico e spazi virtuali, influiscono sul testo di un documento, ma non sul buffer di testo.

Quando si modifica un documento, gli oggetti TextPoint non si spostano rispetto al testo che li circonda. Se viene inserito testo prima di un punto di inserimento, il valore della relativa proprietà AbsoluteCharOffset viene incrementato per riflettere la nuova posizione più in basso nel documento. Se più oggetti TextPoint si trovano nella stessa posizione e viene utilizzato un oggetto EditPoint per inserire nuovo testo, allora i nuovi caratteri si troveranno a destra di tutti gli oggetti TextPoint, tranne che di quello utilizzato per inserire il testo.

Qualsiasi operazione che cerca di modificare un oggetto TextDocument ha esito negativo se l'oggetto TextDocument è in sola lettura.

Esempi

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 TextPointendpt = 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

Vedere anche

Riferimenti

Membri TextPoint

Spazio dei nomi EnvDTE

Condividi tramite