Compartilhar via


controle Indicador

O controle Bookmark é um indicador que tem um nome exclusivo, expõe eventos e pode ser vinculado a dados. O indicador pode ser usado como um espaço reservado para marcar um item ou local em um documento do Microsoft Office Word. O Bookmark controle é uma combinação de um objeto e um Range Bookmark objeto.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Em projetos de nível de documento, você pode adicionar Bookmark controles ao documento em tempo de design ou em tempo de execução. Em projetos de suplemento VSTO, você pode adicionar Bookmark controles a qualquer documento aberto em tempo de execução. Para obter mais informações, consulte Como: Adicionar controles de indicador a documentos do Word.

Vincular dados ao controle

Um Bookmark controle oferece suporte à associação de dados simples. O indicador deve ser vinculado a uma fonte de dados usando a DataBindings propriedade. A propriedade de vinculação de dados padrão do indicador é a Text propriedade.

Se os dados no conjunto de dados acoplado forem atualizados, o controle mostrará Bookmark as alterações.

Em projetos de nível de documento, você também pode vincular dados a marcadores usando a janela Fontes de Dados . Para obter mais informações, consulte Como: Preencher documentos com dados de objetos.

Formatação

A formatação que pode ser aplicada a um pode ser aplicada a um Bookmark Bookmark controle. Essa formatação inclui fontes, recuos, espaçamento, numeração e estilos.

Atribuir texto ao indicador

Uma diferença adicional entre um objeto e um Microsoft.Office.Interop.Word.Bookmark Microsoft.Office.Tools.Word.Bookmark controle é como ele se comporta quando o texto é atribuído ao indicador. Se você atribuir texto a um comprimento zero, o texto será anexado à direita do indicador e o indicador permanecerá com comprimento Microsoft.Office.Interop.Word.Bookmarkzero. No entanto, se você atribuir texto a um comprimento zero, o texto será inserido no indicador e o comprimento Microsoft.Office.Tools.Word.Bookmarkdo indicador será expandido para o número total de caracteres inseridos.

O Microsoft.Office.Tools.Word.Bookmark controle também tem a Bookmark.Text propriedade. Essa propriedade é diferente da Range.Text propriedade que está disponível na propriedade de um controle ou na Bookmark.Range Bookmark.Range propriedade de um Microsoft.Office.Tools.Word.Bookmark Microsoft.Office.Interop.Word.Bookmark objeto.

Propriedade Text Descrição
Bookmark.Text Use essa propriedade para exibir texto dentro do indicador e deixar o indicador no documento. A atribuição de texto ao indicador expande o intervalo de marcadores e não exclui o marcador.

Por exemplo, Bookmark1.Text = "Hello world" insere o texto no marcador e deixa o marcador intacto.
Range.Text Use essa propriedade para exibir texto no local do indicador e excluir automaticamente o marcador. Por exemplo, Bookmark1.Range.Text = "Hello world" insere o texto no indicador e exclui o marcador.

Renomeie o controle em tempo de design

Em projetos de nível de documento, quando você arrasta um controle da caixa de ferramentas para o documento, o Visual Studio gera automaticamente um Bookmark nome para o controle. Você pode alterar o nome do controle na janela Propriedades .

Controles sobrepostos

Os controles de indicador podem se sobrepor uns aos outros. O mesmo texto pode ser compartilhado por mais de um marcador. Quando você atribui um novo texto a um dos marcadores sobrepostos, ele contém apenas o novo texto e os marcadores não se sobrepõem mais. O outro marcador agora contém apenas o texto que não foi compartilhado entre os marcadores originais sobrepostos.

A tabela a seguir mostra como a frase "Este é um texto de exemplo." é compartilhada por dois marcadores sobrepostos:

Indicador Texto
Marcadores sobrepostos [este é o texto {sample].}
Bookmark1 Este é um exemplo
Bookmark2 texto de exemplo.

Se você atribuir o novo texto "Isto é substituição." ao Marcador1, os marcadores não se sobreporão e o Marcador2 reterá apenas o texto que não fazia parte originalmente do Marcador1.

Indicador Texto
Dois marcadores separados [isto é substituição] { texto.}
Bookmark1 Isso é substituição
Bookmark2 texto.

Se você alterar o texto de um indicador que contenha outro marcador, o indicador interno não será excluído. No entanto, o indicador interno se torna um indicador vazio e se move para o final do indicador externo.

A tabela a seguir mostra como a frase "Este é um texto de exemplo." é compartilhada por um indicador contido em outro marcador:

Indicador Texto
Marcadores sobrepostos [Este é o texto {sample}.]
Bookmark1 Este é um texto de exemplo.
Bookmark2 sample

Se você atribuir o novo texto "Isto é substituição." ao Marcador1, os marcadores não estarão mais sobrepostos e o Marcador2 se tornará um indicador vazio localizado no final do Marcador1.

Indicador Texto
Dois marcadores separados [Isto é substituição.]{}
Bookmark1 Isso é substituição.
Bookmark2 <empty>

Eventos

Os seguintes eventos estão disponíveis para o Bookmark controle: