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

Articolo
02/19/2013

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 2013 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 attività seguenti:

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 2012 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.110\).md).

Word 2013 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

Verificare che il documento sia aperto nella finestra di progettazione di Visual Studio.
Dalla scheda Controlli comuni della Casella degli strumenti, trascinare il primo controllo CheckBox nel documento.
Nella finestra Proprietà modificare le proprietà riportate di seguito.

Proprietà

Valore

Nome

applyBoldFont

Testo

Grassetto
Premere Invio per spostare il punto di inserimento al di sotto della prima casella di controllo.
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

Testo

Italic
Premere Invio per spostare il punto di inserimento al di sotto della seconda casella di controllo.
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

Testo

Underline

Proprietà	Valore
Nome	applyBoldFont
Testo	Grassetto

Proprietà	Valore
Nome	applyItalicFont
Testo	Italic

Proprietà	Valore
Nome	applyUnderlineFont
Testo	Underline

Per aggiungere il testo e un controllo Bookmark

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.
Dalla scheda Controlli Word della Casella degli strumenti, trascinare un controllo Bookmark nel documento.

Verrà visualizzata la finestra di dialogo Aggiungi controllo Bookmark.
Selezionare il testo aggiunto al documento e scegliere OK.

Al testo selezionato nel documento viene aggiunto un controllo Bookmark denominato Bookmark1.
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

Fare clic con il pulsante destro del mouse su ThisDocument in Esplora soluzioni, quindi scegliere Visualizza codice dal menu di scelta rapida.
Solo per C#, aggiungere le seguenti costanti alla classe ThisDocument.
```
const int WordTrue = -1;
const int WordFalse = 0;
```

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

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

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

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 testare il documento

Premere F5 per eseguire il progetto.
Selezionare o deselezionare una casella di controllo.
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 procedure che potrebbero essere necessarie per estendere il progetto: