Compartilhar via

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

Este passo a passo demonstra como usar controles do Windows Forms em uma personalização no nível do 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 Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Este passo a passo ilustra as seguintes tarefas:

  • Adicionando texto e um controle ao documento em um projeto no nível do 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 do Office e instruções passo a passo.

    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, consulte 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 do Documento do Word.

Criar um novo projeto

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

Adicionar texto e controles ao documento do Word

Para este passo a passo, adicione três caixas de seleção e algum texto em um Bookmark controle ao 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 propriedades a seguir.

    Propriedade Value
    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 ApplyBoldFont caixa de seleção e altere as propriedades a seguir.

    Propriedade Value
    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 ApplyItalicFont caixa de seleção e altere as propriedades a seguir.

    Propriedade Value
    Nome applyUnderlineFont
    Texto Sublinhar

Adicionar texto e um controle de marcador

  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 Marcador aparece.

  3. Selecione o texto que você adicionou 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 for 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 estiver selecionada

  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 código a seguir ao Click manipulador de eventos da applyBoldFont caixa de 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 código a seguir ao Click manipulador de eventos da applyItalicFont caixa de 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 código a seguir ao Click manipulador de eventos da applyUnderlineFont caixa de 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. Em 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ê seleciona ou desmarca uma caixa de seleção.

Teste 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. Aqui estão algumas tarefas que podem vir a seguir:

Conteúdo relacionado

  • Last updated on