Procedura dettagliata: chiamata di codice da VBA in un progetto Visual Basic

Articolo
08/11/2011

In questa procedura dettagliata viene illustrato come chiamare un metodo in una personalizzazione a livello di documento di Microsoft Office Word da codice Visual Basic, Applications Edition (VBA) contenuto nel documento. La procedura comporta tre passaggi di base: aggiungere un metodo alla classe dell'elemento host ThisDocument, esporre il metodo al codice VBA e quindi chiamare il metodo dal codice VBA contenuto nel documento.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2007, Excel 2010, Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Benché in questa procedura dettagliata venga utilizzato Word in modo specifico, i concetti illustrati sono applicabili anche ai progetti a livello di documento di Excel.

In questa procedura dettagliata vengono illustrate le seguenti attività:

Creazione di un documento contenente codice VBA.
Concessione dell'attendibilità al percorso del documento tramite il Centro protezione di Word.
Aggiunta di un metodo alla classe dell'elemento host ThisDocument.
Esposizione del metodo al codice VBA.
Chiamata del metodo dal codice VBA.

Nota

Il computer potrebbe mostrare nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. Questi elementi sono determinati dall'edizione di Visual Studio in uso e dalle impostazioni utilizzate. Per ulteriori informazioni, vedere Gestione delle impostazioni.

Collegamento a video Per una dimostrazione video correlata, vedere l'articolo relativo alla chiamata di codice VSTO da VBA (la pagina potrebbe essere in inglese).

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 di un documento contenente codice VBA

Il primo passaggio consiste nel creare un documento con attivazione macro contenente una macro VBA semplice. Per poter creare un progetto di Visual Studio basato su un determinato documento è necessario che quest'ultimo contenga un progetto VBA. In caso contrario, Visual Studio non è in grado di modificare il progetto VBA per consentire al codice VBA di eseguire chiamate nell'assembly di personalizzazione.

Se si dispone già di un documento contenente codice VBA che si desidera utilizzare, è possibile ignorare questo passaggio.

Per creare un documento contenente codice VBA

Avviare Word.
Salvare il documento attivo come Documento di Word con attivazione macro (* .docm) con il nome DocumentWithVBA. Salvarlo in un percorso di facile accesso, ad esempio il desktop.
Sulla barra multifunzione, fare clic sulla scheda Sviluppatore.

Nota

Se la scheda Sviluppo non è visibile, è necessario prima visualizzarla. Per ulteriori informazioni, vedere Procedura: visualizzare la scheda Sviluppo nella barra multifunzione.
Nel gruppo Codice, fare clic su Visual Basic.

Verrà aperto Visual Basic Editor.
Nella finestra Progetto, fare doppio clic su ThisDocument.

Viene aperto il file di codice per l'oggetto ThisDocument.
Aggiungere al file di codice il codice VBA seguente. Questo codice definisce una funzione semplice che non esegue alcuna operazione. L'unico scopo di questa funzione è garantire l'esistenza di un progetto VBA nel documento. Tale requisito dovrà essere soddisfatto in alcuni passaggi successivi di questa procedura dettagliata.
```
Sub EmptySub()
End Sub
```
Salvare il documento e uscire da Word.

Creazione del progetto

A questo punto è possibile creare un progetto a livello di documento di Word che utilizza il documento con attivazione macro appena creato.

Per creare un nuovo progetto

Avviare Visual Studio.
Scegliere Nuovo dal menu File e quindi fare clic su Progetto. Se l'IDE è configurato per utilizzare le impostazioni di sviluppo di Visual Basic, scegliere Nuovo progetto dal menu File.
Nel riquadro dei modelli espandere Visual Basic, quindi espandere Office.
Selezionare il nodo 2010 o 2007.
Nell'elenco dei modelli di progetto selezionare il progetto Documento di Word.
Nella casella Nome digitare CallingCodeFromVBA.
Scegliere OK.

Verrà avviata la Creazione guidata progetto Visual Studio Tools per Office.
Selezionare Copia un documento esistente e, nella casella Percorso completo del documento esistente, specificare il percorso del documento DocumentWithVBA creato in precedenza. Se si dispone già di un documento con attivazione macro che si desidera utilizzare, specificare invece il percorso di questo documento.
Scegliere Fine.

In Visual Studio viene aperto il documento DocumentWithVBA nella finestra di progettazione e viene aggiunto il progetto ChiamataCodiceDaVBA a Esplora soluzioni.

Concessione dell'attendibilità al percorso del documento

Per poter esporre il codice contenuto nella soluzione al codice VBA contenuto nel documento è necessario che quest'ultimo sia impostato come attendibile per l'esecuzione. Esistono diversi modi per eseguire tale operazione. Questa procedura dettagliata prevede la concessione dell'attendibilità al percorso del documento tramite il Centro protezione di Word.

Per concedere l'attendibilità al percorso del documento

