ITextView Interfaccia

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualStudio.Text.Editor

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

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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: Microsoft.VisualStudio.Text.Editor.ITextView2

Microsoft.VisualStudio.Text.Editor.IWpfTextView

Implementazioni: IPropertyOwner

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, 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.
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.
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

Condividi tramite