Accéder à la mémoire tampon de texte à l’aide de l’API héritéeAccess the text buffer by using the legacy API

Le texte est chargé de gérer les flux de texte et la persistance du fichier.The text is responsible for managing text streams and file persistence. Bien que la mémoire tampon pour lire ou écrire les autres formats, toutes les communications normales avec la mémoire tampon sont effectuée à l’aide d’Unicode.Although the buffer can read or write other formats, all ordinary communication with the buffer is performed by using Unicode. Dans les API héritées, la mémoire tampon de texte peut utiliser soit un une ou un système de coordonnées à deux dimensions pour identifier les emplacements de caractère dans la mémoire tampon.In the legacy APIs, the text buffer can use either a one- or a two-dimensional coordinate system to identify character locations in the buffer.

Et deux-unidimensionnel coordonner les systèmesOne- and two-dimension coordinate systems

Une position de la coordonnée unidimensionnelle repose sur la position d’un caractère à partir du premier caractère dans la mémoire tampon, tels que 147.A one-dimensional coordinate position is based on a character's position from the first character in the buffer, such as 147. Vous utilisez le IVsTextStream interface pour accéder à un emplacement unidimensionnel dans la mémoire tampon.You use the IVsTextStream interface to access a one-dimensional location in the buffer. Un système de coordonnées à deux dimensions est basé sur des paires de ligne et d’index.A two-dimensional coordinate system is based on line and index pairs. Par exemple, un caractère dans la mémoire tampon à 43, 5 serait de ligne 43, cinq caractères à droite du premier caractère dans la ligne.For example, a character in the buffer at 43, 5 would be on line 43, five characters to the right of the first character in that line. Vous accédez à un emplacement à deux dimensions de la mémoire tampon en utilisant le IVsTextLines interface.You access a two-dimensional location in the buffer using the IVsTextLines interface. À la fois le IVsTextLines et IVsTextStream interfaces sont implémentées par l’objet de mémoire tampon de texte (VsTextBuffer) et est accessible à partir de l’autre à l’aide de QueryInterface.Both the IVsTextLines and the IVsTextStream interfaces are implemented by the text buffer object (VsTextBuffer) and can be accessed from each other by using QueryInterface. Le diagramme suivant illustre ces et autres interfaces de clé sur VsTextBuffer.The following diagram shows these and other key interfaces on VsTextBuffer.

Objet de mémoire tampon de texteText Buffer Object
Objet de mémoire tampon de texteText buffer object

Bien que le de ces systèmes de coordonnées fonctionne dans la mémoire tampon de texte, il est optimisé pour utiliser des coordonnées à deux dimensions.Although either coordinate system works in the text buffer, it is optimized to use two-dimensional coordinates. Un système de coordonnées unidimensionnel peut dégrader les performances.A one-dimensional coordinate system can create performance overhead. Par conséquent, utilisez le système de coordonnées à deux dimensions autant que possible.Therefore, use the two-dimensional coordinate system whenever possible.

Le deuxième responsabilité de la mémoire tampon de texte est une persistance de fichiers.The text buffer's second responsibility is file persistence. Pour ce faire, l’objet de mémoire tampon de texte implémente IVsPersistDocData2 et agit comme le composant d’objet de données de document pour les éléments de projet et d’autres composants d’environnement impliquées dans la persistance.To do this, the text buffer object implements IVsPersistDocData2 and acts as the document data object component for project items and other environment components involved in persistence. Pour plus d’informations, consultez d’ouverture et de l’enregistrement des éléments de projet.For more information, see Opening and Saving Project Items.

Dans cette sectionIn this section

Modifier les paramètres de vue à l’aide de l’API héritéeChange view settings by using the legacy API
Explique comment modifier les paramètres de vue à l’aide de l’API héritée.Explains how to change view settings using the legacy API.

Utilisez le Gestionnaire de texte pour surveiller les paramètres globauxUse the text manager to monitor global settings
Explique comment utiliser le Gestionnaire de texte pour surveiller les paramètres globaux.Explains how to use the text manager to monitor global settings.

Voir aussiSee also

À l’intérieur de l’éditeur principalInside the core editor