Como: Atualizar o texto do indicador

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Projetos de nível de aplicativo Versão do Microsoft Office Word 2003 Word 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de documento
Projetos de nível de aplicativo

Versão do Microsoft Office

Word 2003
Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode inserir texto em um indicador de espaço reservado em um documento do Microsoft Office Word para que você possa recuperar o texto em um momento posterior, ou para substituir o texto em um indicador.Se você estiver desenvolvendo uma personalização de nível de documento, você também pode atualizar texto em um Controlarar Microsoft.Office.Tools.Word.Bookmark que é Ligado a dados.For more information, see Vinculando dados a controles.

O objeto de indicador pode ser um dos dois tipos:

Um Controlarar de host Microsoft.Office.Tools.Word.Bookmark.

Controles de Microsoft.Office.Tools.Word.Bookmark estendem nativo Microsoft.Office.Interop.Word.Bookmark objetos, permitindo a ligação de dados e expor eventos.Para obter mais informações sobre controles de host, consulte Itens de host e Visão geral sobre controles de host.
Um objeto nativo Microsoft.Office.Interop.Word.Bookmark.

Objetos de Microsoft.Office.Interop.Word.Bookmark não têm recursos de ligação de eventos ou dados.

Quando você Atribuir texto para um indicador, o comportamento difere entre um Microsoft.Office.Interop.Word.Bookmark e um Microsoft.Office.Tools.Word.Bookmark.For more information, see Indicador de Controlarar.

Usando controles de host

Para atualizar o conteúdo de indicador usando um Controlarar de indicador

Criar um procedimento que leva um argumento de bookmark para o nome do indicador e um argumento de newText para a Cadeia de Caracteres atribuir à propriedade Text.

Observação:
Atribuir texto para o Bookmark.Text ou propriedade de Bookmark.FormattedText de um Controlarar de Microsoft.Office.Tools.Word.Bookmark não causa o indicador a ser excluído.

Shared Sub BookMarkReplace( _
    ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
    ByVal newText As String)

static void BookMarkReplace(
    ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
    string newText)
{

Atribuir a Cadeia de Caracteres de newText para a propriedade Text a Microsoft.Office.Tools.Word.Bookmark.
```
    bookmark.Text = newText
End Sub
```
```
    bookmark.Text = newText;
}
```

Usando objetos do Word

Para atualizar o conteúdo de indicador usando um objeto de indicador do Word

Criar um procedimento que tem um argumento de bookmark para o nome da Microsoft.Office.Interop.Word.Bookmarke um argumento de newText para a Cadeia de Caracteres atribuir para a propriedade Range.Text do indicador.

Observação:

Atribuir texto a uma palavra de Nativo Objeto Microsoft.Office.Interop.Word.Bookmark faz com que o indicador a ser excluído.
```
Friend Sub BookMarkReplaceNative( _
    ByVal bookmark As Word.Bookmark, _
    ByVal newText As String)
```
```
internal void BookMarkReplaceNative(
    Word.Bookmark bookmark, 
    string newText)
{
```

Observação:
Atribuir texto a uma palavra de Nativo Objeto Microsoft.Office.Interop.Word.Bookmark faz com que o indicador a ser excluído.

Atribuir a Cadeia de Caracteres newText na propriedade Range.Text do indicador, que exclui automaticamente o indicador.Em seguida, adicionar novamente o indicador para a coleção Bookmarks.

O exemplo de código a seguir pode ser usado em uma personalização de nível de documento.

    Dim rng As Word.Range = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText

    Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    this.Bookmarks.Add(bookmarkName, ref rng); 
}

O exemplo de código a seguir pode ser usado em um nível de aplicativo Adicionar - in.Este exemplo usa o documento ativo.

    Dim rng As Object = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText
    Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    Word.Document document = this.Application.ActiveDocument;
    document.Bookmarks.Add(bookmarkName, ref rng);
}

Consulte também

Tarefas

Como: Inserir texto em documentos do Word

Conceitos

Palavra Overview do modelo de objeto

Indicador de Controlarar

Compartilhar via