Interfaccia ITextCaret

Rappresenta il punto di inserimento associato a ITextView.

Spazio dei nomi:  Microsoft.VisualStudio.Text.Editor
Assembly:  Microsoft.VisualStudio.Text.UI (in Microsoft.VisualStudio.Text.UI.dll)

Sintassi

'Dichiarazione
Public Interface ITextCaret

public interface ITextCaret

public interface class ITextCaret

type ITextCaret =  interface end

public interface ITextCaret

Il tipo ITextCaret espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Bottom	Ottiene la posizione del bordo inferiore del punto di inserimento nel sistema di coordinate del rendering del testo.
	ContainingTextViewLine	ottiene ITextViewLine contenente il cursore, purché la riga di testo è visibile nella visualizzazione.
	Height	Ottiene l'altezza del punto di inserimento nel sistema di coordinate del rendering del testo.
	InVirtualSpace	Determina se il cursore si trova nello spazio virtuale.Uno spazio virtuale è uno spazio collocato dopo la fine fisica di una riga.
	IsHidden	Ottiene o imposta la visibilità del cursore.
	Left	Ottiene la posizione del bordo sinistro del punto di inserimento nel sistema di coordinate del rendering del testo.
	OverwriteMode	Determina se il cursore si trova modalità sovrascrittura.
	Position	Ottiene la posizione corrente del cursore.
	Right	Ottiene la posizione del bordo destro del punto di inserimento nel sistema di coordinate del rendering del testo.
	Top	Ottiene la posizione del bordo superiore del punto di inserimento nel sistema di coordinate del rendering del testo.
	Width	Ottiene la larghezza del punto di inserimento nel sistema di coordinate del rendering del testo.

In alto

Metodi

	Nome	Descrizione
	EnsureVisible	Rende visibile il punto di inserimento scorrendo la visualizzazione verso l'alto o verso il basso e a destra o finché il cursore non sia visibile.
	MoveTo(ITextViewLine)	Sposta il cursore sulla riga specificata di testo mantenendo la coordinata x corrente.
	MoveTo(SnapshotPoint)	Sposta il cursore all'indice specificato nell'oggetto sottostante ITextBuffer.
	MoveTo(VirtualSnapshotPoint)	Sposta il cursore sulla posizione del buffer specificata.
	MoveTo(ITextViewLine, Double)	Sposta il cursore al meglio CaretPosition per la coordinata x e per la riga di testo specificate.
	MoveTo(SnapshotPoint, PositionAffinity)	Sposta il cursore all'indice specificato nell'oggetto sottostante ITextBuffer.
	MoveTo(VirtualSnapshotPoint, PositionAffinity)	Sposta il cursore sulla posizione del buffer specificata.
	MoveTo(ITextViewLine, Double, Boolean)	Sposta il cursore al meglio CaretPosition per la coordinata x e per la riga di testo specificate.
	MoveTo(SnapshotPoint, PositionAffinity, Boolean)	Sposta il cursore all'indice specificato nell'oggetto sottostante ITextBuffer.
	MoveTo(VirtualSnapshotPoint, PositionAffinity, Boolean)	Sposta il cursore sulla posizione del buffer specificata.
	MoveToNextCaretPosition	Sposta il cursore sul valido successivo CaretPosition.
	MoveToPreferredCoordinates	Sposta il cursore sulle coordinate x e y preferite.
	MoveToPreviousCaretPosition	Sposta il cursore sul valido precedente CaretPosition.

In alto

Eventi

	Nome	Descrizione
	PositionChanged	Si verifica quando la posizione del cursore è stata modificata in modo esplicito.

In alto

Note

Questa interfaccia funge da modo pratico per ottenere la posizione corrente del cursore e spostare il cursore su una posizione diversa. Per ulteriori informazioni sull'utilizzo del cursore, vedere le procedure dettagliate dell'editor, ad esempio procedura dettagliata: Evidenziazione del testo.

La maggior parte delle proprietà e dei parametri presenti double corrispondono alle coordinate o alle distanze nel sistema di coordinate del rendering del testo. In tale sistema di coordinate, x = 0,0 corrisponde a sinistra bordo dell'area di disegno in cui il rendering del testo (x = view.ViewportLeft corrisponde al bordo sinistro del riquadro di visualizzazione) e y = view.ViewportTop corrisponde al bordo superiore del riquadro di visualizzazione. La coordinata x aumenta da sinistra a destra e aumenti di coordinata y dall'alto verso il basso. Orizzontale e le ACE verticale della visualizzazione si comportano in modo diverso. Quando il testo nella visualizzazione viene formattato, solo le righe visualizzate vengono formattate. Di conseguenza, un riquadro di visualizzazione non è possibile scorrere verticalmente e orizzontalmente in modo analogo. Un riquadro di visualizzazione si scorre orizzontalmente modificando la coordinata sinistro del riquadro di visualizzazione in modo che viene spostato rispetto all'area di disegno. Una visualizzazione può essere scorre verticalmente solo eseguendo un nuovo layout. Creare un layout della visualizzazione può causare ViewportTop proprietà di visualizzazione da modificare.

Ad esempio, scorrere in basso di una riga non vi tradurrà una qualsiasi delle righe visualizzate. Anziché produrrà semplicemente la visualizzazione ViewportTop proprietà (che determina le linee a spostarsi sullo schermo sebbene le coordinate y non sono stati modificati). Le distanze nel sistema di coordinate del rendering del testo corrispondono ai pixel logici. Se la superficie di rendering del testo visualizzato senza alcuna trasformazione di scala, quindi 1 unità nel sistema di coordinate del rendering del testo corrisponde a un pixel della visualizzazione.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Text.Editor