IVsTextView, interface

Gère l'affichage de texte d'une fenêtre d'éditeur et contient des méthodes pour gérer l'affichage de texte. La vue est essentiellement la fenêtre d'éditeur montrée dans l'interface utilisateur. (UI)

Espace de noms :  Microsoft.VisualStudio.TextManager.Interop
Assembly :  Microsoft.VisualStudio.TextManager.Interop (dans Microsoft.VisualStudio.TextManager.Interop.dll)

Syntaxe

'Déclaration
<InterfaceTypeAttribute()> _
<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")> _
Public Interface IVsTextView

[InterfaceTypeAttribute()]
[GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface IVsTextView

[InterfaceTypeAttribute()]
[GuidAttribute(L"BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface class IVsTextView

[<InterfaceTypeAttribute()>]
[<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")>]
type IVsTextView =  interface end

public interface IVsTextView

Le type IVsTextView expose les membres suivants.

Méthodes

	Nom	Description
	AddCommandFilter	Ajoute un filtre de commande aux filtres existants de la hiérarchie de commandes.
	CenterColumns	Place la colonne spécifiée du texte au centre de la vue.
	CenterLines	Place les lignes de texte spécifiées au centre de la vue.
	ClearSelection	Désactive la sélection actuelle.
	CloseView	Ferme et annule l'enregistrement une vue avec le gestionnaire d'affichages.
	EnsureSpanVisible	Garantit que le texte est en mode, verticalement et horizontalement.
	GetBuffer	Retourne le contenu actuel de la mémoire tampon de texte.
	GetCaretPos	Retourne la ligne et l'index de colonne de la position du curseur.
	GetLineAndColumn	Convertit une position de flux de texte à une ligne et à un index de colonne.
	GetLineHeight	Retourne la hauteur de pixel d'une ligne.
	GetNearestPosition	Convertit une ligne et un index de colonne à une position de flux de texte.
	GetPointOfLineColumn	Retourne les coordonnées du coin supérieur gauche d'une ligne et d'une colonne particulières.
	GetScrollInfo	Retourne les principaux paramètres de la barre de défilement de l'éditeur de texte pour la barre de défilement spécifiée.
	GetSelectedText	Retourne une copie du texte sélectionné.
	GetSelection	Retourne l'étendue de texte correspondant à la sélection actuelle, s'il y en a une.
	GetSelectionDataObject	Retourne une copie du texte sélectionné dans le format d'interface d'IDataObject.
	GetSelectionMode	Retourne le mode de sélection actuel.
	GetSelectionSpan	Retourne l'étendue de texte associée avec une sélection.
	GetTextStream	Retourne un flux de données spécifié de texte dans une chaîne.
	GetWindowHandle	Retourne la handle de fenêtre pour cette vue.
	GetWordExtent	Retourne l'étendue actuelle de mot.
	HighlightMatchingBrace	Met en surbrillance l'accolade correspondante dans une construction de langage.
	Initialize	Crée la vue et permet à des clients pour spécifier un ou plusieurs options de TextViewInitFlags.
	PositionCaretForEditing	Place le signe insertion dans une position appropriée pour modifier une fonction.
	RemoveCommandFilter	Supprime un filtre de commande des filtres de hiérarchie de commandes.
	ReplaceTextOnLine	Remplace le texte de ligne.
	RestrictViewRange	Les informations de méthode ne sont pas fournies.La méthode n'est pas implémentée.
	SendExplicitFocus	Envoie le focus explicite à la fenêtre.
	SetBuffer	Associe une mémoire tampon de texte avec la vue.
	SetCaretPos	Définit les coordonnées du point de fin d'une sélection.
	SetScrollPosition	Définit les principaux paramètres de la barre de défilement de l'éditeur de texte pour la barre de défilement spécifiée.
	SetSelection	Selects a spécifié le texte.
	SetSelectionMode	Définit le mode de sélection.
	SetTopLine	Définit l'entrée ligne supérieure la vue à la ligne de base.
	UpdateCompletionStatus	Utilisé pour le contrôle d'achèvement de mot.
	UpdateTipWindow	Met à jour la fenêtre de conseil.
	UpdateViewFrameCaption	Force la vue pour mettre à jour sa légende de fenêtre frame, par exemple « lecture seule [] ».

Début

Notes

L'interface d'IVsTextView n'est pas le l'enfant MDI, mais une fenêtre individuelle de texte. Si un séparateur est impliqué, il peut y avoir de plusieurs vues dans un enfant MDI. Le terme, signe insertion, fait référence au point d'insertion de texte, tandis que le terme, curseur, fait référence au pointeur de souris.

Avertissement

Cette interface n'est pas thread-safe.Vous ne devez appeler rien sur cette interface de n'importe quoi mais du thread d'interface utilisateur principal.

Si vous devez exécuter toutes les opérations sur la vue d'un thread différent, vous pouvez :

• Utilisez l'interface IVsThreadSafeTextView.

• Appelez la méthode d'GetWindowHandle et utilisez la méthode d'PostMessage pour publier des messages au thread principal.

Certaines méthodes sur IVsTextView utilisent des coordonnées de ViewCol (par exemple, GetTextStream et GetCaretPos), alors que d'autres utilisent des coordonnées de CharIndex (par exemple, GetWordExtent). Les coordonnées de ViewCol peuvent comprendre l'espace virtuel pendant que les coordonnées de CharIndex sont uniquement un offset dans une ligne de mémoire tampon et ne jamais comprendre l'espace virtuel.

Si vous obtenez une coordonnée dans des coordonnées de ViewCol, vous devez uniquement appeler les méthodes qui prennent des coordonnées de CharIndex après vérification que la coordonnée de ViewCol ne se trouve pas dans la zone de l'espace virtuel. Par exemple, si vous appelez ce qui suit :

long iLine;

long cCount;

ViewCol iCol;

IVsTextView::SomeMethod(&iLine, &icol);

Vous devez s'activer pour être sûr que les éléments suivants sont vrais :

IVsTextBuffer::GetLengthOfLine(iLine, &cCount);

iCol < cCount

Appelez ensuite ce qui suit :

IVsTextView::SomeOtherMethod(ViewCol(iCol ))

// where SomeOtherMethod takes ViewCol coordinates

Consulter les illustrations de l'implémentation et/ou d'appeler de cette interface dans l'exemple Figures Language Service.

Remarques à l'attention des appelants

Appelé par les clients qui souhaitent gérer leur vue.

Voir aussi

Référence

Microsoft.VisualStudio.TextManager.Interop, espace de noms