Interfaccia TextPoint

Rappresenta una posizione nel testo di un documento di testo.

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

Sintassi

'Dichiarazione
<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")> _
Public Interface TextPoint
[GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface TextPoint
[GuidAttribute(L"7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface class TextPoint
[<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")>]
type TextPoint =  interface end
public interface TextPoint

Il tipo TextPoint espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica AbsoluteCharOffset Ottiene l'offset carattere in base 1 a partire dall'inizio del documento fino all'oggetto TextPoint.
Proprietà pubblica AtEndOfDocument Ottiene un valore che indica se l'oggetto si trova alla fine del documento.
Proprietà pubblica AtEndOfLine Ottiene un valore che indica se l'oggetto si trova alla fine di una riga.
Proprietà pubblica AtStartOfDocument Ottiene un valore che indica se l'oggetto si trova all'inizio del documento.
Proprietà pubblica AtStartOfLine Ottiene un valore che indica se l'oggetto si trova all'inizio di una riga.
Proprietà pubblica CodeElement Restituisce l'elemento di codice nella posizione di TextPoint.
Proprietà pubblica DisplayColumn Ottiene il numero della colonna attualmente visualizzata contenente l'oggetto TextPoint.
Proprietà pubblica DTE Ottiene l'oggetto di estensibilità di primo livello.
Proprietà pubblica Line Ottiene il numero di riga dell'oggetto.
Proprietà pubblica LineCharOffset Ottiene l'offset carattere dell'oggetto.
Proprietà pubblica LineLength Ottiene il numero di caratteri di una riga contenente l'oggetto, escluso il carattere di nuova riga.
Proprietà pubblica Parent Ottiene l'oggetto padre di un oggetto TextPoint.

In alto

Metodi

  Nome Descrizione
Metodo pubblico CreateEditPoint Crea e restituisce un oggetto EditPoint in corrispondenza della posizione dell'oggetto chiamante.
Metodo pubblico EqualTo Restituisce un valore che indica se il valore della proprietà AbsoluteCharOffset dell'oggetto specificato è uguale a quella dell'oggetto TextPoint chiamante.
Metodo pubblico GreaterThan Indica se il valore della proprietà AbsoluteCharOffset dell'oggetto chiamante è maggiore del valore dell'oggetto specificato.
Metodo pubblico LessThan Indica se il valore della proprietà AbsoluteCharOffset dell'oggetto chiamato è minore del valore dell'oggetto specificato.
Metodo pubblico TryToShow Esegue il tentativo di visualizzare la posizione del punto di inserimento.

In alto

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

Vedere anche

Riferimenti

Spazio dei nomi EnvDTE