Como: Redimensionar controles de indicador

Artigo
08/08/2011

Definir o tamanho de um Bookmark o controle quando você adicioná-lo a um documento do Word de Microsoft Office. Você também pode redimensioná-lo em um momento posterior.

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.

Há três maneiras de redimensionar um indicador:

Adicionar ou remover o texto de Bookmark de controle.

Sempre que você adicionar texto em um indicador, o tamanho do indicador aumenta automaticamente para conter o novo texto. Quando você exclui o texto, o tamanho do indicador diminui automaticamente.
Alterar o Start e End Propriedades da Bookmark de controle.

Isso é útil se você estiver alterando o tamanho por poucos caracteres.
Recriar o Bookmark de controle.

Isso é útil se houver uma alteração substancial no tamanho ou local de um indicador.

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. For more information, see Como: Adicionar controles de indicador para documentos do Word.

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.

Alterando o início e propriedades de fim

Para redimensionar um indicador em um projeto de nível de documento em tempo de design

Selecione o indicador de Propriedades janela.
Aumentar ou diminuir o valor de Start propriedade.
Aumentar ou diminuir o valor de End propriedade.

Para redimensionar um indicador em um projeto de nível de documento em tempo de execução

Modificar o Start e End Propriedades de um Bookmark criado em tempo de execução ou em tempo de design.

O exemplo de código a seguir adiciona cinco caracteres para o início de um indicador chamado SampleBookmark. Esse código pressupõe que há no mínimo cinco caracteres de texto antes do indicador.
```
Me.SampleBookmark.Start = Me.SampleBookmark.Start - 5
```
```
this.SampleBookmark.Start = this.SampleBookmark.Start - 5;
```
O exemplo de código a seguir adiciona cinco caracteres ao final do mesmo indicador. Esse código pressupõe que há no mínimo cinco caracteres de texto depois do indicador.
```
Me.SampleBookmark.End = Me.SampleBookmark.End + 5
```
```
this.SampleBookmark.End = this.SampleBookmark.End + 5;
```

Para redimensionar um indicador em um projeto de nível de aplicativo em tempo de execução

Modificar o Start e End Propriedades de um Bookmark criado em tempo de execução.

O exemplo de código a seguir cria um Bookmark que contém o texto do primeiro parágrafo do documento ativo e, em seguida, remove cinco caracteres de início e fim da Bookmark.

' Use the following line of code in projects that target the .NET Framework 4.
Dim VstoDocument As Microsoft.Office.Tools.Word.Document = _
    Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

' In projects that target the .NET Framework 3.5, use the following line of code.
' Dim vstoDocument As Microsoft.Office.Tools.Word.Document = _
'     Me.Application.ActiveDocument.GetVstoObject()

vstoDocument.ActiveWindow.View.ShowBookmarks = True
vstoDocument.Paragraphs(1).Range.InsertParagraphBefore()

Dim firstParagraph As Word.Range = vstoDocument.Paragraphs(1).Range
firstParagraph.Text = "123456789abcdefghijklmnopqrstuvwxyz"

Dim sampleBookmark As Microsoft.Office.Tools.Word.Bookmark = _
    vstoDocument.Controls.AddBookmark(firstParagraph, "bookmark1")
sampleBookmark.Start = sampleBookmark.Start + 5
sampleBookmark.End = sampleBookmark.End - 5

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

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

vstoDocument.ActiveWindow.View.ShowBookmarks = true;
vstoDocument.Paragraphs[1].Range.InsertParagraphBefore();

Word.Range firstParagraph = vstoDocument.Paragraphs[1].Range;
firstParagraph.Text = "123456789abcdefghijklmnopqrstuvwxyz";

Microsoft.Office.Tools.Word.Bookmark sampleBookmark =
    vstoDocument.Controls.AddBookmark(firstParagraph, "bookmark1");
sampleBookmark.Start = sampleBookmark.Start + 5;
sampleBookmark.End = sampleBookmark.End - 5;

Recriando o indicador

Você pode redimensionar um indicador em um projeto de nível de documento, adicionando um novo indicador que tem o mesmo nome que o indicador existente, mas que possui um tamanho diferente.

Para recriar um indicador em um projeto de nível de documento em tempo de design

Selecione o texto a ser incluído nos novos Bookmark de controle.
Sobre o Inserir menu, clique em indicador.
No indicador caixa de diálogo, selecione o nome do indicador que você deseja redimensionar e clique em Add.

Consulte também

Tarefas

Como: Adicionar controles de indicador para documentos do Word

Como: Redimensionar controles de NamedRange

Como: Redimensionar controles de ListObject

Conceitos

Automatizar o Word usando o Extended objetos

Itens de host e a visão geral sobre controles de Host

Limitações de programação de itens de Host e controles de Host

Compartilhar via