Controles do Windows Forms em Visão geral de documentos do Office

Artigo
02/25/2013

Os controles de formulários do windows são objetos que os usuários podem interagir para inserir ou manipular dados.Em projetos da nível do Microsoft Office Excel e Microsoft Office Word, você pode adicionar controles de formulários do windows para o documento ou pasta de trabalho em seu projeto em tempo de design, ou você pode programaticamente adicionar esses controles em tempo de execução.Você pode programaticamente adicionar esses controles a qualquer documento aberto ou planilha em tempo de execução em um suplemento ao nível para o excel ou palavras.

Para obter mais informações, consulte 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 2013 e Excel 2010; Word 2013 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 de formulários do windows para documentos e personalizáveis para elementos de interface do usuário (UI), incluindo painéis ações, os painéis de tarefa personalizada, e os formulários do windows.Os controles de formulários do windows geralmente têm o mesmo comportamento em documentos que em esses outros elementos de interface do usuário, mas existem algumas diferenças.Para obter mais informações, consulte: Limitações dos controles do Windows Forms em documentos do Office.

A decisão se adicionar controles de formulários do windows a um documento ou qualquer outro elemento de interface do usuário depende de vários fatores.A o criar a interface de usuário da solução, considere os usos de controles de formulários do windows como descrito na tabela a seguir.

em um documento.
- Quando você desejar exibir os controles 100% de tempo.
- Quando você deseja que os usuários insiram dados diretamente no documento, por exemplo, em documentos com base em formulários onde a superfície de edição é bloqueada.
- Quando você deseja que os controles para exibir na linha de dados no documento.Por exemplo, se você estiver adicionando botões a cada linha de um objeto da lista, você desejar-os-&z na linha de cada item de lista.
Em o painel ações ou painel de tarefa personalizada.
- Quando você deseja fornecer informações contextuais para o usuário.
- Quando você desejar somente os resultados para aparecer no documento, e não os controles e os dados da consulta.
- Quando você deseje garantir que os controles não será impresso com o documento.
- Quando você deseje garantir que os controles não interfiram na exibição do documento.
Em um windows form.
- Quando você desejar controlar o tamanho de interface do usuário.
- Quando você deseja impedir que os usuários ocultem ou excluam os controles.
- Quando você deseja obter a entrada do usuário, e impedir que o usuário faça nada no documento até que a entrada é recebida.

Adicionando controles de formulários do windows por meio de programação

Você pode adicionar controles de formulários do windows para documentos da palavra e a planilhas do excel em tempo de execução.Visual Studio Tools for Office Runtime fornece métodos auxiliares para adicionar controles do mais comuns.Esses métodos auxiliares permite que você adicione controles a seu documento do Office e acessar rapidamente a funcionalidade combinada de controle formulários do windows e a funcionalidade Office- relacionado de esses controles.

Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução.

Usando controles de formulários do windows em projetos de um documento Nível

Alguns aspectos de usar controles de formulários do windows em documentos os projetos são exclusivos da nível de, que permitem criar a interface de usuário de seu documento usando o designer do Visual Studio.

Criando controles de usuário personalizados

Você pode adicionar um controle de usuário ao seu projeto e em seguida adicione-o a Caixa de Ferramentas.Você pode então arraste o controle de usuário diretamente no seu documento da mesma maneira que você adicionaria um controle de formulários do windows no seu documento.Existem algumas coisas para ter em mente quando você cria controles de usuário:

Não crie um controle de usuário de sealed .Quando você arrastar o controle para o documento, o Visual Studio gera uma classe envoltório derivada de controle de usuário para estender-lo e suportar seu uso no documento.Se o controle de usuário é sealed, o Visual Studio não pode gerar a classe wrapper.
Controles de usuário devem ter o atributo de ComVisibleAttribute definido como true.Controles de usuário criados em um projeto do Office têm esse atributo definido como true por padrão, mas os controles de usuário que fazem parte de projetos externos podem não ter esse atributo definido como true.
Depois que você adicionou um controle de usuário ao documento, não renomear ou não excluir a classe de UserControl do projeto.Se você precisar alterar o nome de um controle de usuário você deve primeiro excluí-lo do documento, e adicioná-lo novamente após o nome foi alterado.

Organizando controles em tempo de design

