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

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

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu File, quindi fare clic su Progetto.

  3. Nel riquadro Modelli espandere Visual C# o Visual Basic, quindi espandere Office.

  4. In corrispondenza del nodo Office espanso, selezionare 2007 se è installato Word 2007 o selezionare il nodo 2010 se è installato Word 2010.

  5. Nell'elenco di modelli di progetto selezionare Documento di Word 2007 o Documento di Word 2010.

  6. Nella casella Nome, digitare FirstDocumentCustomization.

  7. Scegliere OK.

    Verrà avviata la Creazione guidata progetto Visual Studio Tools per Office.

  8. 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

  1. Chiudere il documento facendo clic sul pulsante Chiudi (X) della finestra di progettazione.

  2. 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

  1. 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.

  2. 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

  1. 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.

  2. Nel documento, verificare che sia visualizzato il testo seguente.

    Questo testo è stato aggiunto tramite la finestra di progettazione.

    Questo testo è stato aggiunto tramite codice.

  3. 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:

Vedere anche

Concetti

Cenni preliminari sullo sviluppo di soluzioni Office

Automazione di Word utilizzando oggetti estesi

Altre risorse

Soluzioni Word

Programmazione delle personalizzazioni a livello di documento

Cenni preliminari sul modello a oggetti di Word

Personalizzazione dell'interfaccia utente di Office

Compilazione e debug delle soluzioni Office

Distribuzione di soluzioni Office

Cenni preliminari sui modelli di progetto di Office