Como: Adicionar indicador controles a documentos do Word

Em projetos de nível de documento, você pode adicionar controles Bookmark para o documento em seu projeto em tempo de design ou em tempo de execução.Iniciando no Visual Studio 2008 Serviço Pack 1 (SP1), você também pode adicionar Bookmark controles para qualquer Abrir documento no tempo de execução usando em um suplemento do nível de aplicativo para Word 2007.

Este tópico descreve as seguintes tarefas:

• Adicionar controles de indicador no tempo de design

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

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

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

Adicionando controles de indicador em tempo de design

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

• Do Visual Studio De caixa de ferramentas.

  Você pode arrastar o Controlarar de Bookmark de De caixa de ferramentas ao seu documento.Você pode desejar escolher dessa forma, se você já estiver usando a caixa de ferramentas para adicionar controles Windows Forms a seu documento.

• de no Word.

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

• de Dados janela de Dadosta Sources.

  Você pode arrastar o Controlarar de Bookmark ao seu documento Dados janela Dadosta Sources.Isso é útil quando você deseja Ligar o Controlarar a dados ao mesmo tempo.Você pode adicionar o Controlarar de host Dados mesma maneira que você adicionaria um Controlarar de Windows Formulário Dados janela Dadosta Sources.For more information, see Ligação de dados e o Windows Forms.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações 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, consulte Configurações do Visual Studio.

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

1. Abrir De caixa de ferramentas e clique na guia de controles do Word.

2. Arraste um Controlarar de Bookmark para o documento.

   A caixa de diálogo de adicionar indicador será exibida.

3. Selecionar o texto ou outros itens que você deseja incluir no indicador.

4. Clique em OK.

   Se desejar manter o nome de indicador padrão, você pode alterar o nome na janela Properties.

Para adicionar um Controlarar de indicador a um documento do Word

1. No documento que está hospedado no designer Visual Studio, coloque o cursor onde você deseja adicionar o indicador ou Selecionar o texto que você deseja que o indicador para incluir.

2. Execute uma das seguintes operações:

   • Para o Word 2003: No menu Inserir, clique em Indicador.

   • Para o Word 2007: Em Guia de inserir da Faixa de Opções, no AAgruparar links, clique no botão de De indicador.

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

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

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

• Adicionar um Bookmark em um intervalo especificado.

• Adicionar um Bookmark baseado em um indicador nativo no documento (ou seja, um Microsoft.Office.Interop.Word.Bookmark).

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

Para adicionar um Controlarar de indicador a um documento por programação

• No manipulador de eventos ThisDocument_Startup em seu projeto, Inserir o seguinte código para adicionar o Controlarar de Bookmark 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ê deseja criar um Controlarar de Microsoft.Office.Tools.Word.Bookmark de um existente Microsoft.Office.Interop.Word.Bookmark, use o método AddBookmark e passar a existente Microsoft.Office.Interop.Word.Bookmark.

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

Iniciando no SP1, você pode adicionar controles de Bookmark programaticamente a qualquer Abrir documento em tempo de execução, usando um suplemento em nível de aplicativo.Para fazer isso, gerar um item de host Document que se baseia uma Abrir documento e, em seguida, usar métodos da propriedade Controls deste item de host.Há duas sobrecargas do método que você pode usar para adicionar um Controlarar de Bookmark das seguintes maneiras:

• Adicionar um Bookmark em um intervalo especificado.

• Adicionar um Bookmark baseado em um indicador nativo no documento (ou seja, um Microsoft.Office.Interop.Word.Bookmark).

Controles criados dinamicamente Bookmark não são persistentes no documento quando o documento é Fechada.No entanto, um nativo Microsoft.Office.Interop.Word.Bookmark permanece no documento.Você pode recriar um Bookmark baseado em um indicador nativo a Avançar vez que o documento for aberto.For more information, see Persistência controles dinâmicos em documentos do Office.

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

Adicionar um Controlarar de indicador em um intervalo especificado

• Use o método ControlCollection.AddBookmark(Range, String) e passar a 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 manipulador de eventos em uma palavra Adicionar no projeto.

  Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()
  Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
      extendedDocument.Paragraphs(1).Range, "FirstParagraph")
  

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

Adicionar um Controlarar do indicador que se baseia em um Controlarar nativo do indicador

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

  O exemplo de código a seguir cria um novo Bookmark baseia-se a Primeiro Microsoft.Office.Interop.Word.Bookmark no documento ativo.Para usar esse exemplo, executar o código do ThisAddIn_Startup manipulador de eventos em uma palavra Adicionar no projeto.

  If Me.Application.ActiveDocument.Bookmarks.Count > 0 Then
      Dim firstBookmark As Word.Bookmark = Me.Application.ActiveDocument.Bookmarks(1)
      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);
      Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();
  
      Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
              firstBookmark, "VSTOBookmark");
  }
  

Consulte também

Tarefas

Como: Redimensionar controles de indicador

Conceitos

Itens de host e Visão geral sobre controles de host

Adicionar controles a documentos do Office em tempo de execução

Limitações através de programação de itens de host e controles de host

Programação Application-Nível Adicionar-ins

Personalizações de nível de documento de programação

Métodos de auxiliar para controles de host

Outros recursos

Controles de host do Word