Se você adicionar vários controles aos documentos da palavra e o excel em tempo de design, você pode rapidamente configurar o alinhamento de todos os controles selecionados usando barras de ferramentas de Microsoft Office Word e de Microsoft Office Excel no Visual Studio.Essas barras de ferramentas ficão disponíveis somente quando um documento ou uma planilha é aberto no designer.

Quando você selecionar vários controles no designer, você pode usar os seguintes botões em essas barras de ferramentas para organizar controles:

Alinhar esquerdas
Alinhar centros
Alinhar direitas
Alinhar partes superiores
Alinhar meios
Alinhar partes inferiores
Igualar espaçamento horizontal
Igualar espaçamento vertical

Observação
Em projetos da palavra, esses botões são ativados somente se os controles selecionados são não na linha de texto.Por padrão, os controles que você adicionar ao documento em tempo de design são na linha de texto.

Impedindo dados antigos apareçam nas pastas de trabalho do Excel durante o carregamento

Quando você adiciona controles de formulários do windows para documentos ou em planilhas em tempo de design, os controles permanecem no documento quando o usuário fecha o documento.Os controles adicionados em tempo de design são chamados também controles.

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 ActiveX até que o código de personalização executa e carregue o controle real.O excel cria esse bitmap e armazená-lo na pasta de trabalho sempre que a pasta de trabalho são salvas.O bitmap mostra o controle como pareceu a última vez que a pasta de trabalho foi salva, incluindo quaisquer dados que o controle está exibindo o.Para obter mais informações sobre o controle ActiveX que contém controles e bitmaps de formulários do windows, consulte Limitações dos controles do Windows Forms em documentos do Office.

Em determinadas circunstâncias, o código não carrega e somente o bitmap é exibido, como quando o usuário abre a pasta de trabalho no modo de design.Além de isso, se o usuário abre a pasta de trabalho em um computador que não tenha Visual Studio Tools for Office Runtime instalado, 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 dos controles em pastas de trabalho antes de salvar a pasta de trabalho e enviando um a outro usuário para garantir que suas informações pessoais não é divulgada acidentalmente.

Tamanho do controle correspondente ao tamanho das células em uma planilha do excel

Você pode definir o controle a ser redimensionada automaticamente quando o tamanho da célula pai é alterado.Para obter mais informações, consulte Como: redimensionar os controles dentro das células da planilha.

Adicionando componentes que são compartilhados por todas as planilhas

Você pode adicionar os componentes que você deseja compartilhar entre todas as planilhas, como DataSet, o designer de pasta de trabalho em vez em planilhas.O componente será exibido na bandeja de componentes.

Fórmula para inserir controles em uma planilha do excel

Quando você seleciona um controle do excel, você verá =EMBED (“WinForms.Control.Host”, "") em Barra de Fórmulas.Esse texto é necessário e não deve ser excluído.

Estilo de layout de controles em um documento do word

Quando você adiciona um controle ao documento do word em um projeto da nível de aplicativo usando o designer do Visual Studio, o controle será adicionado na linha de texto.Para alterar o estilo de layout do controle, clique com o botão direito do mouse no controle e clique em Formatar controle.Selecione um estilo de quebra automática na página de Layout da caixa de diálogo de Formatar Objeto .

Quando você adiciona um controle a um documento do word em tempo de execução, você pode especificar o estilo de layout do novo controle usando diferentes sobrecargas do método de Add<classe de controle> da classe de Microsoft.Office.Tools.Word.ControlCollection :

Para adicionar o controle na linha de texto, use uma sobrecarga que aceita Range que especifica o local do controle.
Para adicionar o controle como uma forma flutuante, use uma sobrecarga que aceita as coordenadas da esquerda e superior do controle.

Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução.

Se você abrir um modelo de palavras no designer do Visual Studio, os controles não embutidas no modelo não pode ser visíveis como o Visual Studio abre o modelo no modo de Normal .Para exibir os controles, alterar a exibição de Layout de Impressão.

Controles fora do corpo do documento principal

Os controles de formulários do windows não são suportados em um cabeçalho ou um rodapé, ou em um subdocument.

Adicionando componentes em tempo de design

Os certos controles ou componentes não são visíveis no documento e são exibidos em vez de na bandeja de componentes.Visual Studio fornece uma bandeja de componentes para cada janela do documento.A bandeja de componentes aparece na tela somente se os componentes existem no documento.

Consulte também

Partilhar via