Partilhar via


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

Este passo a passo demonstra como usar botões e caixas de texto em uma personalização no nível de documento para o Microsoft Office Word.

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

Este passo a passo ilustra as seguintes tarefas:

  • Adicionar controlos ao documento do Word num projeto a nível de documento no momento de design.

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

    Observação

    Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você tem e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizar o IDE.

Pré-requisitos

Você precisa dos seguintes componentes para concluir este passo a passo:

Criar o projeto

A primeira etapa é criar um projeto de documento do Word.

Para criar um novo projeto

  1. Crie um projeto de documento do Word com o nome My Word Button. No assistente, selecione Criar um novo documento.

    Para obter mais informações, consulte Como criar projetos do Office no Visual Studio.

    O Visual Studio abre o novo documento do Word no designer e adiciona o projeto My Word Button ao Gerenciador de Soluções.

Adicionar controles ao documento do Word

Os controles de interface do usuário consistem em um botão e uma caixa de texto no documento do Word.

Para adicionar um botão e uma caixa de texto

  1. Verifique se o documento está aberto no designer do Visual Studio.

  2. Na guia Controles Comuns da Caixa de Ferramentas, arraste um TextBox controle para o documento.

    Observação

    No Word, os controles são descartados em linha com o texto por padrão. Você pode modificar a maneira como os controles e objetos de forma são inseridos alterando o padrão na guia Editar da caixa de diálogo Opções no Word.

  3. No menu Exibir , selecione Janela Propriedades.

  4. Localize TextBox1 na caixa suspensa Propriedades da janela e altere a propriedade Name da caixa de texto para displayText.

  5. Arraste um controle Button para o documento e altere as seguintes propriedades.

    Propriedade Valor
    Nome inserirTexto
    Texto Inserir texto

    Agora você pode escrever o código que será executado quando o botão for clicado.

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

Toda vez que o usuário seleciona o botão, Hello World! é adicionado à 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 ThisDocument e selecione 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. Em C#, você deve adicionar um manipulador de eventos para o botão ao Startup evento. 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 a aplicação

Agora você pode testar seu documento para se certificar de que a mensagem Hello World! aparece na caixa de texto quando você seleciona o botão.

Para testar o seu documento

  1. Pressione F5 para executar seu projeto.

  2. Selecione o botão.

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

Próximos passos

Este passo a passo mostra as noções básicas do uso de botões e caixas de texto em documentos do Word. Aqui estão algumas tarefas que podem vir a seguir: