Indicador de Controlarar
Se aplica a |
|---|
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Projetos de nível de documento
Projetos de nível de aplicativo
For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto. |
O ControlPararParar de <Para0> $ </Para0> Para umPara IndicParador que tem um nome exclusivo, expõe evenParas e podem ser vinculParado Para dParados.BookmarkO indicador pode ser usado como um espaço reservado para marcar um item ou o local em um documento do Microsoft Office Word.
O Controlarar de Bookmark é uma combinação de um objeto de Microsoft.Office.Interop.Word.Bookmark e um objeto Microsoft.Office.Interop.Word.Range.Quando você Adicionar um indicador a um documento, Ferramentas do Visual Studio para o Office cria um objeto de indicador que você pode programar diretamente sem ter que percorrer o modelo de objeto do Word.
Em projetos de nível de documento, você pode adicionar controles de Bookmark ao seu documento em tempo de design ou em tempo de execução.Iniciando no Visual Studio 2008 Serviço Pack 1 (SP1), você também pode adicionar Bookmark controles para qualquer Abrir documento no tempo de execução usando em um suplemento do nível de aplicativo para Word 2007.For more information, see Como: Adicionar indicador controles a documentos do Word.
Vinculando dados ao controle
Um Controlarar de Bookmark suporta ligação de dados simples.O indicador deve ser Ligado a uma Origem de dados usando a propriedade DataBindings.A propriedade de ligação de dados padrão do indicador é a propriedade Text.
Se os dados no dataset Ligado for atualizados, o Controlarar de Bookmark reflete as alterações.
Em projetos de nível de documento, você também pode Ligar dados para indicadores usando a janela de fontes de dados.For more information, see Como: Preencher documentos com dados de objetos.
Formatação
Formatação que podem ser aplicadas a um Microsoft.Office.Interop.Word.Bookmark pode ser aplicado a um Controlarar de Bookmark.Isso inclui fontes, recuos, espaçamento, numeração e estilos.
Atribuir texto ao indicador
Uma diferença adicional entre um objeto de Microsoft.Office.Interop.Word.Bookmark e um Controlarar de Bookmark é como ele se comporta quando texto é atribuído ao indicador.Se você atribuir texto a um de comprimento zero Microsoft.Office.Interop.Word.Bookmark, o texto está inseridDireito do indicador e o indicador permanecerá comprimento zero.No entanto, se você atribuir texto a um de comprimento zero Bookmark, o texto é inserido para o indicador e tamanho do indicador se expande para o número total de caracteres inseridos.
Além disso, Ferramentas do Visual Studio para o Office adiciona uma propriedade de Bookmark.Text para o Controlarar de Bookmark.Isso é diferente da propriedade Range.Text que está disponível no Range do indicador.
Propriedade de texto |
Descrição |
|---|---|
Use esta propriedade para exibir o texto dentro do indicador e deixar o indicador no documento.Atribuir texto ao indicador expande o intervalo de indicador e não Excluir o indicador. Por exemplo, Bookmark1.Text = "Hello world" insere o texto para o indicador e deixa o indicador intactas. |
|
Use esta propriedade para exibir texto no local indicador e excluir automaticamente o indicador.Por exemplo, Bookmark1.Range.Text = "Hello world" insere o texto para o indicador e exclui o indicador. |
Renomear o Controlarar em tempo de design
Em projetos de nível de documento, quando você arrasta um Controlarar Bookmark de De caixa de ferramentas ao seu documento, Ferramentas do Visual Studio para o Office gera automaticamente um nome para o Controlarar.Você pode alterar o nome do Controlarar na janela Properties.
Overlapping Controls
Controles de indicador podem sobrepor cada Outro; ou seja, o mesmo texto pode ser compartilhado por mais de um indicador.Quando você Atribuir indicadores do novo texto a uma da sobreposição, ele irá conter o novo texto e os indicadores não irão se sobrepor.O Outro indicador será agora contém apenas o texto que não foi compartilhado entre os indicadores de sobreposiçãOriginal.
A tabela a seguir mostra como a frase “ Isto é texto de exemplo. ” é compartilhado por dois indicadores sobrepostos.
Bookmark |
Texto |
|---|---|
Sobreposição de indicadores |
[está {exemplo] texto.} |
Bookmark1 |
Este é exemplo |
Bookmark2 |
texto de exemplo. |
Se você atribuir o novo texto "This is a substituição." Bookmark1, os indicadores não são sobrepostos e Bookmark2 mantém apenas o texto que não era originalmente parte Bookmark1.
Bookmark |
Texto |
|---|---|
Dois indicadores separados |
[está substituição]texto {.} |
Bookmark1 |
Isso é o substituto |
Bookmark2 |
o texto. |
Se um indicador está totalmente contido em outro indicador e você alterar o texto do indicador externo, o indicador interno não é excluído.No entanto, o indicador interno se tornará um indicador vazio que será movido para o final do indicador 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 |
Texto |
|---|---|
Sobreposição de indicadores |
[isso está texto {exemplo}]. |
Bookmark1 |
Este é texto de exemplo. |
Bookmark2 |
exemplo |
Se você atribuir o novo texto "This is a substituição." Bookmark1, os indicadores não são sobrepostos e Bookmark2 torna-se um indicador vazio que está localizado no final do Bookmark1.
Bookmark |
Texto |
|---|---|
Dois indicadores separados |
[está substituição.]{} |
Bookmark1 |
Isso é substituição. |
Bookmark2 |
< @@ > |
Eventos
Os eventos a seguir estão disponíveis para o Controlarar de Bookmark:
Consulte também
Tarefas
Como: Adicionar indicador controles a documentos do Word
Demonstra Passo a passo: Criar menus de atalho para Favoritos
Conceitos
Limitações através de programação de itens de host e controles de host
Outros recursos
Date |
History |
Motivo |
|---|---|---|
De 2008 de julho |
Informações Adicionados sobre como usar controles de indicador em projetos de nível de aplicativo. |
Alteração de recurso do SP1. |