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

  • Artigo

Este passo a passo demonstra como usar botões e caixas de texto em uma personalização em 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 e tipo de projeto do Office.

Este passo a passo ilustra as seguintes tarefas:

  • Adicionando controles ao documento do Word em um projeto de nível de documento em tempo de design.

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

    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.

Pré-requisitos

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

Criar o projeto

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

Criar um novo projeto

  1. Crie um projeto de documento do Word com o nome Meu botão do Word. 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 da 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 os 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 de Propriedades.

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

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

    Propriedade Valor
    Nome insertText
    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. No 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 o aplicativo

Agora você pode testar seu documento para garantir que a mensagem Hello World! apareça na caixa de texto quando você selecionar o botão.

Para testar o documento

  1. Pressione F5 para executar o projeto.

  2. Selecione o 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 documentos do Word. Estas são algumas tarefas que podem vir a seguir:

Conteúdo relacionado