Os controles de conteúdo
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. Tipo de Projeto
Versão do Microsoft Office
For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto. |
Os controles de conteúdo fornecem uma maneira para você documentos do design e modelos que possuem estes recursos:
Uma interface de usuário (UI) que tem controlado entrada como um formulário.
Restrições que evitar que os usuários editem protegido seções do documento ou modelo.Para obter mais informações, consulte proteção Parts de documentos por controles de conteúdo usando.
A vinculação de dados a uma Origem de dados.Para obter mais informações, consulte Binding Dadosta para controles de conteúdo.
Visão geral dos controles de conteúdo
Conteúdo de controles fornecem uma interface do usuário que é otimizado para ambAmbos Ambos entradAmbos do usuário e Imprimir.Quando você Adicionar um Controlarar de conteúdo para um documento, o Controlarar é 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 Controlarar não Aparecerr nas versões impressas do documento.
Por exemplo, se você deseja que o usuário Enter uma data em uma seção do seu documento, você pode adicionar um Controlarar de conteúdo de selecionador de data ao documento.Quando os usuários Clique o Controlarar, o selecionador de data padrão da interface do usuário é exibida.Você também pode definir propriedades do Controlarar para definir o calendário regional que é exibido e para especificar o Formatarar de data.Depois que o usuário escolher uma data, a interface do usuário do Controlarar está oculto e somente a data aparece se o usuário imprime o documento.
Conteúdo também controla ajuda você fazer o seguinte:
Impede que os usuários editar ou excluir partes de um documento.Isso é útil se você tiver informações em um documento ou modelo que os usuários devem ser capazes de ler mas não editar, ou se desejar que os usuários para poder editar o conteúdo, mas não controla Excluir-los.
Ligar partes de um documento ou modelo a dados.Você pode Ligar controles de conteúdo para campos de banco de dados, objetos gerenciados no .NET Framework, elementos XML que são armazenados no documento e Outro fontes de dados.
Em projetos de nível de documento, você pode adicionar controles de conteúdo ao seu documento em tempo de design ou em tempo de execução.Iniciando no Visual Studio 2008 Serviço Pack 1 (SP1), você pode adicionar controles de conteúdo a qualquer Abrir documento em tempo de execução, usando um suplemento em nível de aplicativo.For more information, see Como: Adicionar controles de conteúdo a documentos do Word.
.gif "Observação") Observação: |
|---|
Você pode usar conteúdos controles somente em documentos são salvos na Formatarar XML Abrir Em Word 2007.Não é possível usar controles de conteúdo em documentos que são salvos na Documento do Word 97-2003 (.doc) Formatarar. |
Tipos de controles de conteúdo
Há oito tipos diferentes de controles de conteúdo que você pode adicionar aos documentos usando Ferramentas do Visual Studio para o Office.Cada um dos controles de conteúdo tem uma classe correspondente no namespace Microsoft.Office.Tools.Word.Você também pode usar a classe de ContentControl, que pode representar qualquer um dos controles de conteúdo disponíveis.
Para um explicação passo a passo que demonstra como usar cada um dos controles de conteúdo disponíveis, consulte Demonstra Passo a passo: Criando um modelo usando controles de conteúdo.
Galeria de Bloquear de construção
Uma galeria de blocos de construção permite aos usuários selecionar em uma lista de de blocos de construção de documento para inserir em um documento.Comum Bloquear de construção de docComumento é Comuma parte do conteúdo que foi criado para ser usado Múltiplo vezes, ComComumo Comuma folha de rosto ComComumComum, Comuma tabela formatada e Comum cabeçalho.Para mais informações, consulte a classe BuildingBlockGalleryContentControl.Para obter mais informações sobre blocos de construção, consulte que do Novo para desenvolvedores no Word 2007.
Combo Box
Uma caixa de combinação exibe uma lista de itens que os usuários podem selecionar.Ao contrário de uma queda lista suspensa, a caixa de combinação permite aos usuários Adicionar seus próprios itens.Para mais informações, consulte a classe ComboBoxContentControl.
Selecionador de data
Um selecionador de data fornece um calendário da interface do usuário para selecionar uma data.O calendário é exibida quando o usuário final clica suspensa Para Baixo seta no Controlarar.Você pode usar calendários regionais e formatos de data diferentes.Para mais informações, consulte a classe DatePickerContentControl.
Soltar-Para baixo a lista
Uma lista Soltar-Para Baixo exibe uma lista de itens que os usuários podem selecionar.Diferentemente de uma caixa de combinação, a lista Soltar-Para Baixo não permite que usuários adicionar ou editar itens.Para mais informações, consulte a classe DropDownListContentControl.
Group
Um Controlarar de AAgruparar define uma região protegida de um documento que os usuários não é possível editar ou excluir.Um controle de AAgruparar pode conter quaisquer itens de documento, como texto, tabelas, elementos gráficos e outro controles de conteúdo.Para mais informações, consulte a classe GroupContentControl.
Imagem
Um Controlarar de imagem exibe uma imagem.Você pode especificar a imagem no tempo de design ou tempo de execução, ou os usuários podem Clique esse Controlarar para selecionar uma imagem a ser inserido no documento.Para mais informações, consulte a classe PictureContentControl.
Rich Texto
Um controle rich text contém texto ou outros itens, como tabelas, imagens ou outro controles de conteúdo.Para mais informações, consulte a classe RichTextContentControl.
Texto sem formatação
Um Controlarar de texto Normal contém texto.Um controle de texto Normal não pode conter outros itens, como tabelas, imagens ou outro controles de conteúdo.Além disso, Tudo o texto em um Controlarar de texto Normal tem a mesma formatação.Por exemplo, se você coloca em itálico uma palavra de uma frase que está em um Controlarar de texto Normal, Tudo o texto dentro do Controlarar está em itálico.Para mais informações, consulte a classe PlainTextContentControl.
ContentControl
Um objeto ContentControl é um controle mutável que pode representar qualquer um dos oito tipos de controles de conteúdo.Você pode alterar um objeto ContentControl para se comportar como um tipo diferente de Controlarar de conteúdo usando a propriedade Type.Por exemplo, se você criar um objeto de ContentControl que representa um Controlarar de texto Normal, você pode Alterar dela em executar tempo para que ele se comporta como uma caixa de combinação.
Você pode criar objetos de ContentControl somente em tempo de execução, não em tempo de design.For more information, see Como: Adicionar controles de conteúdo a documentos do Word.
Recursos ComComumComum de controles de conteúdo
Controles de conteúdo mais em Ferramentas do Visual Studio para o Office Comumpartilhar Comumum conjunto de membros que você pode usar para executar tarefas ComumComumum.A tabela a seguir descreve algumas das tarefas que você pode executar usando esses membros.
Para esta tarefa: |
Faça o seguinte: |
|---|---|
Obter ou definir o texto que é exibido no Controlarar. |
Use a propriedade Text. Observação:
O Classes de PictureContentControl e ContentControl não tem essa propriedade.
|
Obter ou definir o texto temporário que é exibido no Controlarar até que um usuário edita o Controlarar, o Controlarar é preenchido com dados de uma Origem de dados ou o conteúdo do Controlarar é excluído. |
Use a propriedade PlaceholderText. Observação:
O Classe de PictureContentControl não tem essa propriedade.
|
Obtenha ou definir o título que é exibido na borda do Controlarar conteúdo quando o usuário clica nele. |
Use a propriedade Title. |
Remover o Controlarar do documento automaticamente depois que o usuário edita o Controlarar.(O texto do Controlarar permanece no documento.) |
Use a propriedade Temporary. |
Executadas código quando o usuário clica no Controlarar de conteúdo, ou quando o cursor é movido para o Controlarar de conteúdo por meio de programação. |
Manipule o evento Entering do Controlarar. |
Executadas código quando o usuário clicar fora do Controlarar de conteúdo, ou quando o cursor é movido fora do Controlarar de conteúdo por meio de programação. |
Manipule o evento Exiting do Controlarar. |
Executar códigos depois que o Controlarar de conteúdo é adicionado ao documento como resultado de um Refazer ou desfazer a operação. |
Manipule o evento Added do Controlarar. |
Executar o código apenas antes que o Controlarar de conteúdo seja excluído do documento. |
Manipule o evento Deleting do Controlarar. |
Protegendo partes de documentos usando controles de conteúdo
Quando você protege uma parte de um documento, você impede que os usuários alterar ou excluir o conteúdo que parte do documento.Há várias maneiras de você pode proteger partes de um documento usando os controles de conteúdo.
Se a área que deseja proteger está dentro de um Controlarar de conteúdo, você pode usar propriedades do Controlarar conteúdo para impedir que os usuários editar ou excluir o Controlarar:
A propriedade LockContents impede que os usuários editem o conteúdo.
A propriedade LockContentControl impede os usuários de excluir o Controlarar.
Se a área que você deseja proteger não está dentro de um controle de 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 a área inteira em um GroupContentControl.Diferentemente da outros controles de conteúdo, um GroupContentControl não fornece nenhuma interface do usuário que esteja visível para o usuário.Sua única finalidade é definir uma região que os usuários não é possível editar.
| Observação: |
|---|
Se você criar um GroupContentControl que contém incorporados controles de conteúdo, controles de conteúdo incorporados não são protegidos automaticamente.Você use a propriedade LockContents de cada Controlarar incorporado para evitar que os usuários editem o conteúdo. |
Para obter mais informações sobre como usar controles de conteúdo para proteger as partes de documentos, consulte Como: Proteger partes de documentos, usando controles de conteúdo.
Vincular dados a controles de conteúdo
Você pode exibir dados em documentos, ligar um Controlarar de conteúdo a uma Origem de dados.Quando a Origem de dados é atualizada, o Controlarar de conteúdo reflete as alterações.Você também pode salvar as alterações Voltar para a Origem de dados.
Controles de conteúdo fornecem as opções de vinculação de dados seguintes:
Você pode ligar controles de conteúdo a campos do banco de dados ou objetos gerenciados, usando o mesmo modelo de ligação de dados como o Windows Forms.
Você pode Ligar controles de conteúdo a elementos em partes do XML (também chamado Personalizar XML partes) que são incorporados no documento.
Para obter uma visão geral de ligar controles host em soluções de Ferramentas do Visual Studio para o Office a dados, consulte Vinculando dados a controles.
Usando os dados de formulários Windows vinculação de modelo
Mais conteúdos controles suportam o modelo de ligação de dados simples que usa o Windows Forms.Ligação de dados simples significa que um Controlarar está Ligado a um elemento de dados, como um valor em uma coluna de uma tabela de dados.For more information, see Ligação de dados e o Windows Forms.
Em projetos de nível de documento, você pode Ligar dados a controles de conteúdo usando a janela de fontes de dados em Visual Studio.Para obter mais informações sobre como adicionar controles de conteúdo com dados Ligados a 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 os controles de conteúdo que você pode Ligar a cada tipo de dados na janela Fontes de dados.
Tipo de dados |
Controlarar de conteúdo padrão |
Outros controles de conteúdo que podem ser Ligados a esse tipo de dados |
|---|---|---|
|
Matriz Byte |
Nenhum |
Em projetos de nível de documento e o nível de aplicativo, você pode Ligar um Controlarar de conteúdo a uma Origem de dados programaticamente usando o método Add da propriedade DataBindings do Controlarar.Se você fizer isso, passe em Cadeia de Caracteres texto ao parâmetro do método propertyNameAdd.A propriedade Text é a propriedade de ligação de dados padrão de controles de conteúdo.
Controles de conteúdo também suportam vinculação de dados bidirecional, na qual as alterações no controle são atualizadas para a Origem de dados.For more information, see Como: Atualizar uma Origem de dados com dados de um Controlarar de host.
| Observação: |
|---|
Controles de conteúdo não suportam vinculação de dados complexos.Se você Ligar um DropDownListContentControl ou ComboBoxContentControl a uma Origem de dados usando o modelo de dados do Windows Forms, os usuários verão apenas um Simples valor quando eles Clique o Controlarar.Se você quiser Ligar esses controles um conjunto de valores de dados que os usuários podem escolher, você pode Ligar esses controles a elementos em uma parte XML Personalizar. |
Controles de conteúdo ligação Personalizar XML Parts
Você pode Ligar alguns controles de conteúdo a elementos em partes XML Personalizars que são incorporados no documento.Para obter mais informações sobre partes XML Personalizars, consulte Visão geral de Parts XML Personalizar.
Para Ligar um Controlarar de conteúdo a um elemento em uma parte XML Personalizar, use a propriedade XMLMapping do Controlarar.O exemplo de código a seguir demonstra como Ligar um PlainTextContentControl o elemento Price no nó Product uma parte XML Personalizar que já tenha sido adicionado ao documento.
plainTextContentControl1.XMLMapping.SetMapping("/Product/Price")
plainTextContentControl1.XMLMapping.SetMapping("/Product/Price", String.Empty, null);
Para um explicação passo a passo que demonstra como Ligar controles de conteúdo a partes XML Personalizars em mais detalhes, consulte Demonstra Passo a passo: Controles de conteúdo ligação Personalizar XML Parts.
Quando você vincula um Controlarar de conteúdo a uma parte XML Personalizar, a ligação de dados bidirecional é automaticamente Habilitado.Se um usuário edita texto no Controlarar, os elementos XML correspondentes serão atualizados automaticamente.Da mesma forma, se os valores de elemento em partes XML Personalizars forem alterados, os controles de conteúdo que são Ligados aos elementos XML exibirá os novos dados.
Você pode Ligar os seguintes tipos de controles de conteúdo a partes XML Personalizars:
Ligação de eventos para controles de conteúdo de dados
Tudo controles de conteúdo fornecem um conjunto de eventos que você pode manipular para executar tarefas relacionadas a dados, como validar que o texto em um controle atende a determinados critérios antes que a Origem de dados seja atualizada.A tabela a seguir lista os eventos Controlarar de conteúdo relacionados à ligação de dados.
Tarefa |
Evento |
|---|---|
Executar o código imediatamente antes do Word atualiza automaticamente o texto em um Controlarar de conteúdo que será Ligado a uma parte XML Personalizar. |
|
Execução de código imediatamente antes do Word atualiza automaticamente os dados em uma parte XML Personalizar que será Ligado a um conteúdo controlar (isto é, após o texto no controle de conteúdo é alterado). |
|
Execute seu próprio código para validar o conteúdo do Controlarar de acordo com critérios Personalizars. |
|
Execute código após o conteúdo do Controlarar ter sido validado com êxito. |
Limitações de controles de conteúdo
Quando você usa controles de conteúdo em seus projetos de Ferramentas do Visual Studio para o Office, esteja ciente das seguintes limitações.
Diferenças de comportamento entre o tempo de design e tempo de execução
Muitas das limitações que o Microsoft Office Word impõe em controles de conteúdo em tempo de execução não são aplicadas no tempo de design.Quando você Design a interface do usuário de uma solução de nível de documento em Visual Studio, não deixe modificar controles de conteúdo somente de maneiras que há suporte para em tempo de execução.
Se você modificar um Controlarar de conteúdo em tempo de design de uma forma que o Controlarar não dá suporte em tempo de execução, o designer de Visual Studio não alertará das alterações sem suporte.No entanto, quando você depurar ou executar o projeto ou se você salvar e reabra o projeto, o Word exibirá uma permissão de mensagem e Solicitar de erro para reparar o documento.Quando você Reparar o documento, o Word remove conteúdo completo sem suporte e a formatação do Controlarar.
Por exemplo, o Word não impede que você adicionar uma tabela para um PlainTextContentControl em tempo de design.No entanto, como PlainTextContentControl objetos não podem conter tabelas em tempo de execução, o Word exibirá uma mensagem de erro quando o documento for aberto.
Também, Anotação que várias propriedades que Definirm o comportamento de controles de conteúdo têm efeito em tempo de design.Por exemplo, se você definir a propriedade LockContents de um Controlarar de conteúdo para True em tempo de design, você ainda pode editar o texto no Controlarar no designer Visual Studio.Essa propriedade só impede que usuários o Controlarar de edição em tempo de execução.
Limitações do evento
Controles de conteúdo não fornecem um evento que é aumentado quando o usuário altera o texto ou outros itens no controle.Por exemplo, não há nenhum evento que é aumentado quando um usuário seleciona um item diferente em um DropDownListContentControl ou ComboBoxContentControl.
Para determinar quando um usuário edita o conteúdo de um Controlarar de conteúdo, você pode Ligar o Controlarar a uma parte XML Personalizar e, em seguida, manipular o evento de StoreUpdating.Este evento é ocasionado quando o usuário altera o conteúdo de um Controlarar Ligado a uma parte XML Personalizar.Para um explicação passo a passo que demonstra como Ligar um Controlarar de conteúdo para uma parte XML Personalizar, consulte Demonstra Passo a passo: Controles de conteúdo ligação Personalizar XML Parts.
Consulte também
Tarefas
Como: Adicionar controles de conteúdo a documentos do Word
Demonstra Passo a passo: Criando um modelo usando controles de conteúdo
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 |
Adicionado informações sobre como usar controles de conteúdo em projetos de nível de aplicativo. |
Alteração de recurso do SP1. |