Compartilhar via

Demonstra Passo a passo: Coletar dados usando um formulário do Windows

  • Artigo

Este passo a passo demonstra como abrir um Windows Form de uma personalização em nível de documento para o Microsoft Office Excel, coletar 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 de nível de documento e projetos de suplemento VSTO. Consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Embora este passo a passo use um projeto de nível de documento para Excel especificamente, 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.

Crie um novo projeto

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

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 à Sheet1

  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 Windows Form ao projeto

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

Para adicionar um Windows Form

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

  2. No menu Project , clique em Adicionar Windows Form .

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

    O novo formulário é aberto no designer.

  4. Adicione a e a TextBoxButton ao formulário.

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

    Em seguida, adicione código ou ThisWorkbook.vbThisWorkbook.cs colete as informações do usuário.

Exibir o Windows Form e coletar informações

Crie uma instância do Windows Form e exiba-a e, em seguida, grave as informações do GetInputString 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 do ThisWorkbook, adicione o código a seguir para declarar uma variável para o formulário e, em seguida, mostre o formulárioGetInputString.

    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 a partir 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 click 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 Click eventos do botão adicionado.

  3. Adicione código ao manipulador de eventos para obter a entrada da caixa de texto, envie-a para a função WriteStringToCelle feche o formulário.

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

Teste

Agora você pode executar o projeto. O Windows Form é exibido e sua entrada aparece na planilha.

Para testar sua pasta de trabalho

  1. Pressione F5 para executar o projeto.

  2. Confirme se o Windows Form é exibido.

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

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

Próximas etapas

Este passo a passo mostra as noções básicas de mostrar um formulário do Windows e passar dados para uma planilha. Outras tarefas que você pode querer executar incluem:

  • Use controles do Windows Forms em uma pasta de trabalho do Excel ou em um documento do Word. Para obter mais informações, consulte Visão geral sobre controles do Windows Forms em documentos do Office.

  • Modifique a interface do usuário de um aplicativo do Microsoft Office a partir de uma personalização em nível de documento ou de um suplemento VSTO. Para obter mais informações, consulte Personalização da interface do usuário do Office.

Conteúdo relacionado