Bookmark (Control)
Actualización: Julio de 2008
Se aplica a |
|---|
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Proyectos de nivel de documento
Proyectos de nivel de aplicación
Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto. |
El control Bookmark es un marcador que tiene un nombre único, expone eventos y se puede enlazar a datos. El marcador se puede utilizar como marcador de posición para marcar un elemento o una ubicación en un documento de Microsoft Office Word.
El control Bookmark es una combinación de un objeto Microsoft.Office.Interop.Word.Bookmark y un objeto Microsoft.Office.Interop.Word.Range. Al agregar un marcador a un documento, Visual Studio Tools para Office crea un objeto de marcador que se puede programar directamente sin tener que atravesar el modelo de objetos de Word.
En proyectos en el nivel del documento, puede agregar controles Bookmark al documento en tiempo de diseño o en tiempo de ejecución. A partir de Visual Studio 2008 Service Pack 1 (SP1), también puede agregar controles Bookmark en tiempo de ejecución a cualquier documento abierto utilizando un complemento en el nivel de la aplicación para Word 2007. Para obtener más información, vea Cómo: Agregar controles Bookmark a documentos de Word.
Enlazar datos al control
Un control Bookmark admite un enlace de datos simple. El marcador se debe enlazar al origen de datos mediante la propiedad DataBindings. La propiedad de enlace de datos predeterminada del marcador es Text.
Si los datos del conjunto de datos enlazado se actualizan, el control Bookmark reflejará los cambios.
En los proyectos en el nivel del documento, también puede enlazar datos a marcadores en la ventana Orígenes de datos. Para obtener más información, vea Cómo: Rellenar documentos con datos de objetos.
Formato
El formato que puede aplicarse a Microsoft.Office.Interop.Word.Bookmark también puede aplicarse a un control Bookmark. Esto incluye fuentes, sangría, espaciado, numeración y estilos.
Asignar texto al marcador
Una diferencia adicional entre un objeto Microsoft.Office.Interop.Word.Bookmark y un control Bookmark radica en cómo se comporta cuando se asigna texto al marcador. Si se asigna texto a un Microsoft.Office.Interop.Word.Bookmark de longitud cero, el texto se anexa a la derecha del marcador y el marcador conserva la longitud cero. Sin embargo, si se asigna texto a un Bookmark de longitud cero, el texto se inserta en el marcador y la longitud del marcador se expande hasta el número total de caracteres insertados.
Además, Visual Studio Tools para Office agrega una propiedad Bookmark.Text al control Bookmark. Esto es diferente de la propiedad Range.Text que está disponible en el objeto Range del marcador.
Propiedad Text |
Descripción |
|---|---|
Utilice esta propiedad para mostrar el texto del marcador y dejar el marcador en el documento. Al asignar texto al marcador, se expande el intervalo del marcador y no se elimina. Por ejemplo, Bookmark1.Text = "Hello world" inserta el texto en el marcador y deja el marcador intacto. |
|
Utilice esta propiedad para mostrar texto en la ubicación del marcador y eliminar automáticamente el marcador. Por ejemplo, Bookmark1.Range.Text = "Hello world" inserta el texto en el marcador y elimina el marcador. |
Cambiar el nombre de un control en tiempo de diseño
En los proyectos en el nivel del documento, cuando se arrastra un control Bookmark desde el Cuadro de herramientas al documento, Visual Studio Tools para Office genera automáticamente un nombre para el control. Se puede cambiar el nombre del control en la ventana Propiedades.
Controles superpuestos
Los controles Bookmark se pueden superponer entre sí, es decir, más de un marcador puede compartir el mismo texto. Al asignar nuevo texto a uno de los marcadores superpuestos, contendrá sólo el nuevo texto y los marcadores dejarán de superponerse. El otro marcador contendrá sólo el texto no compartido entre los marcadores que inicialmente estaban superpuestos.
La tabla siguiente muestra cómo dos marcadores superpuestos comparten la frase "This is sample text.".
Bookmark |
Texto |
|---|---|
Marcadores superpuestos |
[this is {sample] text.} |
Bookmark1 |
This is sample |
Bookmark2 |
sample text. |
Si asigna el nuevo texto "This is replacement." al marcador Bookmark1, los marcadores ya no se superpondrán y Bookmark2 conservará sólo el texto que no formaba inicialmente parte del marcador Bookmark1.
Bookmark |
Texto |
|---|---|
Dos marcadores independientes |
[this is replacement]{ text.} |
Bookmark1 |
This is replacement |
Bookmark2 |
text. |
Si un marcador está totalmente contenido en otro marcador y se cambia el texto del marcador exterior, el marcador interno no se elimina. Sin embargo, el marcador interno se vuelve un marcador vacío que se desplaza al final del marcador exterior. La tabla siguiente muestra cómo un marcador que está contenido en otro marcador comparte con él la frase "This is sample text.".
Bookmark |
Texto |
|---|---|
Marcadores superpuestos |
[this is {sample} text.] |
Bookmark1 |
This is sample text. |
Bookmark2 |
sample |
Si asigna el nuevo texto "This is replacement." al marcador Bookmark1, los marcadores ya no se superpondrán y Bookmark2 se convertirá en un marcador vacío situado al final de Bookmark1.
Bookmark |
Texto |
|---|---|
Dos marcadores independientes |
[this is replacement.]{} |
Bookmark1 |
This is replacement. |
Bookmark2 |
<vacío> |
Eventos
Los siguientes eventos están disponibles para el control Bookmark:
Vea también
Tareas
Cómo: Agregar controles Bookmark a documentos de Word
Tutorial: Crear menús de acceso directo para marcadores
Conceptos
Limitaciones de programación de elementos y controles Host
Otros recursos
Historial de cambios
Fecha |
Historial |
Motivo |
|---|---|---|
|
Julio de 2008 |
Información agregada sobre cómo utilizar controles de marcadores en proyectos en el nivel de la aplicación. |
Cambio de características de SP1. |