Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Bookmark controle é um marcador que tem um nome exclusivo, expõe eventos e pode ser associado a dados. O marcador pode ser usado para marcar um item ou local em um documento do Microsoft Office Word. O Bookmark controle é uma combinação de um Bookmark objeto e um Range objeto.
Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de Suplemento do VSTO para o Word. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.
Em projetos de nível de documento, você pode adicionar Bookmark controles ao documento em tempo de desenvolvimento ou em tempo de execução. Em projetos de suplemento do VSTO, você pode adicionar controles Bookmark a qualquer documento aberto durante a execução. Para obter mais informações, consulte Como adicionar controles de indicador a documentos do Word.
Associar dados ao controle
Um Bookmark controle dá suporte à associação de dados simples. O indicador deve ser associado a uma fonte de dados usando a propriedade DataBindings. A propriedade padrão de associação de dados do indicador é a propriedade Text.
Se os dados no conjunto de dados associado forem atualizados, o Bookmark controle mostrará 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.
Formatting
A formatação que pode ser aplicada a um Bookmark pode ser aplicada a um Bookmark controle. Essa formatação inclui fontes, recuos, espaçamento, numeração e estilos.
Atribuir texto ao marcador
Uma diferença adicional entre um Microsoft.Office.Interop.Word.Bookmark objeto e um Microsoft.Office.Tools.Word.Bookmark controle é como ele se comporta quando o texto é atribuído ao bookmark. Se você atribuir texto a um Microsoft.Office.Interop.Word.Bookmark de comprimento zero, o texto será acrescentado à direita do marcador e o marcador permanecerá de comprimento zero. No entanto, se você atribuir texto a um Microsoft.Office.Tools.Word.Bookmark de comprimento zero, o texto será inserido no marcador e o comprimento do marcador se expandirá 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 Bookmark.Range propriedade de um Microsoft.Office.Tools.Word.Bookmark controle ou da Bookmark.Range propriedade de um Microsoft.Office.Interop.Word.Bookmark objeto.
| Propriedade de Texto | Description |
|---|---|
| Bookmark.Text | Use essa propriedade para exibir o texto dentro do indicador e manter o indicador no documento. Atribuir texto ao indicador expande o intervalo de indicadores e não exclui o indicador. Por exemplo, Bookmark1.Text = "Hello world" insere o texto no indicador e deixa o indicador intacto. |
| Range.Text | Use essa propriedade para exibir o texto no local do indicador e excluir automaticamente o indicador. Por exemplo, Bookmark1.Range.Text = "Hello world" insere o texto no indicador e exclui o indicador. |
Renomear o controle em tempo de design
Em projetos de nível de documento, quando você arrasta um Bookmark controle da Caixa de Ferramentas para o documento, o Visual Studio gera automaticamente um nome para o controle. Você pode alterar o nome do controle na janela Propriedades .
Controles sobrepostos
Os controles de marcador podem se sobrepor uns aos outros. O mesmo texto pode ser compartilhado por mais de um favorito. Quando você atribui um novo texto a um dos indicadores sobrepostos, ele contém apenas o novo texto e os indicadores não se sobrepõem mais. O outro marcador agora contém apenas o texto que não foi compartilhado entre os marcadores sobrepostos originais.
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 amostra].} |
| Marcador1 | Este é um exemplo |
| Favorito2 | texto de exemplo. |
Se você atribuir o novo texto "Isso é substituição." ao Marcador1, os marcadores não se sobrepõem, e o Marcador2 manterá apenas o texto que não fazia parte originalmente do Marcador1.
| Indicador | Texto |
|---|---|
| Dois marcadores separados | [isso é substituição]{ text.} |
| Marcador1 | Isso é substituição |
| Favorito2 | Texto. |
Se você alterar o texto de um indicador que contém outro indicador, o indicador interno não será excluído. No entanto, o marcador interno se torna um marcador vazio e se move para o final do marcador externo.
A tabela a seguir mostra como a frase "Este é um texto de exemplo." é compartilhada por um indicador que está dentro de outro indicador.
| Indicador | Texto |
|---|---|
| Marcadores sobrepostos | [este é o texto {sample}.] |
| Marcador1 | Este é um texto de exemplo. |
| Marcador2 | amostra |
Se você atribuir o novo texto "Isso é substituição" ao Bookmark1, os indicadores não serão mais sobrepostos e Bookmark2 se tornará um indicador vazio localizado no final do Indicador1.
| Indicador | Texto |
|---|---|
| Dois marcadores separados | [isso é substituição.]{} |
| Marcador1 | Isso é substituição. |
| Favorito2 | <vazio> |
Eventos
Os seguintes eventos estão disponíveis para o Bookmark controle: