Partager via


Événements de la mémoire tampon de texte dans l'API héritée

L'objet de mémoire tampon de texte effectue plusieurs événements qui vous permettent de répondre à des situations différentes.

Lorsque vous utilisez l'API héritée, vous devez implémenter les interfaces suivantes afin de recevoir la notification des modifications apportées à la mémoire tampon de texte. Exposez les interfaces dans la mémoire tampon de texte à l'aide de l'interface d' IConnectionPointContainer sur la mémoire tampon de texte pour recevoir la notification des modifications de ligne de la mémoire tampon. Pour plus d'informations, consultez Comment : Inscrire pour des événements de la mémoire tampon de texte avec l'API héritée. Dans le cas de IVsTextStreamEvents ou des interfaces d' IVsTextLinesEvents , les modifications sont retournés d'une ou deux dimensions coordonnées, respectivement.

interfaces de mémoire tampon de texte

Voici les interfaces implémentées par l'objet de la mémoire tampon de texte.

Interface

Description

IVsCompoundAction

Permet la création des actions composites (autrement dit, les actions qui sont regroupées dans une seule unité de l'annulation/rétablissement de rétablissement).

IVsPersistDocData

Active la persistance des données du document gérées par la mémoire tampon de texte.

IVsTextBuffer

fournit des services de base ; utilisé par plusieurs clients.

IVsTextLines

Fournit des fonctions en lecture et en écriture à l'aide de coordonnées à deux dimensions. Hérite de IVsTextBuffer.

IVsTextScanner

Le fournit rapidement, en continu, l'accès séquentiel au texte dans la mémoire tampon.

IVsTextStream

Fournit des fonctions en lecture et en écriture à l'aide de coordonnées unidimensionnelles. Hérite de IVsTextBuffer.

IVsUserData

permet d'accéder à une collection générique de propriétés. la propriété la plus importante est le nom, ou moniker, de la mémoire tampon. Vous pouvez stocker vos propres données aléatoires dans la mémoire tampon avec cette interface en créant un GUID et lorsque vous l'utilisez comme clé.

IConnectionPointContainer

Prend en charge les points de connexion pour les événements.

interfaces d'événement de mémoire tampon de texte

Voici les interfaces pour la notification d'événements de la mémoire tampon de texte.

Interface

Description

IVsTextBufferEvents

Informe les clients lorsqu'un service de langage est associé à une mémoire tampon de texte.

IVsTextBufferDataEvents

Informe les clients lorsqu'une mémoire tampon de texte est initialisée et lorsque des modifications sont apportées aux données de la mémoire tampon de texte.

IVsTextStreamEvents

Informe les clients des modifications apportées à la mémoire tampon sous-jacente des coordonnées unidimensionnelles.

IVsTextLinesEvents

Informe les clients des modifications apportées à la mémoire tampon sous-jacente des coordonnées à deux dimensions.

IVsUserDataEvents

Informe les clients des modifications apportées aux données utilisateur.

IVsPreliminaryTextChangeCommitEvents

Informe les clients de la dernière entrée tactile de validation de déclencher l'événement et fournit la plage de texte modifiée. L'interface d' IVsPreliminaryTextChangeCommitEvents n'est pas levée en réponse à les commandes d'annulation ou de rétablissement. Les événements les déclenchent uniquement pour les mémoires tampons qui ont un gestionnaire d'annulation. IVsPreliminaryTextChangeCommitEvents est déclenché avant d'événements, tels que la fonctionnalité liste, afin de s'assurer que les autres événements ne modifient pas le texte avant que les modifications validées. Votre VSPackage doit surveiller l'interface d' IVsPreliminaryTextChangeCommitEvents ou d'une interface IVsFinalTextChangeCommitEvents , mais pas les deux.

IVsFinalTextChangeCommitEvents

Informe les clients de la dernière entrée tactile de validation de déclencher l'événement et fournit la plage de texte modifiée. L'interface d' IVsFinalTextChangeCommitEvents n'est pas levée en réponse à les commandes d'annulation ou de rétablissement. Les événements les déclenchent uniquement pour les mémoires tampons qui ont un gestionnaire d'annulation. IVsFinalTextChangeCommitEvents est conçu pour être utilisé uniquement par les services de langage ou d'autres objets qui ont le contrôle total de la modification. Votre VSPackage doit surveiller l'interface d' IVsPreliminaryTextChangeCommitEvents ou d'une interface IVsFinalTextChangeCommitEvents , mais pas les deux.

Voir aussi

Tâches

Comment : Inscrire pour des événements de la mémoire tampon de texte avec l'API héritée

Concepts

accès de la mémoire tampon de texte à l'aide de l'API héritée