ITextView Interfaccia

Definizione

Rappresenta una visualizzazione di testo in un oggetto ITextBuffer. È la classe di base per un'interfaccia specifica della piattaforma che dispone di metodi per consentire che venga eseguito il rendering del testo formattato.

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

Commenti

Una visualizzazione di testo è una rappresentazione indipendente dalla piattaforma di un blocco contiguo di testo formattato e adornato, accessibile tramite la TextViewLines proprietà. Crea anche un'istanza di una parte componente IEditorOperations in modo che possa eseguire vari comandi.

Il testo viene formattato in base ai classificatori collegati all'oggetto sottostante ITextBuffer.

La maggior parte delle proprietà e dei parametri che corrispondono a coordinate o distanze nel sistema di coordinate di rendering del testo. In questo sistema di coordinate x = 0.0 corrisponde al bordo sinistro della superficie di disegno su cui viene eseguito il rendering del testo (x = vista. ViewportLeft corrisponde al bordo sinistro del viewport e y = visualizzazione. ViewportTop corrisponde al bordo superiore del viewport. La coordinata x aumenta da sinistra a destra e la coordinata y aumenta dall'alto verso il basso.

Gli assi orizzontali e verticali della visualizzazione si comportano in modo diverso. Quando il testo nella visualizzazione viene formattato, vengono formattate solo le righe visibili. Di conseguenza, non è possibile scorrere orizzontalmente un viewport e verticalmente nello stesso modo.

Un riquadro di visualizzazione viene scorrevole orizzontalmente modificando la coordinata sinistra del riquadro di visualizzazione in modo che venga spostata rispetto all'area di disegno.

Una visualizzazione può essere scorrere verticalmente solo eseguendo un nuovo layout.

L'operazione di un layout nella visualizzazione può causare la modifica della proprietà ViewportTop della visualizzazione. Ad esempio, lo scorrimento verso il basso di una riga non tradurrà alcuna delle linee visibili. Invece cambierà semplicemente la proprietà ViewportTop della visualizzazione (causando lo spostamento delle righe sullo schermo anche se le coordinate y non sono state modificate).

Le distanze nel sistema di coordinate di rendering del testo corrispondono ai pixel logici. Se la superficie di rendering del testo viene visualizzata senza alcuna trasformazione di ridimensionamento, 1 unità nel sistema di coordinate di rendering del testo corrisponde a un pixel sullo schermo.

Proprietà

BufferGraph

Ottiene l'oggetto IBufferGraph che contiene il set di buffer di origine che contribuiscono a questa visualizzazione.

Caret

Ottiene l'elemento punto di inserimento.

HasAggregateFocus

Determina se la visualizzazione o una qualsiasi delle aree di controllo dispone dello stato attivo.

InLayout

Determina se è in corso l'applicazione del layout della visualizzazione.

IsClosed

Determina se questa visualizzazione di testo è stata chiusa.

IsMouseOverViewOrAdornments

Determina se il mouse si trova sulla visualizzazione o su una qualsiasi delle aree di controllo.

LineHeight

Ottiene l'altezza nominale di una riga di testo nella visualizzazione.

MaxTextRightCoordinate

Ottiene la coordinata destra della riga più lunga, anche se tale riga non è attualmente visibile, in pixel logici.

Options

Ottiene le opzioni per questa visualizzazione di testo.

Properties

La raccolta di proprietà controllate dal proprietario della proprietà.

(Ereditato da IPropertyOwner)
ProvisionalTextHighlight

Ottiene l'ampiezza del testo coperta dall'evidenziazione provvisoria del testo.

Roles

Ruoli di questa visualizzazione. I ruoli determinano in parte le estensioni di cui viene creata un'istanza per la visualizzazione.

Selection

Ottiene l'elemento di selezione.

TextBuffer

Ottiene l'oggetto ITextBuffer per il quale viene eseguito il rendering del testo in questa visualizzazione.

TextDataModel

Ottiene l'oggetto ITextDataModel di questa visualizzazione di testo.

TextSnapshot

Ottiene l'oggetto ITextSnapshot del testo di cui viene attualmente eseguito il rendering nella visualizzazione.

TextViewLines

Ottiene un elenco di sola lettura degli oggetti ITextViewLine di cui viene eseguito il rendering in questa visualizzazione.

TextViewModel

Ottiene l'oggetto ITextViewModel di questa visualizzazione di testo.

ViewportBottom

Ottiene la posizione del bordo inferiore del riquadro di visualizzazione nel sistema di coordinate di rendering del testo.

ViewportHeight

Ottiene l'altezza della finestra del contenuto visibile in pixel logici.

ViewportLeft

Ottiene o imposta la posizione del bordo sinistro del riquadro di visualizzazione nel sistema di coordinate di rendering del testo.

ViewportRight

Ottiene la posizione del bordo destro del viewport nel sistema di coordinate di rendering del testo.

ViewportTop

Ottiene la posizione del bordo superiore del riquadro di visualizzazione nel sistema di coordinate di rendering del testo.

ViewportWidth

Ottiene la larghezza della finestra del contenuto visibile in pixel logici.

ViewScroller

Ottiene un helper che fornisce i vari metodi per scorrere o modificare la visualizzazione.

VisualSnapshot

Ottiene l'oggetto ITextSnapshot del buffer visivo di cui viene eseguito il rendering.

Metodi

Close()

Chiude la visualizzazione di testo e la relativa visualizzazione.

DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition)

