Demonstra Passo a passo: Coletando dados usando um Windows Formulário

Artigo
08/25/2010

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

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

Pré-requisitos

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

Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).
O Microsoft Office Excel 2003 ou Microsoft Office Excel 2007.

Ferramentas do Visual Studio para o Office é instalado por padrão com as versões listadas do Visual Studio.Para Marcar se ele está instalado, Marcar Instalando o Visual Studio Tools para Office.

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.

Criando um novo projeto

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

Para criar um novo projeto

Criar um projeto de pasta de trabalho do Excel com o nome WinFormInput e Selecionar Criar um documento novo no Assistente.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

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

Adicionando um Controlarar de NamedRange para a planilha

Para adicionar um intervalo nomeado a Plan1

Selecionar a célula A1 em Sheet1.
Na caixa Nome, tipo formInput.

A caixa de De nome está localizada à esquerda da barra de fórmulas, logo acima da coluna A da planilha.
Pressione ENTER.

Um Controlarar de NamedRange é adicionado à célula A1.Não há nenhuma indicação visível na planilha, mas FormInput aparece na caixa Nome (apenas acima da planilha na Esquerda lado) e na janela Propriedades quando célula A1 está Selecionadoda.

Adicionar um Windows Formulário ao projeto

Criar um Windows Form para solicitar ao usuário para obter informações.

Para adicionar um Windows Formulário

Selecionar o projeto WinFormInput em Gerenciador de Soluções.
No menu Projeto, clique em Adicionar Windows Formulário.
Nomeie o formulário GetInputString.vb ou GetInputString.cse clique em Adicionar.

O novo formulário é aberto no designer.
Adicionar um TextBox e um Button ao formulário.
Selecione o botão, localize a propriedade Texto na janela Properties, e Alterar o texto a ser OK.

Avançar, Adicionar código ThisWorkbook.vb ou ThisWorkbook.cs para coletar informações do usuário.

Exibir Windows Form e coleta de informações

Criar uma instância de GetInputString Windows Form e Exibir e gravar as informações do usuário em uma célula na planilha.

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

Clique com o botão direito do mouse de ThisWorkbook.vb ou ThisWorkbook.cs em Gerenciador de Soluçõese clique em Exibir Code.

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

Observação:
Em C#, você precisa adicionar um manipulador de eventos como mostrado no Evento Startup abaixo.Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos no Visual Studio Tools for 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 grava o texto para um intervalo nomeado.Esse método é chamado do formulário, e a entrada do usuário é passada para o Controlarar de NamedRange , na célula formInputA1 .
```
Public Sub WriteStringToCell(ByVal formData As String)
    Globals.Sheet1.formInput.Value2 = formData
End Sub
```
```
public void WriteStringToCell(string formData)
{
    Globals.Sheet1.formInput.Value2 = formData;
}
```

Avançar, Adicionar evento de clique de código para o formulário para tratar do botão.

Enviando informações para a planilha

Para enviar informações para a planilha

Clique com o botão direito GetInputString em Gerenciador de Soluçõese clique em Exibir Designer.
Clique Duplo o botão para abrir o arquivo de código com manipulador de eventos do botão de Click adicionado.
Adicionar código ao manipulador de eventos para levar a entrada de caixa de texto, enviá-lo para a função WriteStringToCell e, em seguida, 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 Windows Formulário for exibida, e a entrada aparece na planilha.

Para testar a sua pasta de trabalho

Pressionarionar F5 para executar seu projeto.
Confirmar que o Windows Formulário aparece.
Digite Hello World na Caixa de Texto e clique em OK.
Confirme se Hello World aparece na célula A1 da planilha.

Próximas etapas

Esta explicação passo a passo mostra as noções básicas de mostrar um Windows Formulário e passando dados para uma planilha.Outro tarefas que você pode deseja executar Incluir:

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