Procedura dettagliata: creazione di una personalizzazione a livello di documento per Word

Articolo
08/11/2011

Questa procedura dettagliata introduttiva mostra come creare una personalizzazione a livello di documento per Microsoft Office Word. Le funzionalità che si creano in questo tipo di soluzione sono disponibili solo quando si apre un documento specifico. Una personalizzazione a livello di documento non può essere utilizzata per apportare modifiche a un'intera applicazione, ad esempio per visualizzare una nuova scheda della barra multifunzione quando si apre un documento qualsiasi.

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à:

Creazione di un progetto relativo al documento di Word
Aggiunta di testo al documento ospitato nella finestra di progettazione di Visual Studio.
Scrittura di codice che utilizza il modello a oggetti di Word per aggiungere testo al documento personalizzato quando quest'ultimo viene aperto.
Compilazione ed esecuzione del progetto per testarlo.
Pulizia del progetto per rimuovere dal computer di sviluppo le impostazioni di sicurezza e i file di compilazione non necessari.

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 Documento 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 Documento di Word 2007 o Documento di Word 2010.
Nella casella Nome, digitare FirstDocumentCustomization.
Scegliere OK.

Verrà avviata la Creazione guidata progetto Visual Studio Tools per Office.
Selezionare Crea un nuovo documento e fare clic su OK.

Visual Studio crea il progetto FirstDocumentCustomization e quindi vi aggiunge il documento FirstDocumentCustomization e il file di codice ThisDocument. Il documento FirstDocumentCustomization viene aperto automaticamente nella finestra di progettazione.

Chiusura e riapertura del documento nella finestra di progettazione

Se mentre si sviluppa il progetto nella finestra di progettazione si chiude intenzionalmente o accidentalmente il documento, è possibile riaprirlo.

Per chiudere e riaprire il documento nella finestra di progettazione

Chiudere il documento facendo clic sul pulsante Chiudi (X) della finestra di progettazione.
In Esplora soluzioni, fare clic con il pulsante destro del mouse sul file di codice ThisDocument, quindi scegliere Visualizza finestra di progettazione.

-oppure-

In Esplora soluzioni, fare doppio clic sul file di codice ThisDocument.

Aggiunta di testo al documento nella finestra di progettazione

È possibile progettare l'interfaccia utente della personalizzazione modificando il documento che viene aperto nella finestra di progettazione. Ad esempio, è possibile aggiungere testo, tabelle o controlli Word. Per ulteriori informazioni sull'utilizzo della finestra di progettazione, vedere Progetti di Office in ambiente Visual Studio.

Per aggiungere testo al documento mediante la finestra di progettazione

Nel documento aperto nella finestra di progettazione, digitare il testo seguente.

Questo testo è stato aggiunto tramite la finestra di progettazione.

Aggiunta di testo al documento a livello di codice

Quindi, aggiungere codice al file di codice ThisDocument. Il nuovo codice utilizza il modello a oggetti di Word per aggiungere nel documento un secondo paragrafo di testo. Per impostazione predefinita, il file di codice ThisDocument contiene il codice generato seguente:

Una definizione parziale della classe ThisDocument, che rappresenta il modello di programmazione del documento e consente di accedere al modello a oggetti di Word. Per ulteriori informazioni, vedere°Elemento host documento e Cenni preliminari sul modello a oggetti di Word. Il resto della classe ThisDocument è definito in un file di codice nascosto da non modificare.
I gestori eventi ThisDocument_Startup e ThisDocument_Shutdown. Questi gestori eventi vengono chiamati quando il documento viene aperto o chiuso. Possono essere utilizzati per inizializzare la personalizzazione quando il documento viene aperto e per liberare le risorse utilizzate dalla personalizzazione quando il documento viene chiuso. Per ulteriori informazioni, vedere Eventi nei progetti di Office.

Per aggiungere nel documento un secondo paragrafo di testo mediante codice

In Esplora soluzioni, fare clic con il pulsante destro del mouse su ThisDocument e quindi scegliere Visualizza codice.

Il file di codice si aprirà in Visual Studio.
Sostituire il gestore eventi ThisDocument_Startup con il codice riportato di seguito. Quando il documento viene aperto, questo codice aggiunge un secondo paragrafo di testo al documento.
```
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub
```
```
private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}
```
Nota

Questo codice utilizza il valore di indice 1 per accedere al primo paragrafo contenuto nella proprietà 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.

Verifica del progetto

Per eseguire il test del documento

Premere F5 per compilare ed eseguire il progetto.

Quando si compila il progetto, il codice viene compilato in un assembly associato al documento. Visual Studio inserisce una copia del documento e l'assembly nella cartella dell'output di compilazione del progetto e configura le impostazioni di sicurezza nel computer di sviluppo in modo da consentire l'esecuzione della personalizzazione. Per ulteriori informazioni, vedere Cenni preliminari sul processo di compilazione delle soluzioni Office.
Nel documento, verificare che sia visualizzato il testo seguente.

Questo testo è stato aggiunto tramite la finestra di progettazione.

Questo testo è stato aggiunto tramite codice.
Chiudere il documento.

Pulizia del progetto

Al termine dello sviluppo di un progetto è necessario rimuovere le impostazioni di sicurezza e i file contenuti nella cartella dell'output di compilazione creati dal processo di compilazione.

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 questa personalizzazione di base a livello di documento per Word, per approfondire le proprie conoscenze sullo sviluppo di personalizzazioni è possibile consultare gli argomenti seguenti:

Attività di programmazione generale eseguibili nelle personalizzazioni a livello di documento: Programmazione delle personalizzazioni a livello di documento.
Attività di programmazione specifiche per le personalizzazioni a livello di documento per 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 azioni personalizzato: Personalizzazione dell'interfaccia utente di Office.
Utilizzo di oggetti di Word estesi forniti in Visual Studio Tools per Office per eseguire attività che risultano impossibili tramite il modello a oggetti di Word (ad esempio, l'hosting di controlli gestiti nei documenti e l'associazione di controlli Word ai dati tramite il modello di associazione dati di Windows Form): Automazione di Word utilizzando oggetti estesi.
Compilazione e debug di personalizzazioni a livello di documento per Word: Compilazione e debug delle soluzioni Office.
Distribuzione di personalizzazioni a livello di documento per Word: Distribuzione di soluzioni Office.