Como: adicionar controles de indicador aos documentos do Word

Artigo
02/25/2013

Em projetos de um documento nível, você pode adicionar controles de Bookmark ao documento em seu projeto em tempo de design ou em tempo de execução.Em projetos de aplicativo, você pode adicionar controles de Bookmark a qualquer documento aberto em 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 2013 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:

Adicionando controles do indexador em tempo de design
Adicionando controles do indexador em tempo de execução em um projeto de um documento nível
Adicionando controles do indexador em tempo de execução em um projeto de nível de aplicativo

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

Adicionando controles do indexador em tempo de design

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

Visual Studio Caixa de Ferramentas.

Você pode arrastar o controle de Bookmark de Caixa de Ferramentas no seu documento.Você pode desejar escolher essa maneira se você já está usando Caixa de Ferramentas para adicionar controles de formulários do windows no seu documento.
De dentro da palavra.

Você pode adicionar o controle de Bookmark no seu documento da mesma maneira que você adicionaria o indexador nativo.A vantagem de adicioná-lo essa maneira é que você pode nomear o controle no momento que você o cria.
De a janela de Fontes de Dados .

Você pode arrastar o controle de Bookmark no seu documento da janela de Fontes de Dados .Isso é útil quando você deseja associar ao mesmo tempo o controle a dados.Você pode adicionar o controle do host da mesma maneira que você adicionaria um controle windows form da janela de Fontes de Dados .Para obter mais informações, consulte 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 de Visual Studio.

Para adicionar um controle do indexador a um documento da caixa de ferramentas

Abra Caixa de Ferramentas e clique na guia de Controles do word.
Arraste um controle de Bookmark ao documento.

a caixa de diálogo de Adicione o indexador aparece.
Selecione o texto ou outros itens que você deseja incluir no indexador.
Clique em OK.

Se você não desejar manter o nome padrão do marcador, você pode alterar o nome na janela de Propriedades .

Para adicionar um controle do indexador a um documento no word

Em o documento que é hospedado no designer de Visual Studio , coloque o cursor onde você deseja adicionar o marcador, ou para selecionar o texto que você deseja que o indicador para incluir.
Em a guia de Inserir de fita, no grupo de Links , clique no botão de Indicador .
Em a caixa de diálogo de Indicador , digite o nome do novo marcador, e clique Adicionar.

Adicionando controles do indexador em tempo de execução em um projeto de um documento Nível

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

Adicione Bookmark em um intervalo especificado.
Adicione Bookmark que é baseado em um indexador nativo no documento (isto é, Microsoft.Office.Interop.Word.Bookmark).

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

Para adicionar um controle programaticamente do indexador a um documento

Em o manipulador de eventos de ThisDocument_Startup em seu projeto, insira o código a seguir para adicionar o controle de Bookmark para o primeiro parágrafo no 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ê deseja criar um controle de Microsoft.Office.Tools.Word.Bookmark de Microsoft.Office.Interop.Word.Bookmarkexistente, use o método de AddBookmark e passar em Microsoft.Office.Interop.Word.Bookmarkexistente.

Adicionando controles do indexador em tempo de execução em um projeto de Nível de aplicativo

Você pode adicionar controles de Bookmark programaticamente a qualquer documento aberto em tempo de execução usando um suplemento ao aplicativo.Para fazer isso, gerar um item de host de Document baseado em um documento aberto, e então usar métodos de propriedade de Controls de este item host.Há duas sobrecargas do método que você pode usar as seguintes maneiras para adicionar um controle de Bookmark :

Adicione Bookmark em um intervalo especificado.
Adicione Bookmark que é baseado em um indexador nativo no documento (isto é, Microsoft.Office.Interop.Word.Bookmark).

Os controles criados dinamicamente de Bookmark não são persistentes no documento quando o documento é fechado.Em o entanto, Microsoft.Office.Interop.Word.Bookmark nativo permanece no documento.Você pode recriar Bookmark que é baseado em um indexador nativo o documento está aberto na próxima vez que.Para obter mais informações, consulte Persisting controles dinâmicos em documentos do Office.

Para obter mais informações sobre como gerar host itens em projetos 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 marcador controle em um intervalo especificado

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

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

Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)


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

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


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

Para adicionar um marcador controle baseado em um controle nativo do indexador

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

O exemplo de código cria um novo Bookmark que é baseado em primeiro Microsoft.Office.Interop.Word.Bookmark no documento ativo.Para usar este exemplo, execute o código do manipulador de eventos de ThisAddIn_Startup em um projeto do suplemento a palavra.

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

    Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

    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);


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

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

Consulte também

Partilhar via