Como: Adicionar controles de indicador para documentos do Word

Artigo
08/08/2011

Em projetos de nível de documento, você pode adicionar Bookmark controles para o documento em seu projeto em tempo de design ou em tempo de execução. Em projetos de nível de aplicativo, você pode adicionar Bookmark controles de qualquer documento aberto no tempo de execução.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Este tópico descreve as seguintes tarefas:

Adicionar indicador de controles em tempo de design
Adicionar indicador de controles em tempo de execução em um projeto de nível de documento
Adicionar indicador de controles em tempo de execução em um projeto de nível de aplicativo

Para obter mais informações sobre Bookmark controles, consulte Indicador de controle.

Adicionar indicador de controles em tempo de Design

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

De que o Visual Studio caixa de ferramentas.

Você pode arrastar o Bookmark de controle da caixa de ferramentas ao seu documento. Talvez você queira escolher dessa forma, se você já estiver usando o caixa de ferramentas para adicionar controles Windows Forms ao seu documento.
A partir do Word.

Você pode adicionar o Bookmark controle ao seu documento da mesma maneira, você adicionaria o indicador nativo. A vantagem de adicioná-lo dessa maneira é que você pode nomear seu controle em tempo de que criá-la.
Do Fontes de dados janela.

Você pode arrastar o Bookmark controle de documento a partir de Fontes de dados janela. Isso é útil quando você deseja vincular o controle aos dados ao mesmo tempo. Você pode adicionar o controle de host da mesma maneira que você adicionaria um controle de formulário do Windows seja o Fontes de dados janela. For more information, see Ligação de dados e o Windows Forms.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da 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, consulte Configurações do Visual Studio.

Para adicionar um controle de indicador a um documento da caixa de ferramentas

Abrir o caixa de ferramentas e clique no Controles do Word guia.
Arraste um Bookmark o controle para o documento.

O Adicionar indicador caixa de diálogo aparece.
Selecione o texto ou outros itens que você deseja incluir no indicador.
Click OK.

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

Para adicionar um controle do indicador a um documento do Word

No documento que está hospedado na Visual Studio designer, coloque o cursor onde deseja adicionar um indicador ou selecione o texto que você deseja que o indicador para delimitar.
No Inserir guia da faixa de opções, no Links de grupo, clique no indicador botão.
No indicador caixa de diálogo, digite o nome do novo marcador e clique em Add.

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

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

Adicionar um Bookmark em um intervalo especificado.
Adicionar um Bookmark que se baseia em um indicador nativo do documento (ou seja, um Microsoft.Office.Interop.Word.Bookmark).

Criado dinamicamente Bookmark controles não são persistentes no documento quando o documento é fechado. No entanto, um nativo Microsoft.Office.Interop.Word.Bookmark permanece no documento. Você pode recriar um Bookmark baseado em um indicador nativo na próxima vez em que o documento for aberto. For more information, see Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle do indicador a um documento de forma programática

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

Dim firstParagraph As Microsoft.Office.Tools.Word.Bookmark
firstParagraph = Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "FirstParagraph")

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

Observação
Se você desejar criar um Microsoft.Office.Tools.Word.Bookmark o controle de uma já existente Microsoft.Office.Interop.Word.Bookmark, use o AddBookmark método e passar a existente Microsoft.Office.Interop.Word.Bookmark.

Adicionar indicador de controles em tempo de execução em um projeto de nível de aplicativo

Você pode adicionar Bookmark controles programaticamente para qualquer documento aberto em tempo de execução usando um nível de aplicativo add-in. Para fazer isso, gerar um Document item se baseia em um documento aberto do host e use métodos da Controls a propriedade deste item de host. Há duas sobrecargas do método que você pode usar para adicionar um Bookmark o controle das seguintes maneiras:

Adicionar um Bookmark em um intervalo especificado.
Adicionar um Bookmark que se baseia em um indicador nativo do documento (ou seja, um Microsoft.Office.Interop.Word.Bookmark).

Criado dinamicamente Bookmark controles não são persistentes no documento quando o documento é fechado. No entanto, um nativo Microsoft.Office.Interop.Word.Bookmark permanece no documento. Você pode recriar um Bookmark baseado em um indicador nativo na próxima vez em que o documento for aberto. For more information, see Persistência de controles dinâmicos em documentos do Office.

Para obter mais informações sobre itens de host gerando em projetos de nível de aplicativo, consulte Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Para adicionar um controle do indicador em um intervalo especificado

Use o ControlCollection.AddBookmark(Range, String) método e passar o Range onde você deseja adicionar o Bookmark.

O exemplo de código a seguir adiciona um novo Bookmark para o início do documento ativo. Para usar esse exemplo, executar o código do ThisAddIn_Startup o manipulador de eventos em um Word add-in do projeto.

' Use the following line of code in projects that target the .NET Framework 4.
Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

' In projects that target the .NET Framework 3.5, use the following line of code.
' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()

Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
    extendedDocument.Paragraphs(1).Range, "FirstParagraph")

// Use the following line of code in projects that target the .NET Framework 4.
Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

// In projects that target the .NET Framework 3.5, use the following line of code.
// Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();

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

Para adicionar um controle do indicador se baseia em um controle nativo do indicador

Use o ControlCollection.AddBookmark(Bookmark, String) método e passar a existente Microsoft.Office.Interop.Word.Bookmark que você deseja usar como base para o novo Bookmark.

O exemplo de código a seguir cria um novo Bookmark isto é baseado no primeiro Microsoft.Office.Interop.Word.Bookmark do documento ativo. Para usar esse exemplo, executar o código do ThisAddIn_Startup o manipulador de eventos em um Word add-in do projeto.

If Me.Application.ActiveDocument.Bookmarks.Count > 0 Then
    Dim firstBookmark As Word.Bookmark = Me.Application.ActiveDocument.Bookmarks(1)

    ' Use the following line of code in projects that target the .NET Framework 4.
    Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

    ' In projects that target the .NET Framework 3.5, use the following line of code.
    ' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()

    Dim vstoBookmark As Bookmark = extendedDocument.Controls.AddBookmark( _
        firstBookmark, "VSTOBookmark")
End If

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

    // Use the following line of code in projects that target the .NET Framework 4.
    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

    // In projects that target the .NET Framework 3.5, use the following line of code.
    // Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();

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

Consulte também

Compartilhar via