Compartilhar via

Limitações do Windows Forms Controls em documentos do Office

  • Artigo

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

  • O Excel 2003

  • O Excel 2007

  • Word 2003

  • Word 2007

Projetos de nível de aplicativo

  • O Excel 2007

  • Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Existem algumas diferenças entre controles Windows Forms que são adicionados a documentos do Microsoft Office Word ou planilhas do Microsoft Office Excel e os controles Windows Forms que são adicionados ao Windows Forms.Por exemplo, quando você Adicionar um Controlarar de Button em um documento, propriedades, como Dock, Anchore TabIndex não se comportam como esperado.

Muitas dessas diferenças são causadas pela forma como a que o Windows Forms controles estão hospedados em documentos.Quando um Controlarar Windows Forms é adicionado a um documento, Ferramentas do Visual Studio para o Office incorpora um Controlarar ActiveX que hospeda, em seguida, o Controlarar Windows Forms no documento.O Controlarar Windows Forms não está incorporado diretamente no documento.

Limitações de métodos e propriedades de controles de Windows Forms

Há um Número de métodos e propriedades dos controles de Windows Forms que não funcionam da mesma forma em um documento como fariam em um formulário do Windows e, portanto, é recomendável que eles não sejam usados.Por exemplo, propriedades de configuração, como Dock e Anchor só afeta a posição do Controlarar com relação para o Contêiner de Controlarar ActiveX, em vez do documento.A seguir está uma lista de métodos sem suporte e propriedades dos controles Windows Forms para o Word e Excel:

  • Não há suporte para métodos e propriedades de controles do Excel:

    • Anchor

    • Dock

    • Location

    • TabIndex

    • TabStop

    • TopLevelControl

  • Não há suporte para métodos e propriedades de controles do Word:

    • Hide

    • Show

    • Anchor

    • Dock

    • Location

    • TabIndex

    • TabStop

    • TopLevelControl

    • Visible

Você também não é possível definir o Left ou a propriedade de Top dos controles Windows Forms que estão na linha com texto em um documento do Word.Controles Windows Forms são adicionados em alinhado com texto nos seguintes casos:

Diferenças em controles do Windows Forms em documentos do Office

Controles de Windows Forms geralmente têm o mesmo comportamento em um documento do Office como eles fazem em um formulário do Windows, mas existem algumas diferenças.A tabela a seguir descreve as diferenças existentes para controles Windows Forms em documentos do Office.

Funcionalidade

Difference

Controlarar Ordem de Guiaulação

Não é possível Guia por meio de controles colocados em uma planilha do Excel ou um documento do Word.

Agrupamento de Controlarar

Você não pode usar um controle de GroupBox para conter outros controles em um documento do Office.Quando você Adicionar vários botões de Rádio diretamente para o documento, os botões de Rádio não são mutuamente exclusivos.Você pode Gravar código para tornar os botões de Rádio mutuamente exclusivos; no entanto, a abordagem preferencial é adicionar os botões de Rádio a um Controlarar de usuário e, em seguida, adicionar o Controlarar de usuário para o documento.Para obter mais informações, consulte Exemplo de controles do Word ou Exemplo de controles do Excel.

Tipo de controle

Controles Windows Forms usados em documentos são encapsuladas uma classe fornecida pela Ferramentas do Visual Studio para o Office fornece a funcionalidade de controles adicionais específica para a planilha do Excel ou documento do Word.Por exemplo, se você tiver um Controlarar de Button em uma planilha do Excel, ser-se de especificar o tipo como Microsoft.Office.Tools.Excel.Controls.Button , em vez de System.Windows.Forms.Button quando referência ou converter o objeto.

Posição do Controlarar e o tamanho

O tamanho e a posição do Controlarar é determinada pelas propriedades que fazem parte do Contêiner de Controlarar ActiveX.As propriedades de Controlarar ActiveX têm diferentes valores que as propriedades equivalentes de um Controlarar Windows Forms.Quando você define a Top, Left, Heightou Width propriedades de um Controlarar, ele é medido em pontos, em vez de pixels.

Posição do Controlarar em documentos do Word

Se você adicionar controles a um layout baseado em fluxo, tenha em mente que os controles fluirá com o conteúdo medida que muda a conteúdo.Você não é possível ancorar o Controlarar para um parágrafo quando você arrasta-lo da De caixa de ferramentas porque o Controlarar é adicionado ao documento do Word em alinhado com texto.Se você usar outro método para adicionar o Controlarar, como Duplo no Controlarar, o Controlarar é inserido conforme à opção Word que tiver definido para inserir imagens.

Você não defina a Left ou Top propriedade de um Controlarar que está em linha com texto.

Não é possível colocar controles em um cabeçalho ou rodapé ou em um subdocumento.

Eventos de Controle

Quando o Controlarar é selecionado, ele gera eventos na seguinte ordem:

  1. Enter

  2. GotFocus

