Interface ITextCaret

Representa o cursor associado com um ITextView.

Namespace:  Microsoft.VisualStudio.Text.Editor
Assembly:  Microsoft.VisualStudio.Text.UI (em Microsoft.VisualStudio.Text.UI.dll)

Sintaxe

'Declaração
Public Interface ITextCaret

public interface ITextCaret

public interface class ITextCaret

type ITextCaret =  interface end

public interface ITextCaret

O tipo ITextCaret expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Bottom	Obtém a posição da borda inferior do cursor no sistema de coordenadas de processamento de texto.
	ContainingTextViewLine	Obtém o ITextViewLine que contém o cursor, desde que essa linha de texto está visível no modo de exibição.
	Height	Obtém a altura do cursor no sistema de coordenadas de processamento de texto.
	InVirtualSpace	Determina se o cursor se encontra no espaço virtual.Um espaço virtual é aquele que está após o final de uma linha.
	IsHidden	Obtém ou define a visibilidade do cursor.
	Left	Obtém a posição da borda esquerda do cursor no sistema de coordenadas de processamento de texto.
	OverwriteMode	Determina se o cursor estiver no modo de substituição.
	Position	Obtém a posição atual do cursor.
	Right	Obtém a posição da borda direita do cursor no sistema de coordenadas de processamento de texto.
	Top	Obtém a posição da borda superior do cursor no sistema de coordenadas de processamento de texto.
	Width	Obtém a largura do cursor no sistema de coordenadas de processamento de texto.

Superior

Métodos

	Nome	Descrição
	EnsureVisible	Torna o cursor visíveis ao rolar a exibição de cima ou para baixo e esquerda ou direita até que o cursor esteja visível.
	MoveTo(ITextViewLine)	Move o cursor para a linha de texto especificado, preservando a coordenada x atual.
	MoveTo(SnapshotPoint)	Move o cursor para o índice fornecido em base ITextBuffer.
	MoveTo(VirtualSnapshotPoint)	Move o cursor para a posição do buffer especificado.
	MoveTo(ITextViewLine, Double)	Move o cursor para o melhor CaretPosition da linha de texto e a coordenada x especificada.
	MoveTo(SnapshotPoint, PositionAffinity)	Move o cursor para o índice fornecido em base ITextBuffer.
	MoveTo(VirtualSnapshotPoint, PositionAffinity)	Move o cursor para a posição do buffer especificado.
	MoveTo(ITextViewLine, Double, Boolean)	Move o cursor para o melhor CaretPosition da linha de texto e a coordenada x especificada.
	MoveTo(SnapshotPoint, PositionAffinity, Boolean)	Move o cursor para o índice fornecido em base ITextBuffer.
	MoveTo(VirtualSnapshotPoint, PositionAffinity, Boolean)	Move o cursor para a posição do buffer especificado.
	MoveToNextCaretPosition	Move o cursor para a próxima válido CaretPosition.
	MoveToPreferredCoordinates	Move o cursor para coordenadas x e y preferencial.
	MoveToPreviousCaretPosition	Move o cursor para o anterior válido CaretPosition.

Superior

Eventos

	Nome	Descrição
	PositionChanged	Ocorre quando a posição do cursor foi alterada explicitamente.

Superior

Comentários

Essa interface serve como uma maneira conveniente para obter a posição atual do cursor e para mover o cursor para uma posição diferente. Para obter mais informações sobre como usar o cursor, consulte as orientações do editor, por exemplo Passo a passo: Realçar texto.

A maioria das propriedades e parâmetros que são duplicatas correspondem às coordenadas ou sistema de coordenadas de distâncias no processamento de texto. No sistema de coordenadas, x = 0.0 corresponde à borda esquerda da superfície de desenho no qual o texto é renderizado (x = view.ViewportLeft corresponde à borda esquerda dessa porta) e y = view.ViewportTop corresponde à borda superior dessa porta. A coordenada x aumenta da esquerda para a direita e a coordenada y aumenta de cima para baixo. Os eixos horizontais e verticais do modo de exibição se comportam de maneira diferente. Quando o texto no modo de exibição é formatado, somente as linhas visíveis são formatadas. Como resultado, uma porta de visualização não pode ser rolada a horizontal e verticalmente da mesma maneira. Uma porta de visualização é rolada na horizontal, alterando a coordenada esquerda dessa porta para se mover em relação à superfície de desenho. Um modo de exibição pode ser rolado verticalmente apenas desempenhando um novo layout. Fazer um layout no modo de exibição pode causar a ViewportTop a propriedade do modo de exibição para alterar.

Por exemplo, rolando para baixo uma linha não serão convertidas qualquer uma das linhas visíveis. Em vez disso, ela simplesmente altera o modo de exibição ViewportTop (fazendo com que as linhas mover na tela, mesmo que não mudaram suas coordenadas y) de propriedade. Distâncias no sistema de coordenadas de processamento de texto correspondem aos pixels lógicos. Se a superfície de processamento de texto é exibida sem qualquer transformação de dimensionamento, 1 unidade no sistema de coordenadas de processamento de texto corresponde a um pixel na tela.

Consulte também

Referência

Namespace Microsoft.VisualStudio.Text.Editor