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

Artigo
02/25/2013

Este passo-a-passo mostra os conceitos básicos de usar os botões e caixas de texto em planilhas 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 completo, consulte o exemplo Controles do Excel em Passo a passo e amostras de desenvolvimento do office.

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

Durante este explicação passo a passo, você aprenderá como:

Adicionar controles a uma planilha.
Preencher uma caixa de texto quando um botão é clicado.
Testar seu projeto.

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.

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.

Criando o projeto

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

Para criar um novo projeto

Crie um projeto de pasta de trabalho do Excel com o nome meu botão do excel.Certifique-se de que Criar um Novo Documento está selecionado.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 do Meu botão do excel a Gerenciador de Soluções.

Adicionando controles à planilha

Para essa explicação 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

Verifique se a pasta de trabalho de Meus Button.xlsx Excel está aberto no designer do Visual Studio, com Sheet1 exibida.
Da guia de Controles Comuns da caixa de ferramentas, arraste TextBox a Sheet1.
No menu de Modo de Visualização , Janela de propriedadesselecione.
Certifique-se de que TextBox1 é visível na caixa suspensa da janela de Propriedades e altere a propriedade de Nome da caixa de texto a displayText.
Arraste um controle de Botão em Sheet1 e altere as propriedades a seguir:

Propriedade

Valor

Nome

insertText

Texto

Inserir texto

Propriedade	Valor
Nome	insertText
Texto	Inserir texto

Agora escreva código para executar quando o botão é clicado.

Preenchendo a caixa de texto quando o botão é clicado

Sempre que o usuário clica no botão, Olá Mundo! será acrescentado à caixa de texto.

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

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

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

Private Sub insertText_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles insertText.Click

    Me.displayText.Text += "Hello World! "
End Sub

private void insertText_Click(object sender, EventArgs e)
{
    this.displayText.Text += "Hello World! ";
}

Em C#, você deve adicionar um manipulador de eventos para o evento de Startup como 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);
```

Testando o aplicativo

Agora você pode testar sua pasta de trabalho para certificar-se de que a mensagem Olá Mundo! aparece na caixa de texto quando você clica no botão.

Para testar sua pasta de trabalho

Pressione F5 para executar o seu projeto.
Clique no botão.
Confirme que Olá Mundo! aparece na caixa de texto.

Próximas etapas

Este passo-a-passo mostra os conceitos básicos de usar os botões e caixas de texto em planilhas Excel.Aqui estão algumas tarefas que podem vie em seguida:

Implantando o projeto.Para obter mais informações, consulte Implantando uma solução do Office.
Usando caixas de seleção para alterar a formatação.Para obter mais informações, consulte Passo a passo: Alterando a formatação de planilhas usando controles CheckBox.

Consulte também

Tarefas

Como: adicionar controles do Windows Forms a documentos do Office

Conceitos

Excel usando explicações passo a passo

Limitações dos controles do Windows Forms em documentos do Office

Compartilhar via