Bookmark (Control)
El control Microsoft.Office.Tools.Word.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 Microsoft.Office.Tools.Word.Bookmark es una combinación de un objeto Microsoft.Office.Interop.Word.Bookmark y un objeto Microsoft.Office.Interop.Word.Range.
Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.
En proyectos en el nivel del documento, puede agregar controles Microsoft.Office.Tools.Word.Bookmark al documento en tiempo de diseño o en tiempo de ejecución. En los proyectos de nivel de aplicación, puede agregar controles Microsoft.Office.Tools.Word.Bookmark a cualquier documento abierto en tiempo de ejecución. Para obtener más información, vea Cómo: Agregar controles Bookmark a documentos de Word.
Enlazar datos al control
Un control Microsoft.Office.Tools.Word.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 Microsoft.Office.Tools.Word.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 Microsoft.Office.Tools.Word.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 Microsoft.Office.Tools.Word.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 Microsoft.Office.Tools.Word.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.
El control Microsoft.Office.Tools.Word.Bookmark tiene también la propiedad Bookmark.Text. Difiere de la propiedad Range.Text que está disponible en la propiedad Range de un control Microsoft.Office.Tools.Word.Bookmark o la propiedad Range de un objeto Microsoft.Office.Interop.Word.Bookmark.
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 de nivel de documento, cuando se arrastra un control Microsoft.Office.Tools.Word.Bookmark desde el Cuadro de herramientas hasta el documento, Visual Studio 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.".
Marcador |
Text |
|---|---|
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á solo el texto que no formaba parte inicialmente del marcador Bookmark1.
Bookmark |
Text |
|---|---|
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 incluido en otro marcador comparte con él la frase "This is sample text.".
Marcador |
Text |
|---|---|
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.
Marcador |
Text |
|---|---|
Dos marcadores independientes |
[this is replacement.]{} |
Bookmark1 |
This is replacement. |
Bookmark2 |
<vacío> |
Eventos
Los siguientes eventos están disponibles para el control Microsoft.Office.Tools.Word.Bookmark:
Vea también
Tareas
Cómo: Agregar controles Bookmark a documentos de Word
Tutorial: Crear menús de acceso directo para marcadores
Conceptos
Automatizar Word con objetos extendidos
Limitaciones de programación de elementos y controles Host