ITextView Interface

Référence

Définition

Espace de noms:: Microsoft.VisualStudio.Text.Editor

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

Paquet:: Microsoft.VisualStudio.Text.UI v17.11.260

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente l'affichage de texte d'un élément ITextBuffer. C'est la classe de base pour une interface spécifique à une plateforme disposant de méthodes permettant d'autoriser l'affichage de texte mis en forme.

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

Dérivé: Microsoft.VisualStudio.Text.Editor.ITextView2

Microsoft.VisualStudio.Text.Editor.IWpfTextView

Implémente: IPropertyOwner

Remarques

Une vue texte est une représentation indépendante de la plateforme d’un bloc contigu de texte mis en forme et orné, accessible via la TextViewLines propriété . Il instancie également une instance d’un composant IEditorOperations afin qu’il puisse exécuter différentes commandes.

Le texte est mis en forme en fonction des classifieurs attachés au sous-jacent ITextBuffer.

La plupart des propriétés et des paramètres qui sont doubles correspondent à des coordonnées ou des distances dans le système de coordonnées de rendu de texte. Dans ce système de coordonnées, x = 0,0 correspond au bord gauche de la surface de dessin sur laquelle le texte est rendu (x = vue. ViewportLeft correspond au bord gauche de la fenêtre d’affichage) et y = vue. ViewportTop correspond au bord supérieur de la fenêtre d’affichage. La coordonnée x augmente de gauche à droite, et la coordonnée y augmente de haut en bas.

Les axes horizontaux et verticaux de la vue se comportent différemment. Lorsque le texte de la vue est mis en forme, seules les lignes visibles sont mises en forme. Par conséquent, une fenêtre d’affichage ne peut pas être défiler horizontalement et verticalement de la même manière.

Une fenêtre d’affichage fait défiler horizontalement en modifiant la coordonnée gauche de la fenêtre d’affichage afin qu’elle se déplace par rapport à la surface de dessin.

Une vue ne peut être défiler verticalement qu’en effectuant une nouvelle disposition.

L’exécution d’une disposition dans la vue peut entraîner la modification de la propriété ViewportTop de la vue. Par exemple, le fait de faire défiler une ligne vers le bas ne traduit aucune des lignes visibles. Au lieu de cela, il va simplement modifier la propriété ViewportTop de la vue (ce qui entraîne le déplacement des lignes à l’écran même si leurs coordonnées y n’ont pas changé).

Les distances dans le système de coordonnées de rendu de texte correspondent à des pixels logiques. Si la surface de rendu de texte s’affiche sans transformation de mise à l’échelle, 1 unité dans le système de coordonnées de rendu de texte correspond à un pixel sur l’affichage.

Propriétés

BufferGraph	Obtient l'élément IBufferGraph contenant l'ensemble des mémoires tampons source contribuant à cette vue.
Caret	Obtient l'élément de signe insertion.
HasAggregateFocus	Détermine si la vue ou l'un de ses ornements a le focus.
InLayout	Détermine si la vue est en cours de présentation.
IsClosed	Détermine si cet affichage de texte a été fermé.
IsMouseOverViewOrAdornments	Détermine si la souris est positionnée sur la vue ou l'un de ses ornements.
LineHeight	Obtient la hauteur nominale d'une ligne de texte dans la vue.
MaxTextRightCoordinate	Obtient les coordonnées exactes en pixels logiques de la ligne la plus longue et indique si cette ligne est actuellement visible.
Options	Obtient les options correspondant à cet affichage de texte.
Properties	Collection des propriétés gérée par le propriétaire de propriétés. (Hérité de IPropertyOwner)
ProvisionalTextHighlight	Obtient l'étendue de texte ciblée par la mise en surbrillance provisoire.
Roles	Rôles tenus par cette vue. Les rôles déterminent partiellement les extensions instanciées pour la vue.
Selection	Obtient l'élément de sélection.
TextBuffer	Obtient l'élément ITextBuffer dont le texte est affiché dans cette vue.
TextDataModel	Obtient l'élément ITextDataModel correspondant à cet affichage de texte.
TextSnapshot	Obtient l'élément ITextSnapshot du texte actuellement affiché dans la vue.
TextViewLines	Obtient une liste en lecture seule des objets ITextViewLine affichés dans cette vue.
TextViewModel	Obtient l'élément ITextViewModel correspondant à cet affichage de texte.
ViewportBottom	Obtient la position du bord inférieur de la fenêtre d’affichage dans le système de coordonnées de rendu du texte.
ViewportHeight	Obtient la hauteur de la fenêtre de contenu visible en pixels logiques.
ViewportLeft	Obtient ou définit la position du bord gauche de la fenêtre d’affichage dans le système de coordonnées de rendu de texte.
ViewportRight	Obtient la position du bord droit de la fenêtre d’affichage dans le système de coordonnées de rendu du texte.
ViewportTop	Obtient la position du bord supérieur de la fenêtre d’affichage dans le système de coordonnées de rendu du texte.
ViewportWidth	Obtient la largeur de la fenêtre de contenu visible en pixels logiques.
ViewScroller	Obtient un programme d'assistance qui fournit différentes méthodes permettant de faire défiler ou de manipuler la vue.
VisualSnapshot	Obtient l'élément ITextSnapshot de la mémoire tampon visuelle en cours d'affichage.

