Procedura dettagliata: Creare la prima personalizzazione a livello di documento per Word

  • Articolo

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 si applicano ai progetti a livello di documento per Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

In questa procedura dettagliata sono illustrati i task 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.

  • Creazione 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.

    Nota

    I nomi o i 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 Personalizzare l'IDE.

Prerequisiti

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

Creare il progetto

Per creare un progetto di documento di Word in Visual Studio

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu Filee quindi fare clic su Progetto.

  3. Nella finestra di dialogo Crea un nuovo progetto selezionare il progetto documento VSTO di Word.

    Nota

    È anche possibile cercare modelli digitando il nome del prodotto Office nella casella di testo Cerca nella parte superiore della finestra di dialogo Crea un nuovo progetto . Ad esempio, digitando Excel verranno visualizzati tutti i modelli di progetto per Excel. È anche possibile filtrare l'elenco dei modelli per visualizzare solo i modelli per Office selezionando Office nella casella a discesa Tipo di progetto. Per altre informazioni, vedere Creare un nuovo progetto in Visual Studio.

  4. Fare clic su Avanti.

  5. Digitare FirstWorkbookCustomization nella casella Nome della finestra di dialogo Configura il nuovo progetto e fare clic su Crea.

  6. Selezionare Crea un nuovo documento nella Strumenti di Visual Studio creazione guidata progetto di Office e fare clic su OK.

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

Chiudere e riaprire il 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) per la finestra di progettazione.

  2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di codice ThisDocument e scegliere Visualizza finestra di progettazione.

    - oppure -

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

Aggiungere 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 altre informazioni su come usare la finestra di progettazione, vedere Progetti di Office nell'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.

    Questo testo è stato aggiunto tramite la finestra di progettazione.

Aggiungere testo al documento a livello di codice

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 Cenni preliminari sull'elemento host del documento e sul 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 e 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.";
}

    Nota

    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 Scrivere codice nelle soluzioni Office.

Testare il progetto

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 Creare soluzioni Office.

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

    Questo testo è stato aggiunto tramite la finestra di progettazione.

    This text was added by using code.

  3. Chiudere il documento.

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

  1. 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 generali che è possibile eseguire nelle personalizzazioni a livello di documento: programmare personalizzazioni a livello di documento.

  • Attività di programmazione specifiche per le personalizzazioni a livello di documento per Word: soluzioni Word.

  • Uso del modello a oggetti di Word: Panoramica del modello a oggetti di Word.

  • Personalizzazione dell'interfaccia utente di Word, ad esempio, aggiungendo una scheda personalizzata alla barra multifunzione o creando un riquadro azioni personalizzato: personalizzazione dell'interfaccia utente di Office.

  • Utilizzo di oggetti Word estesi forniti dalle soluzioni Office in Visual Studio per eseguire attività che non sono possibili usando 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 data binding Windows Form: automatizzare Word usando oggetti estesi.

  • Compilazione e debug di personalizzazioni a livello di documento per Word: Creare soluzioni Office.

  • Distribuzione di personalizzazioni a livello di documento per Word: Distribuire una soluzione Office.

Contenuto correlato