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

Articolo
04/28/2010

Aggiornamento: Luglio 2008

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di applicazione Versione Microsoft Office Word 2007 Word 2003 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di applicazione

Versione Microsoft Office

Word 2007
Word 2003

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

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.

Vengono illustrate le attività seguenti:

Creazione di un progetto componente aggiuntivo di Word per Word 2003 o Word 2007.
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 testarlo.
Pulizia 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 elencati di seguito.

Visual Studio Tools per Office°(componente facoltativo di Visual Studio 2008 Professional e Visual Studio Team System).
Word 2003 o Word 2007.

Per impostazione predefinita, Visual Studio Tools per Office viene installato con le versioni di Visual Studio elencate. Per controllare se è installato nel computer in uso, vedere Installazione di Visual Studio Tools per Office.

Creazione del progetto

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

Avviare Visual Studio.
Scegliere Nuovo dal menu File, quindi scegliere Progetto.
Nel riquadro Tipi progetto espandere Visual C# o Visual Basic e quindi Office.
Se si sviluppa un componente aggiuntivo per Word 2007, selezionare la cartella 2007. Se invece si sviluppa un componente aggiuntivo per Word 2003, selezionare la cartella 2003.
Nel riquadro Modelli, selezionare Componente aggiuntivo di Word 2003 o Componente aggiuntivo di Word 2007.
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:

Una 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 la classe Elementi host di componenti aggiuntivi. 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 liberare le risorse utilizzate dal componente aggiuntivo quando viene scaricato. Per ulteriori informazioni, vedere Eventi di progetti Visual Studio Tools per 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 Visual Basic e programmazione C#.

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:

Il 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 la classe 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 dell'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 la classe Cenni preliminari sul processo di generazione 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, nel menu Compila, fare clic su Pulisci soluzione.

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: Distribuzione di componenti aggiuntivi a livello di applicazione per 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.

Vedere anche

Cronologia delle modifiche

Data	Cronologia	Motivo
Luglio 2008	Argomento aggiunto.	Miglioramento delle informazioni.

Luglio 2008

Argomento aggiunto.

Miglioramento delle informazioni.

Condividi tramite