Bookmark (control)
El control Bookmark es un marcador que tiene un nombre único, expone eventos y se puede enlazar a datos. El marcador se puede usar como marcador de posición para marcar un elemento o una ubicación en un documento de Microsoft Office Word. El control Bookmark s una combinación de un objeto Bookmark y un objeto Range .
Se aplica a: la información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para Word. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.
En proyectos de nivel de documento, puede agregar controles Bookmark al documento en tiempo de diseño o en tiempo de ejecución. En proyectos de complemento VSTO, puede agregar controles Bookmark a cualquier documento abierto en tiempo de ejecución. Para obtener más información, vea How to: Add Bookmark controls to Word documents.
Enlace de datos al control
Un control Bookmark admite el enlace de datos simple. El marcador se debe enlazar a un origen de datos mediante la propiedad DataBindings . La propiedad de enlace de datos predeterminada del marcador es la propiedad Text .
Si se actualizan los datos del conjunto de datos enlazado, el Bookmark control muestra los cambios.
En los proyectos de nivel de documento, puede enlazar datos a marcadores mediante la ventana Orígenes de datos . Para obtener más información, vea Cómo: Rellenar documentos con datos de objetos.
Formateo
El formato que se puede aplicar a un control Bookmark también puede aplicarse a un control Bookmark . Este formato incluye fuentes, sangrías, 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 es cómo se comporta cuando se asigna texto al marcador. Si se asigna texto a un Microsoft.Office.Interop.Word.Bookmarkde 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.Bookmarkde 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 también tiene la propiedad Bookmark.Text . Esta propiedad es diferente de la Range.Text propiedad que está disponible en la Bookmark.Range propiedad de un Microsoft.Office.Tools.Word.Bookmark control o la Bookmark.Range propiedad de un Microsoft.Office.Interop.Word.Bookmark objeto .
| Propiedad Text | Descripción |
|---|---|
| Bookmark.Text | Use 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 el marcador. Por ejemplo, Bookmark1.Text = "Hello world" inserta el texto en el marcador y deja el marcador intacto. |
| Range.Text | Use 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 del control en tiempo de diseño
En los proyectos de nivel de documento, si arrastra un control Bookmark desde el Cuadro de herramientas hasta el documento, Visual Studio genera automáticamente un nombre para el control. Puede cambiar el nombre del control en la ventana Propiedades .
Controles superpuestos
Los controles de marcador se pueden superponer entre sí. Más de un marcador puede compartir el mismo texto. Al asignar texto nuevo a uno de los marcadores superpuestos, solo contiene el texto nuevo y los marcadores ya no se superponen. El otro marcador ahora contiene solo el texto que no se ha compartido entre los marcadores superpuestos originales.
En la tabla siguiente se muestra cómo dos marcadores superpuestos comparten la frase "Este es texto de ejemplo".
| Marcador | Texto |
|---|---|
| Marcadores superpuestos | [this is {sample] text.} |
| Bookmark1 | This is sample |
| Bookmark2 | sample text. |
Si asigna el nuevo texto "This is replacement" a Bookmark1, los marcadores no se superponen y Bookmark2 conserva solo el texto que no formaba parte originalmente de Bookmark1.
| Marcador | Texto |
|---|---|
| Dos marcadores independientes | [this is replacement]{ text.} |
| Bookmark1 | This is replacement |
| Bookmark2 | texto. |
Si cambia el texto de un marcador que contiene otro marcador, el marcador interno no se elimina. Sin embargo, el marcador interno se convierte en un marcador vacío y se mueve al final del marcador externo.
En la tabla siguiente se muestra cómo un marcador que contiene otro marcador comparte la frase "Este es texto de ejemplo".:
| Marcador | Texto |
|---|---|
| Marcadores superpuestos | [this is {sample} text.] |
| Bookmark1 | This is sample text. |
| Bookmark2 | sample |
Si asigna el nuevo texto "This is replacement" a Bookmark1, los marcadores ya no se superponen y Bookmark2 se convierte en un marcador vacío que se encuentra al final de Bookmark1.
| Marcador | Texto |
|---|---|
| Dos marcadores independientes | [this is replacement.]{} |
| Bookmark1 | This is replacement. |
| Bookmark2 | <empty> |
Eventos
Los eventos siguientes están disponibles para el control Bookmark :