Procedura dettagliata: Chiamare il codice da VBA in un progetto Visual Basic

  • Articolo

Questa procedura dettagliata illustra 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 contenute in questo argomento si applicano ai progetti a livello di documento per Excel e Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

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

In questa procedura dettagliata sono illustrati i task seguenti:

  • Creazione di un documento contenente codice VBA.

  • Concessione dell'attendibilità al percorso del documento con 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

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 di Visual Studio.

Prerequisiti

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

Creare 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 può modificare il progetto VBA per consentire al codice VBA di eseguire chiamate nell'assembly di personalizzazione.

Per usare un documento contenente codice VBA già esistente, è possibile ignorare questo passaggio.

Per creare un documento contenente codice VBA

  1. Avviare Word.

  2. Salvare il documento attivo come documento abilitato per macro di Word (*.docm) con il nome DocumentWithVBA. Salvarla in un percorso a propria scelta, ad esempio, il desktop.

  3. Sulla barra multifunzione fare clic sulla scheda Sviluppatore .

    Nota

    Se la scheda Sviluppatore non viene mostrata, è necessario abilitarne la visualizzazione. Per altre informazioni, vedere Procedura: Visualizzare la scheda sviluppatore sulla barra multifunzione.

  4. Nel gruppo Codice , selezionare Visual Basic.

    Viene aperto Microsoft Visual Basic Editor.

  5. Nella finestra, Progetto , fare doppio clic su ThisDocument.

    Viene aperto il file di codice relativo all'oggetto ThisDocument .

  6. Aggiungere il codice VBA seguente al file di codice. 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

  7. Salvare il documento e uscire da Word.

Creare il progetto

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

Per creare un nuovo progetto

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu Filee quindi fare clic su Progetto. Se l'IDE è configurato per usare le impostazioni di sviluppo di Visual Basic, scegliere Nuovo progetto dal menu File.

  3. Nel riquadro Modelli espandere, Visual Basicquindi espandere Office/SharePoint.

  4. Selezionare il nodo Componenti aggiuntivi di Office .

  5. Nell'elenco di modelli di progetto, selezionare il progetto Documento Word 2010 o Documento di Word 2013 .

  6. Nella casella Nome digitare CallingCodeFromVBA.

  7. Fare clic su OK.

    Viene visualizzata la Creazione guidata progetto Visual Studio Tools per Office .

  8. Selezionare Copia un documento esistentee, nella casella Percorso completo del documento esistente , specificare il percorso del documento DocumentWithVBA creato in precedenza. Se si ha già un documento con attivazione macro che si vuole usare, specificare invece il percorso di questo documento.

  9. Fare clic su Fine.

    Visual Studio apre il documento DocumentWithVBA nella finestra di progettazione e aggiunge il progetto CallingCodeFromVBA a Esplora soluzioni.

Considerare attendibile il 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. È possibile eseguire questa operazione in diversi modi. Questa procedura dettagliata prevede la concessione dell'attendibilità al percorso del documento con il Centro protezione di Word.

Per concedere l'attendibilità al percorso del documento

  1. Avviare Word.

  2. Scegliere la scheda File .

  3. Fare clic sul pulsante Opzioni Word .

  4. Nel riquadro delle categorie fare clic su Centro protezione.

  5. Nel riquadro dei dettagli fare clic su Impostazioni Centro protezione.

  6. Nel riquadro delle categorie fare clic su Percorsi attendibili.

  7. Nel riquadro dei dettagli fare clic su Aggiungi nuovo percorso.

  8. Nella finestra di dialogo Percorso attendibile di Microsoft Office passare alla cartella contenente il progetto CallingCodeFromVBA .

  9. Selezionare Considera attendibili anche le sottocartelle di questo percorso.

  10. Nella finestra di dialogo Percorso attendibile di Microsoft Office fare clic su OK.

  11. Scegliere OK nella finestra di dialogo Centro protezione.

  12. Scegliere OK nella finestra di dialogo Opzioni Word.

  13. Uscire da Word.

Aggiungere 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

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

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

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

  3. Compilare il progetto.

Esporre il 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

  1. In Esplora soluzionifare doppio clic su ThisDocument.vb.

    Il file DocumentWithVBA verrà aperto nella finestra di progettazione.

  2. Nella finestra Proprietà , selezionare la proprietà EnableVbaCallers e modificarne il valore impostandola su True.

  3. Fare clic su OK nel messaggio visualizzato.

  4. Compilare il progetto.

Chiamare il 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 vuole salvare il codice VBA è possibile copiarlo nel documento contenuto nella cartella del progetto. Per altre informazioni, vedere Combinare personalizzazioni a livello di documento e VBA.

Per chiamare il metodo dal codice VBA

  1. Premere F5 per eseguire il progetto.

  2. Nella scheda Sviluppatore fare clic su Visual Basic nel gruppo Codice.

    Viene aperto Microsoft Visual Basic Editor.

  3. Scegliere Modulo dal menu Inserisci.

  4. Aggiungere al nuovo modulo il codice seguente.

    Questo codice chiama il metodo CreateTable nell'assembly di personalizzazione. Per accedere a tale metodo, la macro usa 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

  5. Premere F5.

  6. Verificare che nel documento sia stata aggiunta una nuova tabella.

  7. Uscire da Word senza salvare le modifiche.

Passaggi successivi

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

Contenuto correlato