Procedura dettagliata: modifica della formattazione dei documenti mediante i controlli CheckBox

In questa procedura dettagliata viene illustrato come utilizzare i controlli Windows Form in una personalizzazione a livello di documento per Microsoft Office Word al fine di modificare la formattazione del testo.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

In questa procedura dettagliata vengono illustrate le seguenti attività:

• Aggiunta di testo e di un controllo al documento contenuto in un progetto a livello di documento in fase di progettazione.

• Formattazione del testo alla selezione di un'opzione.

Per visualizzare il risultato come esempio completo, vedere l'esempio relativo ai controlli di Word in Procedure dettagliate ed esempi di sviluppo di applicazioni per Microsoft Office.

Nota

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

-

Una versione di Visual Studio 2010 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.100\).md).

• Word 2007 o Word 2010.

Creazione del progetto

Il primo passaggio consiste nella creazione di un progetto Documento di Word.

Per creare un nuovo progetto

• Creare un progetto documento di Word con il nome My Word Formatting. Nella procedura guidata, scegliere Crea un nuovo documento.

  Per ulteriori informazioni, vedere Procedura: creare progetti di Office in Visual Studio.

  Il nuovo documento di Word viene aperto nella finestra di progettazione di Visual Studio e il progetto My Word Formatting viene aggiunto in Esplora soluzioni.

Aggiunta di testo e controlli al documento di Word

Per questa procedura dettagliata, aggiungere tre caselle di controllo e il testo in un controllo Bookmark al documento di Word. Le caselle di controllo presenteranno opzioni per formattare il testo.

Per aggiungere tre caselle di controllo

1. Verificare che il documento sia aperto nella finestra di progettazione di Visual Studio.

2. Dalla scheda Controlli comuni della Casella degli strumenti, trascinare il primo controllo CheckBox nel documento.

3. Nella finestra Proprietà modificare le proprietà riportate di seguito.

   Proprietà	Valore
   Nome	applyBoldFont
   Text	Grassetto

4. Premere Invio per spostare il punto di inserimento al di sotto della prima casella di controllo.

5. Aggiungere una seconda casella di controllo al documento al di sotto della casella di controllo ApplyBoldFont e modificare le seguenti proprietà.

   Proprietà	Valore
   Nome	applyItalicFont
   Text	Italic

6. Premere Invio per spostare il punto di inserimento al di sotto della seconda casella di controllo.

7. Aggiungere una terza casella di controllo al documento al di sotto della casella di controllo ApplyItalicFont e modificare le seguenti proprietà.

   Proprietà	Valore
   Nome	applyUnderlineFont
   Text	Underline

Per aggiungere il testo e un controllo Bookmark

1. Spostare il punto di inserimento al di sotto dei controlli della casella di controllo e digitare il seguente testo:

   Fare clic su una casella di controllo per modificare la formattazione di questo testo.

2. Dalla scheda Controlli Word della Casella degli strumenti, trascinare un controllo Bookmark nel documento.

   Verrà visualizzata la finestra di dialogo Aggiungi controllo Bookmark.

3. Selezionare il testo aggiunto al documento e scegliere OK.

   Al testo selezionato nel documento viene aggiunto un controllo Bookmark denominato Bookmark1.

4. Nella finestra Proprietà modificare il valore della proprietà (Name) su fontText**.**

Creare il codice per la formattazione del testo quando una casella di controllo viene selezionata o deselezionata.

Formattazione del testo quando una casella di controllo viene selezionata o deselezionata

Quando l'utente seleziona un'opzione di formattazione, modificare il formato del testo nel documento.

Per modificare la formattazione quando una casella di controllo viene selezionata

1. Fare clic con il pulsante destro del mouse su ThisDocument in Esplora soluzioni, quindi scegliere Visualizza codice dal menu di scelta rapida.

2. Solo per C#, aggiungere le seguenti costanti alla classe ThisDocument.

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

3. Aggiungere il codice riportato di seguito al gestore eventi Click della casella di controllo applyBoldFont.

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

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

4. Aggiungere il codice riportato di seguito al gestore eventi Click della casella di controllo applyItalicFont.

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

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

5. Aggiungere il codice riportato di seguito al gestore eventi Click della casella di controllo applyUnderlineFont.

   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
   

   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. In C# è necessario aggiungere gestori eventi per le caselle di testo all'evento Startup. Per ulteriori informazioni sulla creazione di gestori eventi, vedere Procedura: creare gestori eventi in progetti di Office.

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

Verifica dell'applicazione

È ora possibile sottoporre a test il documento per verificare che il testo sia formattato correttamente quando si seleziona o si deseleziona una casella di controllo.

Per verificare il documento

1. Premere F5 per eseguire il progetto.

2. Selezionare o deselezionare una casella di controllo.

3. Verificare che la formattazione del testo sia corretta.

Passaggi successivi

Nella procedura dettagliata vengono fornite le informazioni di base sull'utilizzo delle caselle di controllo e sulla modifica a livello di codice della formattazione nei documenti di Word. Di seguito sono elencate alcune attività che potrebbero essere eseguite successivamente:

• Utilizzare un pulsante per popolare una casella di testo. Per ulteriori informazioni, vedere Procedura dettagliata: visualizzazione di testo in una casella di testo di un documento tramite un pulsante.

• Utilizzo dei pulsanti di opzione per selezionare gli stili del grafico. Per ulteriori informazioni, vedere Procedura dettagliata: aggiornamento di un grafico in un documento mediante pulsanti di opzione.

Vedere anche

Concetti

Procedure dettagliate con Word

Controllo NamedRange

Limitazioni dei controlli Windows Form nei documenti di Office

Altre risorse

Procedure dettagliate ed esempi di sviluppo di applicazioni per Microsoft Office