Compartilhar via


Adicionar controles Bookmark a documentos do Word

Em projetos de nível de documento, você pode adicionar Bookmark controles ao documento em seu projeto em tempo de design ou em tempo de execução. Em projetos de suplemento VSTO, você pode adicionar Bookmark controles a qualquer documento aberto em tempo de execução.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Este tópico descreve as seguintes tarefas:

Adicionar controles de Marcador em Tempo de Design

Há várias maneiras de adicionar Bookmark controles ao documento em um projeto de nível de documento em tempo de design:

  • Na caixa de ferramentas do Visual Studio.

    Você pode arrastar o controle da caixa de ferramentas para o Bookmark documento. Talvez você queira escolher essa maneira se já estiver usando a Caixa de Ferramentas para adicionar controles do Windows Forms ao documento.

  • De dentro do Word.

    Você pode adicionar o controle ao documento da mesma maneira que adicionaria o Bookmark indicador nativo. A vantagem de adicioná-lo dessa maneira é que você pode nomear seu controle no momento em que o cria.

  • Na janela Fontes de Dados .

    Você pode arrastar o controle para o Bookmark documento a partir da janela Fontes de Dados . Isso é útil quando você deseja vincular o controle aos dados ao mesmo tempo. Você pode adicionar o controle de host da mesma forma que adicionaria um controle de formulário do Windows a partir da janela Fontes de Dados . Para obter mais informações, consulte Vinculação de dados e Windows Forms.

    Observação

    Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE.

Para adicionar um controle Bookmark a um documento a partir da Caixa de Ferramentas

  1. Abra a caixa de ferramentas e clique na guia Controles do Word.

  2. Arraste um Bookmark controle para o documento.

    A caixa de diálogo Adicionar Marcador é exibida.

  3. Selecione o texto ou outros itens que você deseja incluir no marcador.

  4. Clique em OK.

    Se não quiser manter o nome do indicador padrão, você pode alterar o nome na janela Propriedades .

Para adicionar um controle Bookmark a um documento no Word

  1. No documento hospedado no designer do Visual Studio, coloque o cursor onde você deseja adicionar o indicador ou selecione o texto que você deseja que o indicador coloque.

  2. Na guia Inserir da Faixa de Opções, no grupo Vínculos, clique no botão Indicador.

  3. Na caixa de diálogo Indicador, digite o nome do novo indicador e clique em Adicionar.

Adicionar controles Bookmark em tempo de execução em um projeto de nível de documento

Você pode adicionar Bookmark controles programaticamente ao documento em tempo de execução usando métodos da propriedade da Controls ThisDocument classe em seu projeto. Há duas sobrecargas de método que você pode usar para adicionar um Bookmark controle das seguintes maneiras:

  • Adicione um em um Bookmark intervalo especificado.

  • Adicione um que se baseia em um indicador nativo no documento (ou seja, um Bookmark Bookmark).

    Os controles criados Bookmark dinamicamente não são persistentes no documento quando o documento é fechado. No entanto, um nativo Bookmark permanece no documento. Você pode recriar um indicador baseado em um Bookmark indicador nativo na próxima vez que o documento for aberto. Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle Bookmark a um documento programaticamente

  1. ThisDocument_Startup No manipulador de eventos em seu projeto, insira o código a seguir para adicionar o Bookmark controle ao primeiro parágrafo do documento.

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

    Observação

    Se você quiser criar um controle a partir de um Bookmark Bookmark, use o método e passe o AddBookmark existente Bookmark.

Adicionar controles Bookmark em tempo de execução em um projeto de suplemento VSTO

Você pode adicionar Bookmark controles programaticamente a qualquer documento aberto em tempo de execução usando um suplemento VSTO. Para fazer isso, gere um item de host baseado em um Document documento aberto e, em seguida, use métodos da propriedade desse item de Controls host. Há duas sobrecargas de método que você pode usar para adicionar um Bookmark controle das seguintes maneiras:

Para adicionar um controle Bookmark em um intervalo especificado

  1. Use o AddBookmark método e passe para onde você deseja adicionar o Range Bookmark.

    O exemplo de código a seguir adiciona um novo Bookmark ao início do documento ativo. Para usar este exemplo, execute o ThisAddIn_Startup código do manipulador de eventos em um projeto de suplemento VSTO do Word.

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
    
    Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
        extendedDocument.Paragraphs[1].Range, "FirstParagraph");
    

Para adicionar um controle Bookmark baseado em um controle Bookmark nativo

  1. Use o método e passe o existente Bookmark que você deseja usar como base para o AddBookmark novo Bookmark.

    O exemplo de código a seguir cria um novo Bookmark que é baseado no primeiro Bookmark no documento ativo. Para usar este exemplo, execute o ThisAddIn_Startup código do manipulador de eventos em um projeto de suplemento VSTO do 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");
    }