Quando o Controlarar é desmarcado, ele gera eventos na seguinte ordem:

  1. Leave

  2. Validating

  3. Validated

  4. LostFocus

Dimensionamento do Controlarar

Quando você Alterar a zoom configuração de um documento para qualquer valor diferente de 100 %, controles estão desativados, embora eles Aparecer para dimensionar com o documento.Por exemplo, se você Clique um botão quando o documento está em 130% zoom, ele mostrará uma mensagem que o Controlarar foi desativado até que o zoom é definido como 100 %.Os controles funcionará corretamente quando você Alterar o zoom como 100 %.

Valores de propriedade do Controlarar

Embora as propriedades dos controles em um Windows Formulário estiverem definidas como um valor inteiro, elas são definidas como um Simples para controles em um documento do Word.No Excel, os valores de propriedade de controles são definidos como um Duplo.Se a Height e Width a propriedade de um Controlarar em uma planilha excede o tamanho da planilha ou da tela, o valor é truncado.

Redimensionamento de Controlarar

Se você redimensionar um Controlarar em que o documento usando uma das alças de dimensionamento oito, o novo Controlarar dimensões não são refletidas no Propriedades janela até que o Controlarar é reselected.

Comportamento do Controlarar

Controles em uma planilha do Excel podem se comportar é imprevisível quando a janela da planilha está Dividir.Por exemplo, Acessar a um TextBox na planilha pode apenas ser disponível em uma das janelas.

Nomeação de Controlarar

Não é possível usar palavras reservadas para controles de nome.Por exemplo, se você adicionar um Button a uma planilha e alterar o nome para o sistema, erros ocorrem quando você Compilação o projeto.

Programaticamente adicionar controles

Não use o construtor do Controlarar para adicionar um Controlarar ao seu documento em tempo de execução.Em vez disso, use os métodos de auxiliar fornecidos pelo Ferramentas do Visual Studio para o Office.Por exemplo, use o método de AddButton para adicionar um botão a uma planilha.Se você quiser adicionar um Controlarar que não há suporte para esses métodos auxiliares, você pode usar o método AddControl.For more information, see Adicionar controles a documentos do Office em tempo de execução.

Copiar controles

Se você copiar um Controlarar Windows Forms e colá-lo em um documento em tempo de execução, um contêiner vazio Controlarar ActiveX é colado no documento.O Controlarar Windows Forms não Aparecer no novo local, e Código-behind o Controlarar original não é copiado para o Contêiner de Controlarar ActiveX.

Limitações no nível de documento projetos

Algumas limitações do uso de controles de Windows Forms em documentos são Exclusivo para projetos de nível de documento.

Suporte de Controlarar em tempo de design

Determinados controles Windows Forms são removidos do Caixa de Ferramentas quando uma planilha do Excel ou documento do Word é Abrir no designer do Visual Studio.Isso acontece por causa da limitações técnicas ou porque a funcionalidade já está disponível no Word ou Excel.Ferramentas do Visual Studio para o Office suporta Tudo controles Windows Forms e outros componentes que Aparecerr em De caixa de ferramentas quando o documento tem foco e também permite controles de terceiros para ser adicionado ao seu documento.

Observação:

Tudo controles são removidos de o Caixa de ferramentas quando um documento está protegido.Para obter informações sobre a proteção do documento, consulte Proteção de documentos em soluções de nível de documento.
Observação:

Controles de terceiros devem ter o ComVisibleAttribute atributo definido como true em Ordem a ser usado em uma solução Ferramentas do Visual Studio para o Office.

Os seguintes controles e componentes não estão disponíveis em De caixa de ferramentas:

Suporte para controles de ActiveX herdado

Se você criar um projeto de Ferramentas do Visual Studio para o Office usando um documento do Word existente ou a pasta de trabalho do Excel que contém controles ActiveX, a funcionalidade dos controles ActiveX não está perdida; no entanto, não há nenhum suporte para adicionar novos controles ActiveX a seus documentos de em Ferramentas do Visual Studio para o Office.Por exemplo, se seu documento do Word possui um botão do Controlarar Caixa de Ferramentas que é executado uma macro do Visual Basic for Applications (VBA), ele continuará a executar a macro depois que o documento tiver sido usado em um projeto Ferramentas do Visual Studio para o Office.No entanto, é recomendável que você remova os controles ActiveX e as macros do VBA e Substituir-los com controles de Windows Forms e o código gerenciado.

Consulte também

Tarefas

Como: Adicionar controles de Windows Forms a documentos do Office

Conceitos

Controles de formulários do Windows em Visão geral de documentos do Office

Adicionar controles a documentos do Office em tempo de execução

Outros recursos

Controles em documentos do Office

Date

History

Motivo

De 2008 de julho

Adicionar informações para diferenciar entre Geral limitações e limitações específicas para personalizações em nível de documento.

Alteração de recurso do SP1.