Avviare Word.
Fare clic sulla scheda File (per Word 2010) o sul pulsante Microsoft Office (per Word 2007).
Fare clic sul pulsante Opzioni Word.
Nel riquadro delle categorie fare clic su Centro protezione.
Nel riquadro dei dettagli fare clic su Impostazioni Centro protezione.
Nel riquadro delle categorie, fare clic su Percorsi attendibili.
Nel riquadro dei dettagli, fare clic su Aggiungi nuovo percorso.
Nella finestra di dialogo Percorso attendibile di Microsoft Office, passare alla cartella contenente il progetto CallingCodeFromVBA.
Selezionare Considera attendibili anche le sottocartelle di questo percorso.
Nella finestra di dialogo Percorso attendibile di Microsoft Office, fare clic su OK.
Scegliere OK nella finestra di dialogo Centro protezione.
Scegliere OK nella finestra di dialogo Opzioni Word.
Uscire da Word.

Aggiunta di un metodo alla classe ThisDocument

Ora che il progetto VBA è configurato, aggiungere un metodo alla classe dell'elemento host ThisDocument che è possibile chiamare dal codice VBA.

Per aggiungere un metodo alla classe ThisDocument

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

Il file ThisDocument.vb verrà aperto nell'editor di codice.

Aggiungere il seguente metodo alla classe ThisDocument. Questo metodo crea una tabella con due righe e due colonne all'inizio del documento. I parametri specificano il testo visualizzato nella prima riga. Più avanti nella procedura dettagliata questo metodo verrà chiamato dal codice VBA contenuto nel documento.

Public Sub CreateTable(ByVal firstColumnHeader As String, _
    ByVal secondColumnHeader As String)

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim table1 As Word.Table = Me.Tables.Add(Me.Paragraphs(1).Range, 2, 2)

    With table1
        .Style = "Table Professional"
        .Cell(1, 1).Range.Text = firstColumnHeader
        .Cell(1, 2).Range.Text = secondColumnHeader
    End With
End Sub

Compilare il progetto.

Esposizione del metodo al codice VBA

Per esporre il metodo CreateTable al codice VBA contenuto nel documento, impostare la proprietà EnableVbaCallers dell'elemento host ThisDocument su True.

Per esporre il metodo al codice VBA

In Esplora soluzioni fare doppio clic su ThisDocument.vb.

Il file DocumentWithVBA verrà aperto nella finestra di progettazione.
Nella finestra Proprietà, selezionare la proprietà EnableVbaCallers e modificarne il valore impostandola su True.
Fare clic su OK nel messaggio visualizzato.
Compilare il progetto.

Chiamata del metodo dal codice VBA

A questo punto è possibile chiamare il metodo CreateTable dal codice VBA contenuto nel documento.

Nota

Questa procedura dettagliata prevede l'aggiunta di codice VBA al documento durante l'esecuzione del debug del progetto. Se si ricompila il progetto, il codice VBA aggiunto a questo documento verrà sovrascritto. Infatti, Visual Studio sostituisce il documento contenuto nella cartella dell'output di compilazione con una copia del documento contenuto nella cartella del progetto principale. Se si desidera salvare il codice VBA è possibile copiarlo nel documento contenuto nella cartella del progetto. Per ulteriori informazioni, vedere Chiamata di codice nelle personalizzazioni a livello di documento da VBA.

Per chiamare il metodo dal codice VBA

Premere F5 per eseguire il progetto.
Nella scheda Sviluppatore, fare clic su Visual Basic nel gruppo Codice.

Verrà aperto Visual Basic Editor.
Scegliere Modulo dal menu Inserisci.
Aggiungere al nuovo modulo il codice seguente.

Questo codice chiama il metodo CreateTable nell'assembly di personalizzazione. Per accedere a tale metodo, la macro utilizza la proprietà CallVSTOAssembly dell'oggetto ThisDocument. Questa proprietà è stata generata automaticamente nel passaggio precedente della procedura dettagliata in cui è stata impostata la proprietà EnableVbaCallers.
```
Sub CreateTable()
    Call ThisDocument.CallVSTOAssembly.CreateTable("Employee Name", "Start Date")
End Sub
```
Premere F5.
Verificare che nel documento sia stata aggiunta una nuova tabella.
Uscire da Word senza salvare le modifiche.

Passaggi successivi

Ulteriori informazioni su come chiamare elementi di codice in soluzioni Office da VBA sono disponibili negli argomenti seguenti:

Chiamata di codice da VBA in una personalizzazione di Visual C#. Questo processo è diverso dal processo utilizzato per Visual Basic. Per ulteriori informazioni, vedere Procedura dettagliata: chiamata di codice da VBA in un progetto Visual C#.
Chiamata di codice da VBA in un componente aggiuntivo a livello di applicazione. Per ulteriori informazioni, vedere Procedura dettagliata: chiamata di codice in un componente aggiuntivo a livello di applicazione da VBA.