Indicador de controle
O Microsoft.Office.Tools.Word.Bookmark controle é 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 o local em um documento do Word de Microsoft Office. O Microsoft.Office.Tools.Word.Bookmark o controle é uma combinação de um Microsoft.Office.Interop.Word.Bookmark objeto e um Microsoft.Office.Interop.Word.Range objeto.
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.
Em projetos de nível de documento, você pode adicionar Microsoft.Office.Tools.Word.Bookmark controles para o documento em tempo de design ou em tempo de execução. Em projetos de nível de aplicativo, você pode adicionar Microsoft.Office.Tools.Word.Bookmark controles de qualquer documento aberto no tempo de execução. For more information, see Como: Adicionar controles de indicador para documentos do Word.
Binding Data to the Control
A Microsoft.Office.Tools.Word.Bookmark controle suporta vinculação de dados simples. O indicador deve ser vinculado a uma fonte de dados usando o DataBindings propriedade. A propriedade de vinculação de dados padrão do indicador é o Text propriedade.
Se os dados no dataset vinculado for atualizados, o Microsoft.Office.Tools.Word.Bookmark controle reflete as alterações.
Em projetos de nível de documento, você também pode vincular dados para indicadores usando o Fontes de dados janela. For more information, see Como: Preencher documentos com dados de objetos.
Formatting
Formatação que pode ser aplicado a uma Microsoft.Office.Interop.Word.Bookmark pode ser aplicado a uma Microsoft.Office.Tools.Word.Bookmark de controle. Isso inclui fontes, recuos, espaçamento, numeração e estilos.
Atribuindo o texto para o indicador
Uma diferença de adicional entre um Microsoft.Office.Interop.Word.Bookmark objeto e um Microsoft.Office.Tools.Word.Bookmark o controle é como ele se comporta quando o texto é atribuído ao indicador. Se você atribuir o texto a um comprimento zero Microsoft.Office.Interop.Word.Bookmark, o texto é acrescentado à direita do indicador e o indicador permanecerá zero-comprimento. No entanto, se você atribuir o texto a um comprimento zero Microsoft.Office.Tools.Word.Bookmark, o texto é inserido no indicador e o comprimento do indicador se expande para o número total de caracteres inseridos.
O Microsoft.Office.Tools.Word.Bookmark também tem um controle de Bookmark.Text propriedade. Isso é diferente do Range.Text propriedade está disponível na Range propriedade de um Microsoft.Office.Tools.Word.Bookmark controle ou o Range propriedade de um Microsoft.Office.Interop.Word.Bookmark objeto.
Propriedade de texto |
Description |
|---|---|
Use esta propriedade para exibir o texto dentro do indicador e deixar o indicador no documento. A atribuição de texto para o indicador expande o intervalo do indicador e não exclui o indicador. Por exemplo, Bookmark1.Text = "Hello world" insere o texto no indicador e deixa o indicador intactos. |
|
Use esta 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. |
Renomeando o controle em tempo de Design
Em projetos de nível de documento, quando você arrasta um Microsoft.Office.Tools.Word.Bookmark de controle da caixa de ferramentas ao seu documento, o Visual Studio gera automaticamente um nome para o controle. Você pode alterar o nome do controle de Propriedades janela.
Overlapping Controls
Indicador de controles podem se sobrepor a outros; ou seja, o mesmo texto pode ser compartilhado por mais de um indicador. Quando você atribui um novo texto para um dos indicadores sobrepostos, ele conterá apenas o novo texto e os indicadores não serão sobrepostas. Outro indicador agora irá conter apenas o texto que não foi compartilhado entre os indicadores de sobreposição originais.
A tabela a seguir mostra como a frase "Este é o texto de exemplo". é compartilhado por dois indicadores sobrepostos.
Bookmark |
Text |
|---|---|
Indicadores de sobreposição |
[Esta é a amostra {] texto.} |
Bookmark1 |
Este é um exemplo |
Bookmark2 |
texto de exemplo. |
Se você atribuir o novo texto "This is substituição". para Bookmark1, os indicadores não são sobrepostos e Bookmark2 retém apenas o texto originalmente não era parte do Bookmark1.
Bookmark |
Text |
|---|---|
Dois indicadores separados |
[Esta é a substituição]{texto}. |
Bookmark1 |
Esta é a substituição |
Bookmark2 |
texto. |
Se um indicador totalmente está contido em outro indicador e alterar o texto do marcador externo, o indicador interno não é excluído. No entanto, o indicador interno torna-se um indicador de vazio é movido para o final do marcador externo. A tabela a seguir mostra como a frase "Este é o texto de exemplo". é compartilhado por um indicador que está contido em outro indicador.
Bookmark |
Text |
|---|---|
Indicadores de sobreposição |
[Este é o texto de {amostra}]. |
Bookmark1 |
Este é o texto de exemplo. |
Bookmark2 |
exemplo |
Se você atribuir o novo texto "This is substituição". para Bookmark1, os indicadores não são sobrepostos e Bookmark2 se torna um indicador de vazio está localizado no final da Bookmark1.
Bookmark |
Text |
|---|---|
Dois indicadores separados |
[Esta é substituição].{} |
Bookmark1 |
Esta é a substituição. |
Bookmark2 |
<empty> |
Events
Os eventos a seguir estão disponíveis para o Microsoft.Office.Tools.Word.Bookmark controle:
Consulte também
Tarefas
Como: Adicionar controles de indicador para documentos do Word
Demonstra Passo a passo: A criação de Menus de atalho para indicadores
Conceitos
Automatizar o Word usando o Extended objetos
Limitações de programação de itens de Host e controles de Host