ITextView Interface

Referência

Definição

Namespace:: Microsoft.VisualStudio.Text.Editor

Assembly:: Microsoft.VisualStudio.Text.UI.dll

Pacote:: Microsoft.VisualStudio.Text.UI v17.12.215

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma exibição de texto em um ITextBuffer. É a classe base para uma interface específica da plataforma que tem métodos para permitir que o texto formatado seja renderizado.

public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

__interface ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

public interface ITextView : Microsoft.VisualStudio.Utilities.IPropertyOwner

type ITextView = interface
    interface IPropertyOwner

Public Interface ITextView
Implements IPropertyOwner

Derivado: Microsoft.VisualStudio.Text.Editor.ITextView2

Microsoft.VisualStudio.Text.Editor.IWpfTextView

Implementações: IPropertyOwner

Comentários

Uma exibição de texto é uma representação independente de plataforma de um bloco contíguo de texto formatado e adornado, acessível por meio da TextViewLines propriedade . Ele também cria uma instância de uma parte do componente IEditorOperations para que possa executar vários comandos.

O texto é formatado com base nos classificadores anexados ao subjacente ITextBuffer.

A maioria das propriedades e parâmetros que são duplos correspondem a coordenadas ou distâncias no sistema de coordenadas de renderização de texto. Nesse sistema de coordenadas, x = 0,0 corresponde à borda esquerda da superfície de desenho na qual o texto é renderizado (x = exibição. ViewportLeft corresponde à borda esquerda do visor) e y = exibição. ViewportTop corresponde à borda superior do visor. A coordenada x aumenta da esquerda para a direita e a coordenada y aumenta de cima para baixo.

Os eixos horizontais e verticais da exibição se comportam de forma diferente. Quando o texto no modo de exibição é formatado, somente as linhas visíveis são formatadas. Como resultado, um visor não pode ser rolado horizontal e verticalmente da mesma maneira.

Um visor é rolado horizontalmente alterando a coordenada esquerda do visor para que ele se mova em relação à superfície de desenho.

Uma exibição só pode ser rolada verticalmente executando um novo layout.

Fazer um layout no modo de exibição pode fazer com que a propriedade ViewportTop da exibição seja alterada. Por exemplo, rolar uma linha para baixo não traduzirá nenhuma das linhas visíveis. Em vez disso, ele simplesmente alterará a propriedade ViewportTop do modo de exibição (fazendo com que as linhas se movam na tela mesmo que suas coordenadas y não tenham sido alteradas).

As distâncias no sistema de coordenadas de renderização de texto correspondem a pixels lógicos. Se a superfície de renderização de texto for exibida sem nenhuma transformação de dimensionamento, uma unidade no sistema de coordenadas de renderização de texto corresponderá a um pixel na tela.

Propriedades

