Obtener acceso al búfer de texto mediante la API heredadoAccessing the Text Buffer by Using the Legacy API

El texto es responsable de administrar secuencias de texto y persistencia de archivo.The text is responsible for managing text streams and file persistence. Aunque el búfer puede leer o escribir otros formatos, todas las comunicaciones normales con el búfer se realizan mediante Unicode.Although the buffer can read or write other formats, all ordinary communication with the buffer is performed by using Unicode. En las API heredadas, el búfer de texto puede utilizar uno - o un sistema de coordenadas bidimensional para identificar las ubicaciones de carácter en el búfer.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.

Dimensión de uno y dos sistemas de coordenadasOne- and Two-Dimension Coordinate Systems

Unidimensional coordenadas de la posición se basan en la posición del carácter desde el primer carácter en el búfer, como 147.A one-dimensional coordinate position is based on a character's position from the first character in the buffer, such as 147. Usa el IVsTextStream interfaz para tener acceso a una ubicación unidimensional en el búfer.You use the IVsTextStream interface to access a one-dimensional location in the buffer. Un sistema de coordenadas bidimensional se basa en pares de línea y de índice.A two-dimensional coordinate system is based on line and index pairs. Por ejemplo, un carácter en el búfer 43, 5 podría estar en línea 43, cinco caracteres a la derecha del primer carácter en esa línea.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. Obtener acceso a una ubicación bidimensional en el búfer mediante el IVsTextLines interfaz.You access a two-dimensional location in the buffer using the IVsTextLines interface. Tanto el IVsTextLines y IVsTextStream interfaces que implementa el objeto de búfer de texto (VsTextBuffer) y son accesibles entre sí mediante el uso 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. El diagrama siguiente muestra estas y otras interfaces de clave en VsTextBuffer.The following diagram shows these and other key interfaces on VsTextBuffer.

Objeto de búfer de textoText Buffer Object
Objeto de búfer de textoText buffer object

Aunque cualquier sistema de coordenadas funciona en el búfer de texto, se optimiza para usar coordenadas bidimensionales.Although either coordinate system works in the text buffer, it is optimized to use two-dimensional coordinates. Un sistema de coordenadas unidimensional puede crear una sobrecarga de rendimiento.A one-dimensional coordinate system can create performance overhead. Por lo tanto, utilice el sistema de coordenadas bidimensional siempre que sea posible.Therefore, use the two-dimensional coordinate system whenever possible.

La responsabilidad de segundo del búfer de texto es la persistencia de archivo.The text buffer's second responsibility is file persistence. Para ello, el objeto de búfer de texto implementa IVsPersistDocData2 y actúa como el componente de objeto de datos de documentos para elementos de proyecto y otros componentes del entorno implicadas en la persistencia.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. Para obtener más información, consulte abrir y guardar elementos de proyecto.For more information, see Opening and Saving Project Items.

En esta secciónIn This Section

Cambiar la configuración de la vista mediante la API heredadoChanging View Settings by Using the Legacy API
Explica cómo cambiar la configuración de vista mediante la API heredada.Explains how to change view settings using the legacy API.

Uso del Administrador de texto para supervisar la configuración GlobalUsing the Text Manager to Monitor Global Settings
Explica cómo utilizar el Administrador de texto para supervisar la configuración global...Explains how to use the text manager to monitor global settings..

Vea tambiénSee Also

Dentro del Editor de núcleoInside the Core Editor