Compartilhar via

Passo a passo: coletar dados usando um Formulário do Windows

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

Aplica-se a: As informações neste tópico se aplicam a projetos no nível do documento e projetos de suplemento VSTO. Consulte os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

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

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

Observação

Seu computador pode mostrar diferentes nomes ou locais 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, confira Personalizar o IDE do Visual Studio.

Criar um novo projeto

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

Para criar um novo projeto

  1. 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 no Visual Studio.

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

Adicionar um controle NamedRange à planilha

Para adicionar um intervalo nomeado à Planilha1

  1. Selecione a célula A1 em Sheet1.

  2. Na caixa Nome , digite formInput.

    A caixa Nome está localizada à esquerda da barra de fórmulas, logo acima da coluna A da planilha.

  3. Pressione Enter.

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

Adicionar um Formulário do Windows ao projeto

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

Para adicionar um Formulário do Windows

  1. Selecione o projeto WinFormInput no Gerenciador de Soluções.

  2. No menu Projeto , clique em Adicionar Formulário do Windows.

  3. Nomeie o formulário GetInputString.vb ou GetInputString.cs e clique em Adicionar.

    O novo formulário é aberto no designer.

  4. Adicione um TextBox e um Button ao formulário.

  5. Selecione o botão, localize a propriedade Texto na janela Propriedades e altere o texto para OK.

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

Exibir o Formulário do Windows e coletar informações

Crie uma instância do GetInputString Windows Form, exiba-a e depois escreva as informações do usuário em uma célula na planilha.

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

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

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

    Observação

    No C#, você deve adicionar um manipulador de eventos, conforme mostrado no Startup evento abaixo. Para obter informações sobre como criar manipuladores de eventos, consulte Como criar manipuladores de eventos em projetos do Office.

    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.ShowDialog();
}

  3. Crie um método chamado WriteStringToCell que grava texto em um intervalo nomeado. Esse método é chamado do formulário e a entrada do usuário é passada para o NamedRange controle, formInputna célula A1.

    public void WriteStringToCell(string formData)
{
    Globals.Sheet1.formInput.Value2 = formData;
}

    Em seguida, adicione 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

  1. Clique com o botão direito do mouse em GetInputString no Gerenciador de Soluções e clique em Exibir Designer.

  2. Clique duas vezes no botão para abrir o arquivo de código com o manipulador de eventos do Click botão adicionado.

  3. Adicione código ao manipulador de eventos para tirar a entrada da caixa de texto, enviá-la para a função WriteStringToCelle, em seguida, fechar o formulário.

    Globals.ThisWorkbook.WriteStringToCell(this.textBox1.Text);
this.Dispose();

Test

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

Para testar sua pasta de trabalho

  1. Pressione F5 para executar o projeto.

  2. Confirme se o Formulário do Windows é exibido.

  3. Digite Hello World na caixa de texto e clique em OK.

  4. Confirme se Hello World aparece na célula A1 da planilha.

Próximas etapas

Este passo a passo mostra os conceitos básicos de mostrar um Formulário do Windows e passar dados para uma planilha. Outras tarefas que talvez você queira executar incluem:

Conteúdo relacionado

  • Last updated on