Controles de conteúdo
Os controles de conteúdo fornecem uma maneira para você para documentos e modelos de design que têm esses recursos:
Uma interface de usuário (UI) que controlasse entrada como um formulário.
As restrições impedem que usuários de edição protegeram seções de documento ou modelo.Para obter mais informações, consulte Partes de proteção de documentos usando controles de conteúdo.
Associando dados a uma fonte de dados.Para obter mais informações, consulte Associando dados para conter controles.
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.
.gif "link para vídeo")
Para uma demonstração de vídeo relacionada, consulte Associando dados aos controles de conteúdo de Word 2007 usando o Visual Studio para o office system (3,0).
visão geral de controles de conteúdo
Os controles de conteúdo fornecem interface do usuário que é otimizado para entrada do usuário e a impressão.Quando você adiciona um controle de conteúdo a um documento, o controle é identificado por uma borda, um título, e o texto temporário que pode fornecer instruções para o usuário.A borda e o título do controle não aparecem em versões impressas do documento.
Por exemplo, se você deseja que o usuário para inserir uma data em uma seção do documento, você pode adicionar um controle do conteúdo do selecionador de data para o documento.Quando os usuários clicam no controle, o selecionador interface de usuário padrão de data aparece.Você também pode definir propriedades de controle para definir o calendário regional que é exibido e para especificar o formato de data.Depois que o usuário escolha uma data, interface do usuário do controle está oculto, e somente a data aparecerá se o usuário imprimir o documento.
Os controles de conteúdo também ajudam a fazer o seguinte:
Impedir que usuários editar ou excluir as partes de um documento.Isso é útil se você tiver informações em um documento ou modelo que os usuários possam ler mas não editar, ou se você deseja que os usuários possam editar controles de conteúdo mas não para os excluir.
Associar as partes de um documento ou de um modelo a dados.Você pode associar os controles de conteúdo no banco de dados, objetos gerenciados em .NET Framework, elementos XML que são armazenados no documento, e outras fontes de dados.
Em projetos de um documento nível, você pode adicionar controles de conteúdo no seu documento em tempo de design ou em tempo de execução.Em projetos de aplicativo, você pode adicionar controles de conteúdo para qualquer documento aberto em tempo de execução.Para obter mais informações, consulte Como: adicionar controles de conteúdo para documentos do Word.
.gif "Observação") Observação |
|---|
Você pode usar controles de conteúdo somente em documentos que são salvos aberto no formato XML.Você não pode usar controles de conteúdo em documentos que são salvos no formato de documento do word). 97-2003 (.doc |
tipos de controles de conteúdo
Existem nove diferentes tipos de controles de conteúdo que você pode adicionar aos documentos.A maioria dos controles de conteúdo têm um tipo correspondente no namespace de Microsoft.Office.Tools.Word .Você também pode usar ContentControlgenérica, que podem representar qualquer um dos controles de conteúdo disponíveis.Para uma explicação passo a passo que demonstra como usar cada um dos controles de conteúdo disponíveis, considere Passo a passo: Criando um modelo usando os controles de conteúdo.
.gif "Bb157891.collapse_all(pt-br,VS.110).gif")
Galeria do bloco de construção
Uma galeria do bloco de construção permite aos usuários selecionar de uma lista de blocos de construção de documento para inserir em um documento.Um bloco de construção de documento é uma parte do conteúdo que foi projetado para ser usado várias vezes, como uma folha de rosto comuns, uma tabela formatado, ou um cabeçalho.Para obter mais informações, consulte o tipo de BuildingBlockGalleryContentControl .Para obter mais informações sobre os blocos de construção, consulte O que há de novo para desenvolvedores em Word 2007.
Check Box
Uma caixa de seleção fornece uma interface do usuário que representa um estado binário: selecionada ou desmarcada.
Diferentemente dos outros tipos de controles de conteúdo, Visual Studio Tools for Office Runtime não fornece um tipo específico que representa um controle de conteúdo da caixa de seleção.É ou não há nenhum tipo de CheckBoxContentControl .Em o entanto, você ainda pode criar um controle de conteúdo da caixa de seleção adicionando ContentControl genérico para um documento programaticamente.Para obter mais informações, consulte Controles de conteúdo da caixa de seleção em projetos do word.
Combo Box
uma caixa de combinação exibe uma lista de itens que os usuários podem selecionar.A o contrário uma lista suspensa, a caixa de combinação permite aos usuários adicionar seus próprios itens.Para obter mais informações, consulte o tipo de ComboBoxContentControl .
Seletor de Data
Um selecionador de data fornece um calendário interface do usuário selecione uma data.O calendário aparece quando o usuário final clique na seta suspensa no controle.você pode usar calendários regionais e formatos de data diferentes.Para obter mais informações, consulte o tipo de DatePickerContentControl .
lista suspensa
uma lista suspensa exibe uma lista de itens que os usuários podem selecionar.Diferentemente de uma caixa de combinação, a lista suspensa não permite que os usuários adicionar ou editar itens.Para obter mais informações, consulte o tipo de DropDownListContentControl .
Group
Um controle de grupo definir uma região protegida de um documento que os usuários não podem editar ou excluir.Um controle de grupo pode conter todos os itens de documento, como texto, as tabelas, gráficos, e outros controles de conteúdo.Para obter mais informações, consulte o tipo de GroupContentControl .
Imagem
Um controle de imagem exibe uma imagem.Você pode especificar a imagem em tempo de design ou tempo de execução, ou os usuários podem clicar em este controle para selecionar uma imagem para inserir no documento.Para obter mais informações, consulte o tipo de PictureContentControl .
RTF
Um controle de texto rico contém texto ou outros itens, como tabelas, imagens, ou outros controles de conteúdo.Para obter mais informações, consulte o tipo de RichTextContentControl .
Texto Sem Formatação
Um controle de texto sem formatação contém o texto.Um controle de texto sem formatação não pode conter outros itens, como tabelas, imagens, ou outros controles de conteúdo.Além de isso, qualquer texto em um controle de texto sem formatação tem o mesmo formatação.Por exemplo, se você italiciza uma palavra de uma frase que está em um controle de texto sem formatação, qualquer texto dentro do controle é em itálico.Para obter mais informações, consulte o tipo de PlainTextContentControl .
controle de conteúdo genérico
Um controle de conteúdo genérico é um objeto de ContentControl que pode representar qualquer um dos tipos de controles disponíveis de conteúdo.Você pode modificar um objeto de ContentControl se comportar como um tipo diferente de controle de conteúdo usando a propriedade de Type .Por exemplo, se você criar um objeto de ContentControl que representa um controle de texto sem formatação, você pode alterá-lo em tempo de execução para que se comporta como uma caixa combo.
Você pode criar objetos de ContentControl somente em tempo de execução, não em tempo de design.Para obter mais informações, consulte Como: adicionar controles de conteúdo para documentos do Word.
Recursos comuns de controles de conteúdo
A maioria dos controles de conteúdo compartilham um conjunto de membros que você pode usar para executar tarefas comuns.A tabela a seguir descreve algumas das tarefas que você pode realizar usando esses membros.
para esta tarefa: |
Faça isso: |
|---|---|
Obter ou definir o texto que é exibido no controle. |
Use a propriedade Text. Observação
Os tipos de PictureContentControl e de ContentControl não têm essa propriedade.
|
Obter ou definir o texto temporário que é exibido no controle até que o usuário edite o controle, o controle é preenchido com dados de uma fonte de dados, ou o conteúdo do controle são excluídos. |
Use a propriedade PlaceholderText. Observação
o tipo de PictureContentControl não tem esta propriedade.
|
Obter ou definir o título que é exibido na borda do controle de conteúdo quando o usuário clica na. |
Use a propriedade Title. |
Remova o controle de documento automaticamente após o usuário edita o controle.(O texto no controle permanecerá no documento.) |
Use a propriedade Temporary. |
Executar o código quando o usuário clica no controle do conteúdo, ou quando o cursor é movido no controle de conteúdo programaticamente. |
Manipular o evento de Entering do controle. |
Executar o código quando o usuário clica a fora do controle do conteúdo, ou quando o cursor é movida fora do controle de conteúdo programaticamente. |
Manipular o evento de Exiting do controle. |
O código de execução após o controle de conteúdo é adicionado ao documento resultado refazer ou desfaz a operação. |
Manipular o evento de Added do controle. |
Código de execução imediatamente antes do controle de conteúdo é excluído do documento. |
Manipular o evento de Deleting do controle. |
Partes de proteção de documentos usando controles de conteúdo
Quando você proteja uma parte de um documento, você evita que usuários modifiquem ou excluam o conteúdo em esta parte do documento.Há várias maneiras que você pode proteger partes de um documento usando controles de conteúdo.
Se a área que você deseja proteger está dentro de um controle de conteúdo, você pode usar as propriedades do controle de conteúdo para impedir os usuários de edição ou excluam o controle:
A propriedade de LockContents impede que os usuários editem o conteúdo.
a propriedade de LockContentControl impede que os usuários excluam o controle.
Se a área que você deseja proteger não está dentro de um controle do conteúdo, ou se você deseja proteger uma área que contém controles de conteúdo e outros tipos de conteúdo, você pode colocar toda a área em GroupContentControl.Diferentemente de outros controles de conteúdo, GroupContentControl não fornece nenhuma interface do usuário que é visível para o usuário.Somente sua finalidade é definir uma região que os usuários não podem editar.
| Observação |
|---|
Se você criar GroupContentControl que contém controles de conteúdo inseridos, os controles de conteúdo inseridos não são protegidos automaticamente.Você deve usar a propriedade de LockContents de cada controle inserido para evitar que os usuários editem seu conteúdo. |
Para obter mais informações sobre como usar controles de conteúdo para proteger partes de documentos, consulte Como: proteger partes de documentos usando os controles de conteúdo.
Associando dados para conter controles
Você pode exibir dados em documentos associando um controle de conteúdo a uma fonte de dados.quando a fonte de dados é atualizada, o controle de conteúdo reflete as alterações.Você também pode salvar alterações de volta para a fonte de dados.
Os controles de conteúdo oferecem os seguintes opções de associação de dados:
Você pode associar controles de conteúdo no banco de dados ou objetos gerenciados usando o mesmo modelo de associação de dados que formulários do windows.
Você pode associar controles de conteúdo em partes para elementos XML (também chamado personalizado XML parte) que são inseridas no documento.
Para obter uma visão geral de controles de host de associação em soluções do Office a dados, consulte A ligação de dados a controles em soluções do Office.
Usando o modelo de associação de dados dos formulários do windows
A maioria dos controles de conteúdo oferecem suporte ao modelo de associação de dados simples que usa o windows.A associação de dados simples significa que um controle é associado à um elemento de dados, como um valor em uma coluna de uma tabela de dados.Para obter mais informações, consulte Ligação de dados e o Windows Forms.
Em projetos de um documento nível, você pode associar dados a controles de conteúdo usando a janela de Fontes de Dados em Visual Studio.Para obter mais informações sobre como adicionar conteúdo de controles associados a dados aos documentos, consulte Como: preencher documentos com dados de um banco de dados. e Como: preencher documentos com dados de objetos.
A tabela a seguir lista controles que você pode associar a cada tipo de dados na janela de Fontes de Dados .
Tipo de dados |
controle de conteúdo padrão |
Outros controles de conteúdo que podem ser associados a esse tipo de dados |
|---|---|---|
|
Matriz Byte |
Nenhum |
Em projetos da nível de aplicativo, você pode associar um controle de conteúdo a uma fonte de dados por meio de programação usando o método de Add() da propriedade de DataBindings do controle.Se você fizer isso, passe a cadeia de caracteres Texto para o parâmetro de propertyName do método de Add() .A propriedade de Text é a propriedade de associação de dados padrão de controles de conteúdo.
Os controles de conteúdo também suportam associação de dados unidirecional, em que as alterações no controle são atualizadas para a fonte de dados.Para obter mais informações, consulte Como: atualizar uma fonte de dados com dados de um controle de Host.
| Observação |
|---|
Os controles de conteúdo não suportam associação de dados complexos.Se você associa DropDownListContentControl ou ComboBoxContentControl a uma fonte de dados usando formulários modelo de dados do windows, os usuários verão apenas um único valor quando clique no controle.Se você deseja associar esses controles a um conjunto de valores de dados de que os usuários podem optar, você pode associar esses controles aos elementos em uma parte personalizado XML. |
Controles de conteúdo de associação personalizados a partes XML
Você pode associar alguns controles de conteúdo para elementos personalizados em partes XML que são inseridas no documento.Para obter mais informações sobre as partes personalizados XML, consulte Visão geral de partes XML personalizada.
Para associar um controle a um elemento de conteúdo em uma parte personalizado XML, use a propriedade de XMLMapping do controle.O exemplo de código a seguir demonstra como associar PlainTextContentControl para o elemento de Price sob o nó de Product em uma parte personalizado XML que já é adicionada ao documento.
plainTextContentControl1.XMLMapping.SetMapping("/Product/Price")
plainTextContentControl1.XMLMapping.SetMapping("/Product/Price", String.Empty, null);
Para uma explicação passo a passo que demonstra como associar mais detalhadamente controles personalizados a partes de conteúdo XML, considere Passo a passo: Controles de conteúdo ligação às partes do XML personalizado.
Quando você associa um controle de conteúdo a uma parte personalizado XML, associação de dados bidirecional é automaticamente ativada.Se o usuário edita o texto no controle, os elementos correspondentes XML são atualizados automaticamente.De a mesma forma, se os valores de elemento nas partes XML personalizado são alterados, os controles de conteúdo que são associados aos elementos XML exibirão novos dados.
Você pode associar os seguintes tipos de controles de conteúdo a partes personalizados XML:
Eventos de associação de dados para controles de conteúdo
Todos os controles de conteúdo fornecem um conjunto de eventos que você pode manipular para executar tarefas relacionadas, como validar que o texto em um controle satisfaça certos critérios antes da fonte de dados seja atualizada.A seguinte tabela lista os eventos de conteúdo do controle que são relacionadas a associação de dados.
Tarefa |
Evento |
|---|---|
Código de execução imediatamente antes da palavra atualizarão automaticamente o texto em um controle de conteúdo que está associado a uma parte personalizado XML. |
|
Código de execução imediatamente antes da palavra atualizarão automaticamente dados em uma parte personalizado XML que está associada a um controle de conteúdo (isto é, após o texto nas alterações de controle de conteúdo). |
|
Executar seu próprio código para validar o conteúdo do controle de acordo com critérios personalizados. |
|
Código de execução após o conteúdo do controle foram validados com êxito. |
limitações de controles de conteúdo
Quando você usa controles de conteúdo em seus projetos do Office, esteja ciente das seguintes limitações.
Diferenças de comportamento entre o tempo de design e o tempo de execução
Muitas das limitações o Microsoft Office Word aplicada em controles de conteúdo em tempo de execução não são aplicadas em tempo de design.Quando você cria a interface do usuário de uma solução de um documento em nível Visual Studio, certifique-se de alterar controles de conteúdo somente nas maneiras que são suportadas em tempo de execução.
Se você alterar um controle de conteúdo em tempo de design de uma maneira que o controle não oferece suporte em tempo de execução, o designer de Visual Studio não o alertará de alterações sem suporte.Em o entanto, quando você depura ou executar o projeto, ou se você salvar e então reabra o projeto, a palavra exibirão uma permissão da mensagem de erro e de solicitação reparar o documento.Quando você repara o documento, a palavra removem qualquer conteúdo e formatação sem suporte do controle.
Por exemplo, a palavra não impede que você adicionar uma tabela a PlainTextContentControl em tempo de design.Em o entanto, como os objetos de PlainTextContentControl não podem conter tabelas em tempo de execução, a palavra irão exibir uma mensagem de erro quando o documento está aberto.
Observe também que várias propriedades que definem o comportamento de controles de conteúdo não têm efeito em tempo de design.Por exemplo, se você definir a propriedade de LockContents de um controle de conteúdo a True em tempo de design, você ainda pode editar o texto no controle no designer de Visual Studio .Essa propriedade impede que somente os usuários editem o controle em tempo de execução.
Limitações de evento
Os controles de conteúdo não fornecem um evento que é gerado quando o usuário altera texto ou outros itens no controle.Por exemplo, não há nenhum evento que é gerado quando um usuário seleciona um item diferente em DropDownListContentControl ou em ComboBoxContentControl.
Para determinar quando o usuário edita o conteúdo de um controle de conteúdo, você pode associar o controle a uma parte personalizado XML, e manipular o evento de StoreUpdating .Este evento é gerado quando o usuário modifica o conteúdo de um controle que está associado a uma parte personalizado XML.Para uma explicação passo a passo que demonstra como associar um controle de conteúdo a uma parte personalizado XML, considere Passo a passo: Controles de conteúdo ligação às partes do XML personalizado.
Controles de conteúdo da caixa de seleção em projetos do word
A palavra 2010 introduziram um novo tipo de controle de conteúdo que representa uma caixa de seleção.Em o entanto, Visual Studio Tools for Office Runtime não fornece um tipo correspondente de CheckBoxContentControl para que você as use em projetos do Office.Para criar um conteúdo da caixa de seleção controle em Word 2013 ou em um projeto do word 2010, use o método de AddContentControl para criar um objeto de Microsoft.Office.Tools.Word.ContentControl , e passar o valor de wdContentControlCheckBox para o método para especificar um controle de conteúdo da caixa de seleção.O exemplo de código a seguir demonstra como fazer isso.
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
Dim checkBoxControl1 As Microsoft.Office.Tools.Word.ContentControl =
Me.Controls.AddContentControl("checkBoxControl1", Word.WdContentControlType.wdContentControlCheckBox)
checkBoxControl1.Checked = True
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
Microsoft.Office.Tools.Word.ContentControl checkBoxControl1 =
this.Controls.AddContentControl("checkBoxControl1", Word.WdContentControlType.wdContentControlCheckBox);
checkBoxControl1.Checked = true;
Consulte também
Tarefas
Como: adicionar controles de conteúdo para documentos do Word
Passo a passo: Criando um modelo usando os controles de conteúdo
Conceitos
Automação do Word utilizando o Extended objetos
Limitações de programação de itens de Host e controles de Host