Demonstra Passo a passo: Coletando dados usando um Windows Form

Artigo
08/08/2011

Esta explicação passo a passo demonstra como abrir um formulário do Windows a partir de uma personalização em nível de documento do Excel de Microsoft Office, coletar informações do usuário e gravar as informações em uma célula de planilha.

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 Microsoft Office 2010 e o sistema 2007 do Microsoft Office. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Embora este passo a passo usa um projeto de nível de documento especificamente para o Excel, os conceitos demonstrados pela explicação são aplicáveis a outros projetos do Office.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

Microsoft Office Excel 2007 ou Excel 2010.

Observação
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

Creating a New Project

A primeira etapa é criar um projeto da pasta de trabalho do Excel.

Para criar um novo projeto.

Criar um projeto de pasta de trabalho do Excel com o nome WinFormInput e, em seguida, selecione criar um novo documento no assistente. For more information, see Como: Criar projetos do Office em Visual Studio.

Abre a nova pasta de trabalho do Excel no designer de Visual Studio e adiciona a WinFormInput de projeto para Solution Explorer.

Adicionando um controle de NamedRange na planilha

Para adicionar um intervalo nomeado para Sheet1

Selecione a célula A1 em Sheet1.
No nome , digite formInput.

O nome caixa está localizada à esquerda da barra de fórmulas, acima de coluna a da planilha.
Press ENTER.

A NamedRange controle é adicionado à célula A1. Houver indicação visível na planilha, mas formInput aparece no nome caixa (logo acima da planilha no lado esquerdo) e de Propriedades janela quando a célula A1 está selecionada.

Adicionar um formulário do Windows para o projeto

Crie um formulário do Windows para solicitar informações ao usuário.

Para adicionar um formulário do Windows

Selecione o projeto WinFormInput na Solution Explorer.
Sobre o projeto menu, clique em Add Windows Form.
Nomeie o formulário GetInputString.vb ou GetInputString.cse em seguida, clique em Add.

O novo formulário abre no designer.
Adicionar uma TextBox e um Button para o formulário.
Selecione o botão, para encontrar a propriedade texto na Propriedades janela e alterar o texto para OK.

Em seguida, adicione código para ThisWorkbook.vb ou ThisWorkbook.cs para coletar informações de. o usuário

Exibindo o formulário do Windows e a coleta de informações

Criar uma instância de GetInputString Windows Form e exibi-la e, em seguida, escrever as informações do usuário em uma célula na planilha.

Para exibir o formulário e coletar informações

Com o botão direito ThisWorkbook. vb ou ThisWorkbook.cs na Solution Explorere em seguida, clique em Exibir código.

No Open o manipulador de eventos de ThisWorkbook, adicione o seguinte código para declarar uma variável para o formulário GetInputString e, em seguida, mostrar o formulário.

Observação
C#, você deve adicionar um manipulador de eventos como mostra a Startup evento abaixo. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.

Private Sub ThisWorkbook_Open() Handles Me.Open
    Dim inputForm As New GetInputString()
    inputForm.Show()
End Sub

private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    this.Open += new 
        Microsoft.Office.Interop.Excel.WorkbookEvents_OpenEventHandler(ThisWorkbook_Open);
}

private void ThisWorkbook_Open()
{
    GetInputString inputForm = new GetInputString();
    inputForm.Show();
}

Criar um método chamado WriteStringToCell que escreve o texto a um intervalo nomeado. Este método é chamado a partir do formulário e a entrada do usuário é passada para o NamedRange o controle, formInput, na célula A1.
```
Public Sub WriteStringToCell(ByVal formData As String)
    Globals.Sheet1.formInput.Value2 = formData
End Sub
```
```
public void WriteStringToCell(string formData)
{
    Globals.Sheet1.formInput.Value2 = formData;
}
```

Em seguida, adicione código para o formulário para manipular o click do botão eventos.

Enviando informações para a planilha.

Para enviar informações para a planilha.

Com o botão direito GetInputString na Solution Explorere em seguida, clique em View Designer.
Clique duas vezes no botão para abrir o arquivo de código com o botão Click o manipulador de eventos adicionado.
Adicione código ao manipulador de eventos para obter a entrada da caixa de texto, enviá-lo para a função WriteStringToCelle então feche o formulário.
```
Globals.ThisWorkbook.WriteStringToCell(Me.TextBox1.Text)
Me.Dispose()
```
```
Globals.ThisWorkbook.WriteStringToCell(this.textBox1.Text);
this.Dispose();
```

Testing

Agora você pode executar o projeto. O formulário do Windows aparece e sua entrada aparece na planilha.

Para testar a sua pasta de trabalho.

Pressione F5 para executar seu projeto.
Confirme se o formulário do Windows aparece.
Digite Hello World na caixa de texto e, em seguida, clique em OK.
Confirme se o Hello World aparece na célula A1 da planilha.

Próximas etapas

Esta explicação passo a passo mostra noções básicas de mostrando um Windows Form e passando dados para uma planilha. Outras tarefas que você pode desejar executar:

Use os controles Windows Forms em uma pasta de trabalho do Excel ou um documento do Word. For more information, see Controles do Windows Forms em Visão geral de documentos do Office.
Modificar a interface do usuário de um aplicativo de Microsoft Office de uma personalização em nível de documento ou um suplemento em nível de aplicativo. For more information, see Personalização de interface do usuário do Office.

Consulte também

Compartilhar via