Indicador de controle
O controle de Microsoft.Office.Tools.Word.Bookmark é um indexador que possui um nome exclusivo, expõe eventos, e podem ser associados a dados.O indexador pode ser usado como um espaço reservado para marcar um item ou um local em um documento Microsoft Office Word.o controle de Microsoft.Office.Tools.Word.Bookmark é uma combinação de um objeto de Microsoft.Office.Interop.Word.Bookmark e de um objeto de Microsoft.Office.Interop.Word.Range .
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 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.
Em projetos de um documento nível, você pode adicionar controles de Microsoft.Office.Tools.Word.Bookmark no seu documento em tempo de design ou em tempo de execução.Em projetos de aplicativo, você pode adicionar controles de Microsoft.Office.Tools.Word.Bookmark a qualquer documento aberto em tempo de execução.Para obter mais informações, consulte Como: adicionar controles de indicador aos documentos do Word.
Associando dados ao controle
Um controle de Microsoft.Office.Tools.Word.Bookmark suporta associação de dados simples.O indexador deve ser associado a uma fonte de dados utilizando a propriedade de DataBindings .A propriedade de associação de dados padrão do marcador é a propriedade de Text .
Se os dados no dataset associado são atualizados, o controle de Microsoft.Office.Tools.Word.Bookmark reflete as alterações.
Em projetos de um documento nível, você também pode associar dados indexadores usando a janela de Fontes de Dados .Para obter mais informações, consulte Como: preencher documentos com dados de objetos.
Formatação
Formatação que pode ser aplicado a Microsoft.Office.Interop.Word.Bookmark pode ser aplicado a um controle de Microsoft.Office.Tools.Word.Bookmark .Isso inclui fontes, recortes, espaçamento, numeração, e estilos.
Texto de atribuição para o marcador
Uma diferença extra entre um objeto de Microsoft.Office.Interop.Word.Bookmark e um controle de Microsoft.Office.Tools.Word.Bookmark é como se comporta quando o texto é atribuído ao indexador.Se você atribuir o texto a Microsoft.Office.Interop.Word.Bookmarkde comprimento zero, o texto é acrescentado à direita do indexador e o indexador permanece de comprimento zero.Em o entanto, se você atribuir o texto a Microsoft.Office.Tools.Word.Bookmarkde comprimento zero, o texto é inserido no indexador e o comprimento do indexador expande para o número total de caracteres inseridos.
O controle de Microsoft.Office.Tools.Word.Bookmark também tem a propriedade de Bookmark.Text .Isso é diferente da propriedade de Range.Text que está disponível na propriedade de Range de um controle de Microsoft.Office.Tools.Word.Bookmark ou a propriedade de Range de um objeto de Microsoft.Office.Interop.Word.Bookmark .
Propriedade de texto |
Descrição |
|---|---|
Use esta propriedade para exibir o texto dentro do indexador e para permitir que o indexador no documento.O texto de atribuição para o marcador expande o intervalo do indexador e exclui o indexador. Por exemplo, Bookmark1.Text = "Hello world" inserir o texto no indexador e sai do indexador intacto. |
|
Use esta propriedade para exibir o texto no local do indexador e para excluir automaticamente o indexador.Por exemplo, Bookmark1.Range.Text = "Hello world" inserir o texto no indexador e exclui o indexador. |
Renomeando o controle em tempo de design
Em projetos de um documento nível, quando você arrasta um controle de Microsoft.Office.Tools.Word.Bookmark de Caixa de Ferramentas no seu documento, o Visual Studio gera automaticamente um nome para o controle.Você pode alterar o nome do controle na janela de Propriedades .
Controles sobrepostos
Os controles do indexador podem sobrepor-se; isto é, o mesmo texto pode ser compartilhado por mais de um indexador.Quando você atribui o novo texto como um dos indicadores sobrepostos, só conterá o novo texto e marcadores não sobrepostos.O outro indexador agora conterá somente texto que não foi compartilhado entre o original se sobrepõem indicadores.
A tabela a seguir mostra como a frase “isso é texto de exemplo.” é compartilhado por dois indicadores sobrepostos.
Indicador |
Texto |
|---|---|
Sobrepostos indicadores |
[este é o texto {}] de exemplo. |
Bookmark1 |
Este exemplo é |
Bookmark2 |
exemplo de texto. |
Se você atribuir o novo texto “for” substituição. a Bookmark1, os indicadores não são sobrepostos e Bookmark2 retém apenas texto que não foi originalmente parte de Bookmark1.
Indicador |
Texto |
|---|---|
Dois separados indicadores |
esta é uma substituição [] {} o texto. |
Bookmark1 |
Esta é uma substituição |
Bookmark2 |
texto. |
Se um indexador é totalmente contido dentro de outro indexador e você alterar o texto do indexador externo, o indexador interno não é excluído.Em o entanto, o indexador interno torna-se um indexador vazio que é movido para o final do indexador externo.A tabela a seguir mostra como a frase “isso é texto de exemplo.” é compartilhado por um indexador que está contido dentro de outro indexador.
Indicador |
Texto |
|---|---|
Sobrepostos indicadores |
[este é o texto {}] de exemplo. |
Bookmark1 |
Este é o texto do exemplo. |
Bookmark2 |
exemplo |
Se você atribuir o novo texto “for” substituição. a Bookmark1, os indicadores não são sobrepostos e Bookmark2 torna-se um indexador vazio que está localizado no final de Bookmark1.
Indicador |
Texto |
|---|---|
Dois separados indicadores |
[esta é a substituição. {}] |
Bookmark1 |
Esta é uma substituição. |
Bookmark2 |
<empty> |
Eventos
os seguintes eventos estão disponíveis para o controle de Microsoft.Office.Tools.Word.Bookmark :
Consulte também
Tarefas
Como: adicionar controles de indicador aos documentos do Word
Passo a passo: Criando Menus de atalho para indicadores
Conceitos
Automação do Word utilizando o Extended objetos
Limitações de programação de itens de Host e controles de Host