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

Este manual demonstra como usar controlos Windows Forms numa personalização ao nível do documento para o Microsoft Office Word, a fim de alterar a formatação do 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 do Office e tipo de projeto.

Este passo a passo ilustra as seguintes tarefas:

• Adicionar texto e um controlo ao documento num projeto de nível de documento na fase 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 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:

• Uma edição do Visual Studio que inclui as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte Configurar um computador para desenvolver soluções do Office.

• Word 2013 ou Word 2010 .

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 My Word Formatting. 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 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 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 seguintes propriedades.

   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 seguintes propriedades.

   Propriedade	Valor
   Nome	applyUnderlineFont
   Texto	Sublinhar

Adicionar texto e um controle Bookmark

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

   Clique numa caixa de verificaçã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 é 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 rato ThisDocument no Solution Explorer e, em seguida, clique em View Code 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 applyBoldFont caixa de seleção.

   C#

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

   VB

   Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyBoldFont.Click
   
       Me.fontText.Bold = Me.applyBoldFont.Checked
   End Sub
   

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

   C#

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

   VB

   Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyItalicFont.Click
   
       Me.fontText.Italic = Me.applyItalicFont.Checked
   End Sub
   

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

   C#

   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;
       }
   }
   

   VB

   Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyUnderlineFont.Click
   
       If Me.applyUnderlineFont.Checked Then
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle
       Else
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone
       End If
   End Sub
   

6. Em C#, você deve adicionar manipuladores de eventos das caixas de texto ao evento Startup. 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 a aplicação

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

Teste o seu documento

1. Pressione F5 para executar seu projeto.

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

3. Confirme se o texto está formatado corretamente.

Próximos passos

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

• Use um botão para preencher uma caixa de texto. Para obter mais informações, consulte Passo a passo: exibir texto em uma caixa de texto em um documento usando um botão.

• Usando botões de opção para selecionar estilos de gráfico.

Conteúdo relacionado

• Passo a passo usando o Word
• Exemplos e passo a passo de desenvolvimento do Office
• Controle de Intervalo Nomeado (NamedRange)
• Limitações dos controles do Windows Forms em documentos do Office