Passo a passo: Coleta de dados usando um formulário do Windows

Artigo
02/25/2013

Essa explicação passo a passo demonstra como abrir janelas forma de uma personalização da nível do Microsoft Office Excel, coleta informações do usuário, e grava essas informações em uma célula de planilha.

Aplicáve a: As informações neste tópico se aplicam a projetos em nível de aplicativo e em nível de documento para o Office 2013 e o Office 2010. Consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Embora essa explicação passo a passo usa um projeto da nível do excel especificamente, os conceitos demonstrado pelo passo-a-passo são aplicáveis a outros projetos do Office.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).

Excel 2013 ou Excel 2010.

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

Criando um novo projeto

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

para criar um novo projeto

Crie um projeto de pasta de trabalho do Excel com o nome WinFormInput, e selecione Criar um novo documento no assistente.Para obter mais informações, consulte Como: criar projetos do Office em Visual Studio.

O Visual Studio abre a nova pasta de trabalho do Excel no designer e adiciona o projeto de WinFormInput a Gerenciador de Soluções.

Adicionando um controle de NamedRange a planilha

para adicionar um intervalo nomeado a Sheet1

Selecione a célula A1 em Sheet1.
Em a caixa de Nome , digite o formInput.

A caixa de Nome está localizada no lado esquerdo da barra de fórmula, logo acima da coluna a a planilha.
Pressione ENTER.

Um controle de NamedRange é adicionado à célula A1.Não há nenhuma indicando visível na planilha, mas formInput aparece na caixa de Nome (logo acima da planilha no lado esquerdo) e na janela de Propriedades quando a célula A1 é selecionada.

Adicione um windows form ao projeto

Crie um windows form para solicitar ao usuário para informações.

Para adicionar um formulário do windows

Selecione o projeto WinFormInput em Gerenciador de Soluções.
Em o menu de Projeto , clique Adicionar formulário do Windows.
Nomeie o formulário GetInputString.vb ou GetInputString.cs, clique em Adicionar.

O novo formulário abre no designer.
Adicione TextBox e Button ao formulário.
Selecione o botão, localize a propriedade Texto na janela de Propriedades , e o texto a OK.

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

Exibindo o formulário e coletando informações

Crie uma instância do windows de GetInputString formam-nas e exibir-l, e em seguida redigem-nos informações do usuário em uma célula na planilha.

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

Clique com o botão direito do mouse ThisWorkbook.vb ou ThisWorkbook.cs em Gerenciador de Soluções, clique em Exibir Código.

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

Observação
Em C#, você deve adicionar um manipulador de eventos conforme mostrado no evento de Startup 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();
}

Crie um método chamado WriteStringToCell que grava texto a um intervalo nomeado.Este método é chamado do formulário, e a entrada do usuário é passada para o controle de NamedRange , 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 o código ao formulário para manipular o evento de clique do botão.

Enviar informações para a planilha

Para enviar informações para a planilha

Clique com o botão direito do mouse GetInputString em Gerenciador de Soluções, clique em Exibir Designer.
Clique duas vezes no botão para abrir o arquivo de código no manipulador de eventos de Click do botão adicionado.
Adicione código ao manipulador de eventos para receber entrada da caixa de texto, enviá-lo para a função WriteStringToCell, e então feche o formulário.
```
Globals.ThisWorkbook.WriteStringToCell(Me.TextBox1.Text)
Me.Dispose()
```
```
Globals.ThisWorkbook.WriteStringToCell(this.textBox1.Text);
this.Dispose();
```

Testando

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

para testar sua pasta de trabalho

Pressione F5 para executar o seu projeto.
Confirme que o formulário do windows aparece.
Digite hello world na caixa de texto, e clique em OK.
Confirme que hello world aparece na célula A1 a planilha.

Próximas etapas

Essa explicação passo a passo mostra as noções básicas de mostrar um formulário do windows e de passar dados para uma planilha.Outras tarefas que você pode desejar executar incluem:

Controles de formulários do windows em uma pasta de trabalho do Excel ou em um documento do word.Para obter mais informações, consulte Controles do Windows Forms em Visão geral de documentos do Office.
Modifique a interface do usuário de um aplicativo do Microsoft Office de uma personalização de um documento ou nível de um suplemento ao aplicativo.Para obter mais informações, consulte Personalização de interface do usuário do Office.