Controles do Windows Forms em Visão geral de documentos do Office
Windows Forms controls are objects that users can interact with to enter or manipulate data. In document-level projects for Microsoft Office Excel and Microsoft Office Word, you can add Windows Forms controls to the document or workbook in your project at design time, or you can programmatically add these controls at run time. Você pode programaticamente adicionar esses controles para qualquer documento aberto ou uma planilha em tempo de execução em um suplemento em nível de aplicativo para o Excel ou Word.
For more information, see Como: Adicionar controles do Windows Forms a documentos do Office.
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 os seguintes aplicativos: Excel 2007 e Excel 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.
Usando controles Windows Forms
Você pode adicionar controles Windows Forms para documentos e elementos de interface (UI) do usuário personalizável, incluindo painéis de ações, painéis de tarefas personalizados e formulários do Windows. Controles Windows Forms geralmente têm o mesmo comportamento em documentos como esses outros elementos da interface do usuário, mas existem algumas diferenças. For information, see Limitações dos controles do Windows Forms em documentos do Office.
A decisão se você deseja adicionar controles Windows Forms a um documento ou outro elemento de interface do usuário depende de vários fatores. Ao projetar a interface do usuário de sua solução, considere o uso de controles Windows Forms conforme descrito na tabela a seguir.
Em um documento.
Quando você deseja exibir os controles de 100% do tempo.
Quando você quiser que os usuários insiram dados diretamente no documento, por exemplo, em documentos baseados em formulários, onde a superfície de edição está bloqueada.
Quando você quiser que os controles para exibir de acordo com os dados no documento. Por exemplo, se você estiver adicionando botões para cada linha de um objeto de lista, você desejaria-los de acordo com cada item da lista.
No painel de ações ou um painel de tarefas personalizado.
Quando você deseja fornecer informações contextuais ao usuário.
Quando você quiser apenas os resultados aparecem no documento e não a controles de consulta e dados.
Quando você deseja garantir que os controles não são impressos com o documento.
Quando você deseja garantir que os controles não interferir com a visão do documento.
Em um Windows Form.
Quando você deseja controlar o tamanho da interface do usuário.
Quando você deseja impedir que usuários ocultar ou excluir os controles.
Quando você deseja obter entrada do usuário e impedir que o usuário fazer qualquer coisa no documento, até que a entrada seja recebida.
Adicionando controles Windows Forms programaticamente
Você pode adicionar controles Windows Forms para documentos do Word e planilhas do Excel em tempo de execução. O Visual Studio Tools for Office runtime fornece métodos auxiliares para a adição de controles mais comuns do Windows Forms. Esses métodos auxiliares permitem adicionar rapidamente controles para o seu documento do Office e o acesso a funcionalidade combinada de controle do Windows Forms e a funcionalidade desses controles relacionados ao Office.
For more information, see Adicionar controles a documentos do Office em tempo de execução.
Usando controles Windows Forms em projetos de nível de documento
Alguns aspectos do uso de controles do Windows Forms em documentos são exclusivos para projetos de nível de documento, que permitem projetar a interface do usuário do seu documento usando o designer de Visual Studio.
Criando controles de usuário personalizada
Você pode adicionar um controle de usuário ao seu projeto e, em seguida, adicioná-lo para o caixa de ferramentas. Então, você pode arrastar o controle de usuário diretamente ao seu documento, da mesma forma que você adicionaria um controle Windows Forms ao seu documento. Há algumas coisas a serem lembrados quando você criar controles de usuário:
Não crie um sealed controle de usuário. Quando você arrasta o controle ao seu documento, o Visual Studio gera uma classe de wrapper derivada do controle de usuário para estendê-lo e suporte para o seu uso no documento. Se o controle de usuário for sealed, Visual Studio não é possível gerar a classe de wrapper.
Controles de usuário devem ter o ComVisibleAttribute atributo definido como true. Controles de usuário criados dentro de um projeto do Office têm este atributo definido como true por padrão, mas o usuário que fazem parte de projetos externos de controles talvez não tenha este atributo definido como true.
Depois que você adicionou um controle de usuário para o documento, não renomeie ou exclua o UserControl a classe do projeto. Se você precisar alterar o nome de um controle de usuário deve primeiro excluí-lo do documento e, em seguida, adicioná-lo novamente após o nome foi alterado.
Organizando controles em tempo de Design
Se você adicionar vários controles aos seus documentos do Word e Excel em tempo de design, você pode configurar rapidamente o alinhamento de todos os controles selecionados usando o Microsoft Office o Word e Excel de Microsoft Office barras de ferramentas em Visual Studio. Essas barras de ferramentas estão disponíveis somente quando um documento ou planilha é aberta no designer.
Quando você seleciona vários controles no designer, você pode usar os seguintes botões nestas barras de ferramentas para organizar os controles:
Align Lefts
Alinhar centros
Align Rights
Align Tops
Alinhar meios
Align Bottoms
Igualar espaçamento Horizontal
Igualar espaçamento Vertical
.gif "Observação") Observação |
|---|
Em projetos do Word, esses botões são ativados somente se os controles selecionados não são compatíveis com texto. Por padrão, os controles que você adicionar ao documento em tempo de design são alinhado com o texto. For more information, see Usando os controles do Windows Forms em documentos do Word. |
Impedindo que os dados antigos que aparecem nas pastas de trabalho do Excel durante o carregamento
Quando você adiciona controles Windows Forms a documentos ou planilhas em tempo de design, os controles permanecem no documento quando o usuário fecha o documento. Também são chamados de controles adicionados em tempo de design controles estáticos.
Quando uma pasta de trabalho do Excel que contém controles estáticos é aberta, a pasta de trabalho exibe um bitmap do controle em um controle de ActiveX até que o código de personalização é executada e carrega o controle real. O Excel cria esse bitmap e armazena-o na pasta de trabalho sempre que a pasta de trabalho é salvo. O bitmap mostra o controle como ela apareceu na última vez em que foi salvo na pasta de trabalho, incluindo todos os dados que o controle estava exibindo. Para obter mais informações sobre o controle de ActiveX que contém os controles Windows Forms e bitmaps, consulte Limitações dos controles do Windows Forms em documentos do Office.
Em certas condições, o código não carrega e somente o bitmap é exibido, como, por exemplo, quando o usuário abre a pasta de trabalho no modo de design. Além disso, se o usuário abre a pasta de trabalho em um computador que não tenha a Visual Studio Tools for Office runtime instalado, a personalização não pode executar para carregar os controles e, portanto, somente o bitmap do controle é visível. Você sempre deve remover informações pessoais de controles em pastas de trabalho antes de salvar a pasta de trabalho e enviá-lo para outro usuário para garantir que suas informações pessoais não são divulgadas acidentalmente.
A adição de componentes em tempo de Design
Certos controles ou componentes não são visíveis no documento e em vez disso, são exibidos em uma bandeja de componente. Visual Studio fornece uma bandeja de componentes para cada janela de documento. Bandeja de componentes aparece na tela somente se os componentes existem no documento.
Consulte também
Tarefas
Como: Adicionar controles do Windows Forms a documentos do Office
Como: Redimensionar controles dentro das células da planilha
Como: Ocultar controles em planilhas, ao imprimir
Demonstra Passo a passo: Alterar a formatação de planilhas usando controles CheckBox
Demonstra Passo a passo: Alterar a formatação do documento usando os controles CheckBox
Demonstra Passo a passo: Exibir texto em uma caixa de texto em um documento usando um botão.
Demonstra Passo a passo: Exibir texto em uma caixa de texto em uma planilha usando um botão.
Referência
Conceitos
Usando os controles do Windows Forms em documentos do Word
Usando os controles do Windows Forms em planilhas do Excel
Adicionar controles a documentos do Office em tempo de execução
Itens de host e a visão geral sobre controles de Host
Limitações dos controles do Windows Forms em documentos do Office