Méthodes

Close()	Ferme l’affichage texte et son affichage.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)	Met en forme et affiche le contenu de la mémoire tampon de texte afin que le ITextViewLine contenant `bufferPosition` s’affiche à la position souhaitée.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition)	Met en forme et affiche le contenu de la mémoire tampon de texte afin que le ITextViewLine contenant `bufferPosition` s’affiche à la position souhaitée.
GetTextElementSpan(SnapshotPoint)	Obtient l'élément SnapshotSpan du texte constituant un élément de texte (représentation visuelle unique) au niveau de l'objet SnapshotPoint spécifié.
GetTextViewLineContainingBufferPosition(SnapshotPoint)	Obtient l'élément ITextViewLine contenant la position de mémoire tampon de texte spécifiée.
QueueSpaceReservationStackRefresh()	Demande un rafraîchissement de la pile de réservation d'espace.

Événements

Closed	Se produit immédiatement après avoir fermé l'affichage de texte.
GotAggregateFocus	Se produit lorsque le focus clavier passe à la vue ou à l'un de ses ornements.
LayoutChanged	Se produit chaque fois que le texte affiché dans la vue change.
LostAggregateFocus	Se produit lorsque la vue ou l'un de ses ornements perd le focus clavier.
MouseHover	Se produit lorsque la souris a pointé sur le même caractère.
ViewportHeightChanged	Se produit lorsque la hauteur de la fenêtre d’affichage est modifiée.
ViewportLeftChanged	Se produit lorsque la position du bord gauche de la fenêtre d’affichage est modifiée. (par exemple, lorsque la vue fait défiler horizontalement)
ViewportWidthChanged	Se produit lorsque la largeur de la fenêtre d’affichage est modifiée.

Méthodes d’extension

GetInOuterLayout(ITextView)	Détermine si une vue est en cours d’élaboration ou s’il s’apprête à l’être.
GetMultiSelectionBroker(ITextView)	Obtient un objet pour la gestion des sélections dans la vue.
IsEmbeddedTextView(ITextView)	Obtient si donné ITextView est incorporé dans un autre ITextView.
IsReadOnlyTextView(ITextView)	Obtient si donné ITextView est considéré comme en lecture seule.
QueuePostLayoutAction(ITextView, Action)	Consultez QueuePostLayoutAction(Action).
TryGetContainingTextView(ITextView, ITextView)	Obtient contenant ITextView pour un incorporé ITextViewdonné.
TryGetTextViewLineContainingBufferPosition(ITextView, SnapshotPoint, ITextViewLine)	Consultez TryGetTextViewLineContainingBufferPosition(SnapshotPoint, ITextViewLine).
TryGetTextViewLines(ITextView, ITextViewLineCollection)	Consultez TryGetTextViewLines(ITextViewLineCollection).

S’applique à

Partager via