Procedura dettagliata: creazione di un componente aggiuntivo a livello di applicazione per Word

Articolo
08/11/2011

Questa procedura dettagliata introduttiva illustra come creare un componente aggiuntivo a livello di applicazione per Microsoft Office Word. Le funzionalità create in questo tipo di soluzione sono disponibili per l'applicazione, indipendentemente da quali documenti vengano aperti.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione 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à:

Creazione di un progetto relativo al componente aggiuntivo per Word.
Scrittura di codice che utilizza il modello a oggetti di Word per aggiungere testo a un documento quando quest'ultimo viene salvato.
Compilazione ed esecuzione del progetto per eseguirne il test.
Pulitura del progetto completato in modo che il componente aggiuntivo non venga più eseguito automaticamente nel computer di sviluppo.

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

Per creare un nuovo progetto per un componente aggiuntivo di Word in Visual Studio

Avviare Visual Studio.
Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nel riquadro Modelli espandere Visual C# o Visual Basic, quindi espandere Office.
In corrispondenza del nodo Office espanso, selezionare 2007 se è installato Word 2007 o selezionare il nodo 2010 se è installato Word 2010.
Nell'elenco di modelli di progetto selezionare Componente aggiuntivo per Word 2007 o Componente aggiuntivo per Word 2010.
Nella casella Nome digitare FirstWordAddIn.
Scegliere OK.

Visual Studio crea il progetto FirstWordAddIn e apre il file di codice ThisAddIn nell'editor.

Scrittura di codice per aggiungere testo nel documento salvato

Quindi, aggiungere codice al file di codice ThisAddIn. Il nuovo codice utilizza il modello a oggetti di Word per aggiungere un boilerplate in ogni documento salvato. Per impostazione predefinita, il file di codice ThisAddIn contiene il codice generato seguente:

Definizione parziale della classe ThisAddIn. Questa classe fornisce un punto di ingresso per il codice e consente di accedere al modello a oggetti di Word. Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione. Il resto della classe ThisAddIn è definito in un file di codice nascosto che non deve essere modificato.
Gestori eventi ThisAddIn_Startup e ThisAddIn_Shutdown. Questi gestori eventi vengono chiamati quando il componente aggiuntivo viene caricato e scaricato da Word. Possono essere utilizzati per inizializzare il componente aggiuntivo quando viene caricato e per pulire le risorse utilizzate dal componente aggiuntivo quando viene scaricato. Per ulteriori informazioni, vedere Eventi nei progetti di Office.

Per aggiungere un paragrafo di testo nel documento salvato

Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn. Il nuovo codice definisce un gestore eventi per l'evento DocumentBeforeSave, generato quando un documento viene salvato.

Quando l'utente salva un documento, il gestore eventi aggiunge il nuovo testo all'inizio del documento.
```
Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub
```
```
void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}
```
Nota

Questo codice utilizza il valore di indice 1 per accedere al primo paragrafo dell'insieme Paragraphs. Anche se Visual Basic e Visual C# utilizzano matrici in base 0, il limite inferiore di matrice della maggior parte degli insiemi del modello a oggetti di Word è 1. Per ulteriori informazioni, vedere Confronto tra programmazione con Visual Basic e con Visual C# nelle soluzioni Office.
Se si utilizza C#, aggiungere il codice necessario seguente nel gestore eventi ThisAddIn_Startup. Questo codice viene utilizzato per connettere il gestore eventi Application_DocumentBeforeSave all'evento DocumentBeforeSave.
```
this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
```

Per modificare il documento quando viene salvato, gli esempi di codice precedenti utilizzano gli oggetti seguenti:

Campo Application della classe ThisAddIn. Il campo Application restituisce un oggetto Microsoft.Office.Interop.Word.Application che rappresenta l'istanza corrente di Word.
Il parametro Doc del gestore eventi dell'evento DocumentBeforeSave. Il parametro Doc è un oggetto Microsoft.Office.Interop.Word.Document che rappresenta il documento salvato. Per ulteriori informazioni, vedere Cenni preliminari sul modello a oggetti di Word.

Verifica del progetto

Per verificare il progetto

Premere F5 per compilare ed eseguire il progetto.

Quando si compila il progetto, il codice viene compilato in un assembly che viene incluso nella cartella di output di compilazione del progetto. Visual Studio crea inoltre un insieme di voci del Registro di sistema che consentono a Word di individuare e caricare il componente aggiuntivo e configura le impostazioni di sicurezza nel computer di sviluppo in modo da consentire l'esecuzione del componente aggiuntivo. Per ulteriori informazioni, vedere Cenni preliminari sul processo di compilazione delle soluzioni Office.
In Word, salvare il documento attivo.
Verificare che il testo seguente sia stato aggiunto nel documento.

Questo testo è stato aggiunto tramite codice.
Chiudere Word.

Pulizia del progetto

Quando si completa lo sviluppo di un progetto, rimuovere dal computer di sviluppo l'assembly del componente aggiuntivo, le voci del Registro di sistema e le impostazioni di sicurezza. In caso contrario, il componente aggiuntivo continuerà a essere eseguito ogni volta che si apre Word nel computer di sviluppo.

Per pulire il progetto completato contenuto nel computer di sviluppo

In Visual Studio, scegliere Pulisci soluzione nel menu Compila.

Passaggi successivi

Dopo aver creato questo componente aggiuntivo di base a livello di applicazione per Word, per approfondire le proprie conoscenze sullo sviluppo di componenti aggiuntivi è possibile consultare gli argomenti seguenti:

Attività di programmazione generale eseguibili nei componenti aggiuntivi: Programmazione di componenti aggiuntivi a livello di applicazione.
Attività di programmazione specifiche per i componenti aggiuntivi di Word: Soluzioni Word.
Utilizzo del modello a oggetti di Word: Cenni preliminari sul modello a oggetti di Word.
Personalizzazione dell'interfaccia utente di Word, ad esempio tramite l'aggiunta di una scheda personalizzata alla barra multifunzione o la creazione di un riquadro attività personalizzato: Personalizzazione dell'interfaccia utente di Office.
Compilazione e debug di componenti aggiuntivi a livello di applicazione per Word: Compilazione e debug delle soluzioni Office.
Distribuzione di componenti aggiuntivi a livello di applicazione per Word: Distribuzione di soluzioni Office.