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
	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	Obtient la collection de propriétés contrôlées par le propriétaire. (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 du point de vue dans le système de coordonnées d'affichage du texte.
	ViewportHeight	Obtient la hauteur en pixels logiques de la fenêtre de contenu visible (notamment la marge).
	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.
	ViewportRight	Obtient la position du bord droit du point de vue dans le système de coordonnées d'affichage du texte.
	ViewportTop	Obtient la position du bord supérieur du point de vue dans le système de coordonnées d'affichage du texte.
	ViewportWidth	Obtient la largeur en pixels logiques de la fenêtre de contenu visible (notamment la marge).
	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.

Début

Méthodes

	Nom	Description
	Close	Ferme l'hôte d'affichage de texte et sa vue.
	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é.
	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é.
	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é.
	GetTextViewLineContainingBufferPosition	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.

Début

Événements

	Nom	Description
	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 lorsque l'éditeur de texte effectue une disposition de ligne de texte.
	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 d'un personnage.
	ViewportHeightChanged	Se produit lorsque la hauteur de fenêtre d'affichage est modifiée.Déconseillé.
	ViewportLeftChanged	Se produit lorsque la position de la fenêtre d'affichage laissée le bord est modifiée.Déconseillé
	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