Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

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à create in questo tipo di soluzione sono disponibili solo quando si apre un documento specifico.  Una personalizzazione a livello di documento non può essere usata 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 contenute in questo argomento sono valide per i progetti a livello di documento per Word. Per altre informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

In questa procedura dettagliata vengono illustrate le attività seguenti:

  • 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 usa il modello a oggetti di Word per aggiungere testo al documento personalizzato quando quest'ultimo viene aperto.

  • Compilazione ed esecuzione del progetto a scopo di test.

  • Pulizia del progetto per rimuovere dal computer di sviluppo le impostazioni di sicurezza e i file di compilazione non necessari.

System_CAPS_noteNota

Nomi o percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzazione dell'IDE di Visual Studio.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

Per creare un progetto di documento di Word in Visual Studio

  1. Avviare Visual Studio.

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

  3. Nel riquadro dei modelli espandere Visual C# o Visual Basic, quindi espandere Office/SharePoint.

  4. Nel nodo Office/SharePoint espanso selezionare il nodo Componenti aggiuntivi di Office.

  5. Nell'elenco di modelli di progetto selezionare un progetto Documento VSTO di Word.

  6. Nella casella Nome, digitare FirstDocumentCustomization.

  7. Fare clic su OK.

    Viene visualizzata 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.  

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.

È 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 altre informazioni sull'uso della finestra di progettazione, vedere Progetti di Office in ambiente Visual Studio.  

Per aggiungere testo al documento con la finestra di progettazione

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

    This text was added by using the designer.

Quindi, aggiungere codice al file di codice ThisDocument.  Il nuovo codice usa 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 seguente codice generato:  

  • 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 altre informazioni, vedere Elemento host Document e Panoramica del modello a oggetti di Word.  Il resto della classe ThisDocument viene definito in un file di codice nascosto che l'utente non deve modificare.  

  • I gestori eventi ThisDocument_Startup e ThisDocument_Shutdown.  Questi gestori eventi vengono chiamati quando il documento viene aperto o chiuso.  Possono essere usati per inizializzare la personalizzazione quando il documento viene aperto e per liberare le risorse usate dalla personalizzazione quando il documento viene chiuso.  Per altre informazioni, vedere Eventi nei progetti di Office.  

Per aggiungere nel documento un secondo paragrafo di testo usando il codice

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

    Il file di codice verrà aperto in Visual Studio.

  2. Sostituire il gestore eventi ThisDocument_Startup con il codice seguente.  Quando il documento viene aperto, questo codice aggiunge un secondo paragrafo di testo al documento.  

    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.";
    }
    
    System_CAPS_noteNota

    Questo codice usa il valore di indice 1 per accedere al primo paragrafo contenuto nella proprietà Paragraphs.  Anche se Visual Basic e Visual C# usano matrici in base 0, il limite inferiore di matrice della maggior parte delle raccolte del modello a oggetti di Word è 1.  Per altre informazioni, vedere Scrittura di codice nelle soluzioni Office.  

Per testare il 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 altre informazioni, vedere Compilazione di soluzioni Office.  

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

    This text was added by using the designer.

    Il testo è stato aggiunto usando il codice.

  3. Chiudere il documento.

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 nel computer di sviluppo

  1. In Visual Studio scegliere Pulisci soluzione dal menu Compila.

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:

Mostra: