Agregar controles bookmark a documentos de Word

  • Artículo

En proyectos de nivel de documento, puede agregar controles Bookmark al documento en el proyecto 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.

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 este tema se describen las tareas siguientes:

Agregar controles bookmark en tiempo de diseño

Hay varias maneras de agregar controles Bookmark al documento en un proyecto de nivel de documento en tiempo de diseño:

  • Desde el Cuadro de herramientasde Visual Studio.

    Puede arrastrar el control Bookmark desde el Cuadro de herramientas hasta su documento. Este método es recomendable si ya está usando el Cuadro de herramientas para agregar controles de Windows Forms al documento.

  • Desde dentro de Word.

    Puede agregar el control Bookmark al documento de la misma manera que agregaría el marcador nativo. La ventaja de agregarlo de esta manera es que puede asignarle el nombre al control al crearlo.

  • Desde la ventana Orígenes de datos .

    Puede arrastrar el control Bookmark a su documento desde la ventana Orígenes de datos . Esto es útil cuando se desea enlazar el control a los datos al mismo tiempo. Puede agregar el control host de la misma manera que agregaría un control de Windows Forms desde la ventana Orígenes de datos . Para obtener más información, consulte Enlace de datos y Formularios Windows Forms.

    Nota:

    Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Para agregar un control Bookmark a un documento desde el Cuadro de herramientas

  1. Abra el Cuadro de herramientas y haga clic en la pestaña Controles de Word .

  2. Arrastre un control Bookmark al documento.

    Aparecerá el cuadro de diálogo Agregar marcador .

  3. Seleccione el texto u otros elementos que desee incluir en el marcador.

  4. Haga clic en OK.

    Si no desea conservar el nombre de marcador predeterminado, puede cambiar el nombre en la ventana Propiedades .

Para agregar un control Bookmark a un documento en Word

  1. En el documento hospedado en el diseñador de Visual Studio, coloque el cursor donde desea agregar el marcador o seleccione el texto que desea que el marcador incluya.

  2. En la pestaña Insertar de la cinta, en el grupo Vínculos , haga clic en el botón Marcador .

  3. En el cuadro de diálogo Marcador , escriba el nombre del nuevo marcador y haga clic en Agregar.

Agregar controles Bookmark en tiempo de ejecución en un proyecto de nivel de documento

Puede agregar controles Bookmark mediante programación al documento en tiempo de ejecución con métodos de la propiedad Controls de la clase ThisDocument en el proyecto. Hay dos sobrecargas de método que puede usar para agregar un control Bookmark de las maneras siguientes:

Para agregar un control Bookmark mediante programación a un documento

  1. En el controlador de eventos ThisDocument_Startup de su proyecto, inserte el siguiente código para agregar el control Bookmark al primer párrafo del documento.

    Microsoft.Office.Tools.Word.Bookmark firstParagraph;
firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
    "FirstParagraph");

    Nota:

    Si desea crear un control Bookmark desde un Bookmarkexistente, use el método AddBookmark y pase el Bookmarkexistente.

Agregar controles Bookmark en tiempo de ejecución en un proyecto de complemento de VSTO

Puede agregar controles Bookmark mediante programación a cualquier documento abierto en tiempo de ejecución a través de un complemento de VSTO. Para ello, genere un elemento host Document basado en un documento abierto y, a continuación, use métodos de la propiedad Controls de este elemento host. Hay dos sobrecargas de método que puede usar para agregar un control Bookmark de las maneras siguientes:

Para agregar un control Bookmark en un intervalo especificado

  1. Use el método AddBookmark y pase el Range donde desea agregar el Bookmark.

    El siguiente ejemplo de código agrega un nuevo Bookmark al principio del documento activo. Para usar este ejemplo, ejecute el código del controlador de eventos ThisAddIn_Startup en un proyecto de complemento de VSTO de Word.

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
    extendedDocument.Paragraphs[1].Range, "FirstParagraph");

Para agregar un control Bookmark que se base en un control Bookmark nativo

  1. Use el método AddBookmark y pase el Bookmark existente que desee usar como base para el nuevo Bookmark.

    En el siguiente ejemplo de código se crea un nuevo Bookmark que se basa en el primer Bookmark del documento activo. Para usar este ejemplo, ejecute el código del controlador de eventos ThisAddIn_Startup en un proyecto de complemento de VSTO de Word.

    if (this.Application.ActiveDocument.Bookmarks.Count > 0)
{
    object index = 1;
    Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);


     Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

    Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
            firstBookmark, "VSTOBookmark");
}

Contenido relacionado