Partager via


ITextView, interface

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.

Espace de noms :  Microsoft.VisualStudio.Text.Editor
Assembly :  Microsoft.VisualStudio.Text.UI (dans Microsoft.VisualStudio.Text.UI.dll)

Syntaxe

'Déclaration
Public Interface ITextView _
    Inherits IPropertyOwner
public interface ITextView : IPropertyOwner
public interface class ITextView : IPropertyOwner
type ITextView =  
    interface 
        interface IPropertyOwner 
    end
public interface ITextView extends IPropertyOwner

Le type ITextView expose les membres suivants.

Propriétés

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

Début

Méthodes

  Nom Description
Méthode publique Close Ferme l'hôte d'affichage de texte et sa vue.
Méthode publique DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition) Met en forme et affiche le contenu de la mémoire tampon de texte afin qu'ITextViewLine contenant la position dans la mémoire tampon soit affiché à l'emplacement souhaité.
Méthode publique DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>) Met en forme et affiche le contenu de la mémoire tampon de texte afin qu'ITextViewLine contenant la position dans la mémoire tampon spécifiée soit affiché à l'emplacement souhaité.
Méthode publique GetTextElementSpan 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é.
Méthode publique GetTextViewLineContainingBufferPosition Obtient l'élément ITextViewLine contenant la position de mémoire tampon de texte spécifiée.
Méthode publique QueueSpaceReservationStackRefresh Demande un rafraîchissement de la pile de réservation d'espace.

Début

Événements

  Nom Description
Événement public Closed Se produit immédiatement après avoir fermé l'affichage de texte.
Événement public GotAggregateFocus Se produit lorsque le focus clavier passe à la vue ou à l'un de ses ornements.
Événement public LayoutChanged Se produit lorsque l'éditeur de texte effectue une disposition de ligne de texte.
Événement public LostAggregateFocus Se produit lorsque la vue ou l'un de ses ornements perd le focus clavier.
Événement public MouseHover Se produit lorsque la souris a pointé sur d'un personnage.
Événement public ViewportHeightChanged Se produit lorsque la hauteur de fenêtre d'affichage est modifiée.Déconseillé.
Événement public ViewportLeftChanged Se produit lorsque la position de la fenêtre d'affichage laissée le bord est modifiée.Déconseillé
Événement public ViewportWidthChanged Se produit lorsque la largeur de fenêtre d'affichage est modifiée.Déconseillé.

Début

Notes

Un affichage de texte est une représentation plateforme-indépendante d'un bloc contigu de texte mis en forme et orné. Le texte est accessible via la propriété d'TextViewLines.

Pour plus d'informations sur des affichages de texte, voyez à la section « l'affichage de texte » dans à l'intérieur de l'éditeur.

L'affichage de texte instancie également une instance d'un composant d'IEditorOperations afin qu'il puisse exécuter de différentes commandes.

Le texte est mis en forme selon les classifieurs qui sont joints à ITextBuffer sous-jacent.

La plupart des propriétés et paramètres qui sont des doubles correspondent aux 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 affiché (x view.ViewportLeft = correspond au bord gauche de la fenêtre d'affichage), et y = view.ViewportTop correspond au bord supérieur de la fenêtre d'affichage. Le coordonnée x augmente de gauche à droite, et le coordonnée y augmente de bas en haut. Les axes horizontaux et verticaux de la vue se comportent différemment. Lorsque le texte dans la vue est mis en forme, uniquement les lignes visibles sont mises en forme. Par conséquent, une fenêtre d'affichage ne peut pas être faite défiler horizontalement et verticalement de la même façon. Une fenêtre d'affichage est faite défiler horizontalement en modifiant la coordonnée gauche de la fenêtre d'affichage afin qu'il déplace en ce qui concerne la surface de dessin. Une vue peut être faite défiler verticalement uniquement en effectuant une nouvelle mise en page. Effectuer une mise en page dans la vue peut provoquer la propriété d'ViewportTop de la vue à la modification.

Par exemple, faire défiler vers le bas d'une ligne ne traduira pas les lignes visibles l'une d'elles. À la place il modifiera simplement la propriété d'ViewportTop, qui provoque les lignes de le déplacer sur l'écran même si leurs coordonnée y n'aient pas changé. Les distances dans le système de coordonnées de rendu de texte correspondent aux pixels logiques. Si la surface de rendu de texte est affichée sans aucune transformation de mise à l'échelle, une unité dans le système de coordonnées de rendu de texte correspond à un pixel dans l'affichage.

Voir aussi

Référence

Microsoft.VisualStudio.Text.Editor, espace de noms