Como: Adicionar controles de Windows Forms a documentos do Office

Você pode adicionar controles Windows Forms para o Microsoft Office Excel e documentos do Microsoft Office Word em tempo de design em projetos de nível de documento.Em tempo de execução, você pode adicionar controles em personalizações em nível de documento e em suplementos de nível de aplicativo.Por exemplo, você pode adicionar um Controlarar de ComboBox à sua planilha para que os usuários podem selecionar de uma lista de opções.

Este tópico descreve as seguintes tarefas:

• Adicionar controles no tempo de design

• Adicionar controles no tempo de execução em projetos de nível de documento

• Adicionar controles no tempo de execução em suplementos de nível de aplicativo

Você também pode adicionar controles de host, como controles de Bookmark e NamedRange controles, para documentos do Office.Para obter mais informações, consulte Controles de host do Word e Controles de host do Excel.

Adicionando controles em tempo de design

Há várias maneiras de adicionar controles Windows Forms ao documento em um projeto de nível de documento em tempo de design.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Para arrastar um Windows Forms Controlarar para o documento

1. Criar ou Abrir um projeto de pasta de trabalho do Excel ou um documento do Word projeto no Visual Studio para que o documento fique visível no designer.Para obter informações sobre a criação de projetos, consulte Como: Criar o Visual Studio Tools para projetos do Office.

2. Na guia Controles ComComumComum de De caixa de ferramentas, clique no controle que você deseja adicionar e arraste-o para o docComumento.

   Observação:
   Quando você Selecionar um Controlarar no Excel, você verá =EMBED("WinForms.Controlar.Host","")no De barra de fórmulas.Esse texto é necessário e não deve ser excluído.

Para desenhar um Windows Forms Controlarar no documento

1. Criar ou Abrir um projeto de pasta de trabalho do Excel ou um documento do Word projeto no Visual Studio para que o documento fique visível no designer.Para obter informações sobre a criação de projetos, consulte Como: Criar o Visual Studio Tools para projetos do Office.

2. Na guia Controles ComComumComum de De caixa de ferramentas, clique no controle que você deseja adicionar.

3. No documento, clique onde deseja que o superior Esquerda canto do Controlarar para ser localizado e arraste para onde você deseja que o canto inferior direito do Controlarar a ser localizado.

   O Controlarar é adicionado ao documento com o local especificado e o tamanho.

   Observação:
   Quando você Selecionar um Controlarar no Excel, você verá =EMBED("WinForms.Controlar.Host","")no De barra de fórmulas.Esse texto é necessário e não deve ser excluído.

Para adicionar um Controlarar Windows Forms ao documento por Simples-clicar no Controlarar

1. Criar ou Abrir um projeto de pasta de trabalho do Excel ou um documento do Word projeto no Visual Studio para que o documento fique visível no designer.Para obter informações sobre a criação de projetos, consulte Como: Criar o Visual Studio Tools para projetos do Office.

2. Na guia Controles ComComumComum de De caixa de ferramentas, clique no controle que você deseja adicionar

3. Um documento, clique onde deseja que o Controlarar a ser adicionado.

   O Controlarar é adicionado ao documento com o tamanho padrão.

   Observação:
   Quando você Selecionar um Controlarar no Excel, você verá =EMBED("WinForms.Controlar.Host","")no De barra de fórmulas.Esse texto é necessário e não deve ser excluído.

Para adicionar um Controlarar Windows Forms ao documento clicando Duplo no Controlarar

1. Criar ou Abrir um projeto de pasta de trabalho do Excel ou um documento do Word projeto no Visual Studio para que o documento fique visível no designer.Para obter informações sobre a criação de projetos, consulte Como: Criar o Visual Studio Tools para projetos do Office.

2. Na guia Controles ComComumComum de De caixa de ferramentas, clique Duplo o controle que você deseja adicionar.

   O Controlarar é adicionado ao documento no Centralizar do documento ou painel ativo.

   Observação:
   Quando você Selecionar um Controlarar no Excel, você verá =EMBED("WinForms.Controlar.Host","")no De barra de fórmulas.Esse texto é necessário e não deve ser excluído.

Para adicionar um Controlarar Windows Forms ao documento pressionando a tecla ENTER

1. Criar ou Abrir um projeto de pasta de trabalho do Excel ou um documento do Word projeto no Visual Studio para que o documento fique visível no designer.Para obter informações sobre a criação de projetos, consulte Como: Criar o Visual Studio Tools para projetos do Office.

