Partilhar via

Demonstra Passo a passo: Alterar a formatação do documento usando controles CheckBox

  • Artigo

Este passo a passo demonstra como usar controles do Windows Forms em uma personalização em nível de documento para o Microsoft Office Word para alterar a formatação de texto.

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:

  • Adicionar texto e um controle ao documento em um projeto de nível de documento em tempo de design.

  • Formatar o texto quando uma opção é selecionada.

    Para ver o resultado como um exemplo concluído, consulte o Exemplo de controles do Word em Exemplos de desenvolvimento e instruções passo a passo do Office.

    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.

Crie um novo projeto

  1. Crie um projeto de documento do Word com o nome Minha formataçã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 Formatting ao Gerenciador de Soluções.

Adicionar texto e controles ao documento do Word

Para esta explicação passo a passo, adicione três caixas de seleção e algum texto em um Bookmark controle para o documento do Word. As caixas de seleção apresentarão opções ao usuário para formatar o texto.

Adicionar três caixas de seleção

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

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

  3. Na janela Propriedades, altere as seguintes propriedades.

    Propriedade Valor
    Nome applyBoldFont
    Texto Negrito

  4. Pressione Enter para mover o ponto de inserção abaixo da primeira caixa de seleção.

  5. Adicione uma segunda caixa de seleção ao documento abaixo da caixa de ApplyBoldFont seleção e altere as propriedades a seguir.

    Propriedade Valor
    Nome applyItalicFont
    Texto Itálico

  6. Pressione Enter para mover o ponto de inserção abaixo da segunda caixa de seleção.

  7. Adicione uma terceira caixa de seleção ao documento abaixo da caixa de ApplyItalicFont seleção e altere as propriedades a seguir.

    Propriedade Valor
    Nome applyUnderlineFont
    Texto Sublinhado

Adicionar texto e um controle Bookmark

  1. Mova o ponto de inserção abaixo dos controles da caixa de seleção e digite o seguinte texto:

    Clique em uma caixa de seleção para alterar a formatação deste texto.

  2. Na guia Controles do Word da Caixa de Ferramentas, arraste um Bookmark controle para o documento.

    A caixa de diálogo Adicionar controle de indicador é exibida.

  3. Selecione o texto adicionado ao documento e clique em OK.

    Um Bookmark controle chamado Bookmark1 é adicionado ao texto selecionado no documento.

  4. Na janela Propriedades, altere o valor da propriedade (Name) para fontText.

    Em seguida, escreva o código para formatar o texto quando uma caixa de seleção estiver marcada ou desmarcada.

Formatar o texto quando uma caixa de seleção estiver marcada ou desmarcada

Quando o usuário seleciona uma opção de formatação, altere o formato do texto no documento.

Alterar a formatação quando uma caixa de seleção é marcada

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

  2. Somente para C#, adicione as seguintes constantes à classe ThisDocument .

    const int WordTrue = -1;
const int WordFalse = 0;

  3. Adicione o seguinte código ao Click manipulador de eventos da caixa de applyBoldFont seleção.

    private void applyBoldFont_Click(object sender, System.EventArgs e)
{
    if (this.applyBoldFont.Checked == true)
    {
        this.fontText.Bold = WordTrue;
    }
    else
    {
        this.fontText.Bold = WordFalse;
    }
}

  4. Adicione o seguinte código ao Click manipulador de eventos da caixa de applyItalicFont seleção.

    private void applyItalicFont_Click(object sender, System.EventArgs e)
{
    if (this.applyItalicFont.Checked == true)
    {
        this.fontText.Italic = WordTrue;
    }
    else
    {
        this.fontText.Italic = WordFalse;
    }
}

  5. Adicione o seguinte código ao Click manipulador de eventos da caixa de applyUnderlineFont seleção.

    private void applyUnderlineFont_Click(object sender, System.EventArgs e)
{
    if (this.applyUnderlineFont.Checked == true)
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle;
    }
    else
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineNone;
    }
}

  6. No C#, você deve adicionar manipuladores de eventos para as caixas de texto ao Startup evento. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.

    this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);

Testar o aplicativo

Agora você pode testar seu documento para verificar se o texto está formatado corretamente quando você marca ou desmarca uma caixa de seleção.

Testar seu documento

  1. Pressione F5 para executar o projeto.

  2. Marque ou desmarque uma caixa de seleção.

  3. Confirme se o texto está formatado corretamente.

Próximas etapas

Este passo a passo mostra as noções básicas de como usar caixas de seleção e alterar programaticamente a formatação de texto em documentos do Word. Estas são algumas tarefas que podem vir a seguir:

Conteúdo relacionado