Interfaccia TextPoint

Articolo
08/11/2011

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

In alto

Metodi

	Nome	Descrizione
	CreateEditPoint	Crea e restituisce un oggetto EditPoint in corrispondenza della posizione dell'oggetto chiamante.
	EqualTo	Restituisce un valore che indica se il valore della proprietà AbsoluteCharOffset dell'oggetto specificato è uguale a quella dell'oggetto TextPoint chiamante.
	GreaterThan	Indica se il valore della proprietà AbsoluteCharOffset dell'oggetto chiamante è maggiore del valore dell'oggetto specificato.
	LessThan	Indica se il valore della proprietà AbsoluteCharOffset dell'oggetto chiamato è minore del valore dell'oggetto specificato.
	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

Condividi tramite