2. Na guia Controles ComComumComum de De caixa de ferramentas, clique no controle que você deseja adicionar e Pressionarionar a tecla ENTER.

   O Controlarar é adicionado ao documento no Centralizar do documento ou painel ativo.

   Observação:
   Quando você Selecionar um Controlarar no Excel, você verá =EMBED("WinForms.Controlar.Host","")no De barra de fórmulas.Esse texto é necessário e não deve ser excluído.

Adicionando controles em tempo de execução em projetos de nível de documento

Por meio de programação você pode adicionar controles Windows Forms a um documento em tempo de execução.No Word, usar métodos da propriedade Controls da classe ThisDocument.No Excel, use métodos da propriedade Controls de uma classe de n Sheet.Cada método tem várias sobrecargas que permitem que você especifique a localidade do Controlarar de maneiras diferentes.For more information, see Métodos de auxiliar para controles Windows Forms.

Quando você Adicionar um Controlare Windows Forms para um documento no executar tempo, o Controlare não é mantido no documento quando o documento é Fechada.Você pode recriar o Controlarar a Avançar vez que o documento for aberto.For more information, see Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um Controlarar Windows Forms em tempo de execução

• Usar um método Microsoft.Office.Tools.Word.ControlCollection (para projetos do Word) ou método em Microsoft.Office.Tools.Excel.ControlCollection (para projetos do Excel) que tem o nome Add<Controlarar classe > (onde de classe de Controlarar de é o nome de classe do Controlarar Windows Forms que você deseja adicionar, como AddButton).

  O exemplo de código a seguir demonstra como adicionar um Button para a célula C5 de Sheet1 em um projeto de nível de documento para o Excel.

  Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
      Handles Me.Startup
  
      Dim salesButton As Microsoft.Office.Tools.Excel.Controls.Button
      salesButton = Me.Controls.AddButton(Me.Range("C5"), "salesButton")
      salesButton.Text = "Calculate Total Sales"
  End Sub
  

  private void Sheet1_Startup(object sender, System.EventArgs e)
  {
      Microsoft.Office.Tools.Excel.Controls.Button salesButton;
      salesButton = this.Controls.AddButton(this.get_Range("C5", missing), "salesButton");
      salesButton.Text = "Calculate Total Sales";
  }
  

Adicionando controles em tempo de execução em suplementos de nível de aplicativo

Você pode adicionar controles Windows Forms programaticamente a qualquer Abrir documento em tempo de execução.Em primeiro lugar, gerar um item de host que se baseia uma Abrir documento ou planilha.Em seguida, no Word, use métodos da propriedade Document.Controls do novo item de host.No Excel, use métodos da propriedade Worksheet.Controls do novo item de host.Cada método tem várias sobrecargas que permitem que você especifique a localidade do Controlarar de maneiras diferentes.For more information, see Métodos de auxiliar para controles Windows Forms.

Quando você Adicionar um Controlare Windows Forms para um documento no executar tempo, o Controlare não é mantido no documento quando o documento é Fechada.Você pode recriar o Controlarar a Avançar vez que o documento for aberto.For more information, see Adicionar controles a documentos do Office em tempo de execução.

Para obter mais informações sobre host gerar itens em projetos de nível de aplicativo, consulte Estendendo os documentos do Word e Excel pastas de trabalho no nível de aplicativo Adicionar-ins em tempo de execução.

Para adicionar um Controlarar Windows Forms em tempo de execução

• Usar um método Microsoft.Office.Tools.Word.ControlCollection (para projetos do Word) ou método em Microsoft.Office.Tools.Excel.ControlCollection (para projetos do Excel) que tem o nome Add<Controlarar classe > (onde de classe de Controlarar de é o nome de classe do Controlarar Windows Forms que você deseja adicionar, como AddButton).

  O exemplo de código a seguir demonstra como adicionar um Button ao primeiro parágrafo do documento ativo usando um suplemento do Word.

  Dim salesButton As Microsoft.Office.Tools.Word.Controls.Button
  Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()
  
  extendedDocument.Paragraphs(1).Range.InsertParagraphBefore()
  salesButton = extendedDocument.Controls.AddButton( _
      extendedDocument.Paragraphs(1).Range, 75, 18, "salesButton")
  salesButton.Text = "Calculate Sales"
  

  Microsoft.Office.Tools.Word.Controls.Button salesButton;
  Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();
  
  extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
  salesButton = extendedDocument.Controls.AddButton(
      extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
  salesButton.Text = "Calculate Sales";
  

Consulte também

Tarefas

Como: Redimensionar controles dentro de células de planilha

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

Itens de host e Visão geral sobre controles de host

Noções básicas sobre parâmetros opcionais in Office Solutions