BufferGraph	Obtém o IBufferGraph que contém o conjunto de buffers de origem que contribuem para essa exibição.
Caret	Obtém o elemento caret.
HasAggregateFocus	Determina se a exibição ou qualquer um de seus adornos tem foco.
InLayout	Determina se o modo de exibição está no processo de ser disposto.
IsClosed	Determina se essa exibição de texto foi fechada.
IsMouseOverViewOrAdornments	Determina se o mouse está sobre a exibição ou qualquer um de seus adornos.
LineHeight	Obtém a altura nominal de uma linha de texto na exibição.
MaxTextRightCoordinate	Obtém a coordenada direita da linha mais longa, independentemente de essa linha estar ou não visível no momento, em pixels lógicos.
Options	Obtém as opções para esta exibição de texto.
Properties	A coleção de propriedades controladas pelo proprietário da propriedade. (Herdado de IPropertyOwner)
ProvisionalTextHighlight	Obtém o intervalo de texto coberto pelo realce de texto provisório.
Roles	As funções que esse modo de exibição desempenha. As funções determinam parcialmente as extensões que são instanciadas para a exibição.
Selection	Obtém o elemento de seleção.
TextBuffer	Obtém o ITextBuffer cujo texto é renderizado neste modo de exibição.
TextDataModel	Obtém o ITextDataModel deste modo de exibição de texto.
TextSnapshot	Obtém o ITextSnapshot do texto que atualmente é renderizado no modo de exibição.
TextViewLines	Obtém uma lista somente leitura dos ITextViewLine objetos renderizados nesta exibição.
TextViewModel	Obtém o ITextViewModel deste modo de exibição de texto.
ViewportBottom	Obtém a posição da borda inferior do visor no sistema de coordenadas de renderização de texto.
ViewportHeight	Obtém a altura da janela de conteúdo visível em pixels lógicos.
ViewportLeft	Obtém ou define a posição da borda esquerda do visor no sistema de coordenadas de renderização de texto.
ViewportRight	Obtém a posição da borda direita do visor no sistema de coordenadas de renderização de texto.
ViewportTop	Obtém a posição da borda superior do visor no sistema de coordenadas de renderização de texto.
ViewportWidth	Obtém a largura da janela de conteúdo visível em pixels lógicos.
ViewScroller	Obtém um auxiliar que fornece vários métodos para rolar ou manipular a exibição.
VisualSnapshot	Obtém o ITextSnapshot do buffer visual que está sendo renderizado.

Métodos

Close()	Fecha a exibição de texto e sua exibição.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)	Formata e exibe o conteúdo do buffer de texto para que a ITextViewLine contenção `bufferPosition` seja exibida na posição desejada.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition)	Formata e exibe o conteúdo do buffer de texto para que a ITextViewLine contenção `bufferPosition` seja exibida na posição desejada.
GetTextElementSpan(SnapshotPoint)	Obtém o SnapshotSpan de texto que constitui um elemento de texto (uma única representação visual) no determinado SnapshotPoint.
GetTextViewLineContainingBufferPosition(SnapshotPoint)	Obtém o ITextViewLine que contém a posição do buffer de texto especificada.
QueueSpaceReservationStackRefresh()	Solicita uma atualização da pilha de reserva de espaço.

Eventos

Closed	Ocorre imediatamente após o fechamento da exibição de texto.
GotAggregateFocus	Ocorre quando o foco do teclado alterna para o modo de exibição ou um de seus adornos.
LayoutChanged	Ocorre sempre que o texto exibido na exibição é alterado.
LostAggregateFocus	Ocorre quando o foco do teclado se afasta da exibição e de qualquer um de seus adornos.
MouseHover	Ocorre quando o mouse passa o mouse sobre o mesmo caractere.
ViewportHeightChanged	Ocorre quando a altura do visor é alterada.
ViewportLeftChanged	Ocorre quando a posição da borda esquerda do visor é alterada. (por exemplo, quando a exibição é rolada horizontalmente)
ViewportWidthChanged	Ocorre quando a largura do visor é alterada.

Métodos de Extensão

GetInOuterLayout(ITextView)	Determina se uma exibição está em processo de definição ou se está se preparando para ser estabelecida.
GetMultiSelectionBroker(ITextView)	Obtém um objeto para gerenciar seleções dentro do modo de exibição.
IsEmbeddedTextView(ITextView)	Obtém se determinado ITextView está inserido em outro ITextView.
IsReadOnlyTextView(ITextView)	Obtém se determinado ITextView é considerado somente leitura.
QueuePostLayoutAction(ITextView, Action)	Consulte QueuePostLayoutAction(Action).
TryGetContainingTextView(ITextView, ITextView)	Obtém a contenção ITextView para determinado inserido ITextView.
TryGetTextViewLineContainingBufferPosition(ITextView, SnapshotPoint, ITextViewLine)	Consulte TryGetTextViewLineContainingBufferPosition(SnapshotPoint, ITextViewLine).
TryGetTextViewLines(ITextView, ITextViewLineCollection)	Consulte TryGetTextViewLines(ITextViewLineCollection).

Aplica-se a

Partilhar via