Formatta e visualizza il contenuto del buffer di testo in modo che l'oggetto ITextViewLine contenente bufferPosition venga visualizzato nella posizione desiderata.

DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)

Formatta e visualizza il contenuto del buffer di testo in modo che l'oggetto ITextViewLine contenente bufferPosition venga visualizzato nella posizione desiderata.

GetTextElementSpan(SnapshotPoint)

Ottiene l'oggetto SnapshotSpan del testo che costituisce un elemento di testo (una sola rappresentazione visiva) in corrispondenza dell'oggetto SnapshotPoint specificato.

GetTextViewLineContainingBufferPosition(SnapshotPoint)

Ottiene l'oggetto ITextViewLine contenente la posizione del buffer di testo specificata.

QueueSpaceReservationStackRefresh()

Richiede un aggiornamento dello stack di prenotazione dello spazio.

Eventi

Closed

Si verifica subito dopo la chiusura della visualizzazione di testo.

GotAggregateFocus

Si verifica quando lo stato attivo della tastiera passa alla visualizzazione o una delle aree di controllo corrispondenti.

LayoutChanged

Si verifica ogni volta che il testo visualizzato nella visualizzazione cambia.

LostAggregateFocus

Si verifica quando lo stato attivo della tastiera si allontana dalla visualizzazione e da tutte le aree di controllo corrispondenti.

MouseHover

Si verifica quando il mouse è stato spostato sullo stesso carattere.

ViewportHeightChanged

Si verifica quando l'altezza del viewport viene modificata.

ViewportLeftChanged

Si verifica quando viene modificata la posizione del bordo sinistro del viewport. (ad esempio, quando la visualizzazione è scorrere orizzontalmente)

ViewportWidthChanged

Si verifica quando viene modificata la larghezza del riquadro di visualizzazione.

Metodi di estensione

GetInOuterLayout(ITextView)

Determina se una vista è in fase di disposizione o si prepara a essere disposta.

GetMultiSelectionBroker(ITextView)

Ottiene un oggetto per la gestione delle selezioni all'interno della visualizzazione.

IsEmbeddedTextView(ITextView)

Ottiene se specificato ITextView è incorporato in un altro ITextViewoggetto .

IsReadOnlyTextView(ITextView)

Ottiene se viene ITextView considerato di sola lettura.

QueuePostLayoutAction(ITextView, Action)

Vedere QueuePostLayoutAction(Action).

TryGetContainingTextView(ITextView, ITextView)

Ottiene contenente ITextView per un determinato oggetto incorporato ITextView.

TryGetTextViewLineContainingBufferPosition(ITextView, SnapshotPoint, ITextViewLine)

Vedere TryGetTextViewLineContainingBufferPosition(SnapshotPoint, ITextViewLine).

TryGetTextViewLines(ITextView, ITextViewLineCollection)

Vedere TryGetTextViewLines(ITextViewLineCollection).

Si applica a