Partilhar via


Demonstra Passo a passo: Exibir texto em uma caixa de texto em uma planilha usando um botão

Este passo a passo mostra as noções básicas do uso de botões e caixas de texto em planilhas do Microsoft Office Excel e como criar projetos do Excel usando ferramentas de desenvolvimento do Office no Visual Studio. Para ver o resultado como um exemplo concluído, consulte o Exemplo de controles do Excel em Exemplos de desenvolvimento e instruções passo a passo do Office.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Durante este passo a passo, você aprenderá a:

  • Adicionar controles a uma planilha.

  • Preencher uma caixa de texto quando um botão é clicado.

  • Teste seu projeto.

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.

Pré-requisitos

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

Criar o projeto

Nesta etapa, você criará um projeto de pasta de trabalho do Excel usando o Visual Studio.

Criar um novo projeto

  1. Crie um projeto de pasta de trabalho do Excel com o nome Meu botão do Excel. Verifique se a opção Criar um novo documento está selecionada. 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 Meu Botão do Excel ao Gerenciador de Soluções.

Adicionar controles à planilha

Para este passo a passo, você precisará de um botão e uma caixa de texto na primeira planilha.

Para adicionar um botão e uma caixa de texto

  1. Verifique se a pasta de trabalho My Excel Button.xlsx está aberta no designer do Visual Studio, com Sheet1 exibido.

  2. Na guia Controles Comuns da Caixa de Ferramentas, arraste a TextBox para Sheet1.

  3. No menu Exibir , selecione Janela Propriedades.

  4. Certifique-se de que TextBox1 está visível na caixa suspensa da janela Propriedades e altere a propriedade Name da caixa de texto para displayText.

  5. Arraste um controle Button para Sheet1 e altere as seguintes propriedades:

    Propriedade Valor
    Nome insertText
    Texto Inserir texto

    Agora escreva o código para ser executado quando o botão for clicado.

Preencher a caixa de texto quando o botão for clicado

Cada vez que o usuário clica no botão, Hello World! é anexado à caixa de texto.

Para gravar na caixa de texto quando o botão é clicado

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em Sheet1 e clique em Exibir Código no menu de atalho.

  2. Adicione o seguinte código ao Click manipulador de eventos do botão:

    private void insertText_Click(object sender, EventArgs e)
    {
        this.displayText.Text += "Hello World! ";
    }
    
  3. No C#, você deve adicionar um manipulador de eventos ao Startup evento, conforme mostrado abaixo. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.

    this.insertText.Click += new EventHandler(insertText_Click);
    

Testar o aplicativo

Agora você pode testar sua pasta de trabalho para garantir que a mensagem Hello World! apareça na caixa de texto quando você clicar no botão.

Para testar sua pasta de trabalho

  1. Pressione F5 para executar o projeto.

  2. Clique no botão .

  3. Confirme se Hello World! aparece na caixa de texto.

Próximas etapas

Este passo a passo mostra as noções básicas do uso de botões e caixas de texto em planilhas do Excel. Estas são algumas tarefas que podem vir a seguir:

  • Implantando o projeto. Para obter mais informações, consulte Implantar uma solução do Office.

  • Usando caixas de seleção para alterar a formatação.