L’accès à la mémoire tampon de texte à l’aide de l’API héritéeAccessing the Text Buffer by Using the Legacy API

Le texte est chargé de gérer le 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 d’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 permettre utiliser - 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.

Dimension un et deux repèresOne- and Two-Dimension Coordinate Systems

Une position de coordonnée unidimensionnelle est basée sur la position d’un caractère à partir du premier caractère dans la mémoire tampon, comme 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 la 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. Accéder à un emplacement à deux dimensions de la mémoire tampon en utilisant la IVsTextLines interface.You access a two-dimensional location in the buffer using the IVsTextLines interface. À la fois le IVsTextLines et IVsTextStream les interfaces sont implémentées par l’objet de mémoire tampon de texte (VsTextBuffer) et sont accessibles à 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 qu’un système 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.

La responsabilité de seconde de la mémoire tampon de texte est la persistance du fichier.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

Modification des paramètres de la vue à l’aide de l’API héritéeChanging View Settings by Using the Legacy API
Explique comment modifier les paramètres d’affichage à l’aide de l’API héritée.Explains how to change view settings using the legacy API.

À l’aide du Gestionnaire de texte pour surveiller des paramètres globauxUsing the Text Manager to Monitor Global Settings
Explique comment utiliser le Gestionnaire de texte pour contrôler les paramètres globaux...Explains how to use the text manager to monitor global settings..

Voir aussiSee Also

Dans l’éditeur de baseInside the Core Editor