Elementi host di componenti aggiuntivi

Aggiornamento: Luglio 2008

La classe Microsoft.Office.Tools.AddIn è l'elemento host per i componenti aggiuntivi a livello di applicazione creati utilizzando Visual Studio Tools per Office. L'elemento host è una classe di una soluzione Visual Studio Tools per Office che fornisce il punto di ingresso per il codice.

Informazioni sulle classe AddIn e ThisAddIn

La classe AddIn fornisce le funzionalità principali condivise da tutti i componenenti aggiuntivi di Visual Studio Tools per Office. Tuttavia, è opportuno evitare di creare in modo esplicito un'istanza della classe nonché utilizzarla direttamente nel codice.

Utilizzare invece la classe ThisAddIn. Visual Studio Tools per Office genera questa classe nel progetto componente aggiuntivo per offrire il collegamento di comunicazione tra l'applicazione di Microsoft Office e il codice del componente aggiuntivo. La classe ThisAddIn deriva da AddIn. Visual Studio Tools per Office crea automaticamente un'istanza di questa classe quando un'applicazione di Microsoft Office carica il componente aggiuntivo.

La classe ThisAddIn fornisce un punto di partenza da cui iniziare a scrivere il codice per il progetto. È anche possibile utilizzare ThisAddIn per eseguire attività come l'accesso al modello a oggetti dell'applicazione host. Per ulteriori informazioni, vedere la classe Programmazione di componenti aggiuntivi a livello di applicazione.

Utilizzo di AddIn e ThisAddIn nei progetti componente aggiuntivo di Outlook 2007

I progetti componente aggiuntivo per Microsoft Office Outlook 2007 utilizzano un elemento host diverso, Microsoft.Office.Tools.Outlook.OutlookAddIn. Questa classe deriva da AddIn e offre funzionalità aggiuntive per supportare le aree di modulo. Per ulteriori informazioni sulle aree di modulo, vedere Creazione di aree di modulo di Outlook.

Nei progetti componente aggiuntivo per Outlook 2007, la classe ThisAddIn deriva da OutlookAddIn. La classe ThisAddIn viene utilizzata nei componenti aggiuntivi Outlook 2007 proprio come si usa nei componenti aggiuntivi per altre applicazioni di Microsoft Office.

Membri da utilizzare per varie attività

Nella tabella seguente sono illustrate le attività più comuni e i membri della classe ThisAddIn utilizzabili per eseguirle.

Task	Membro da utilizzare
Eseguire il codice per inizializzare il componente aggiuntivo quando viene caricato.	Aggiungere codice al metodo ThisAddIn_Startup. È il gestore eventi predefinito per l'evento Startup. Per ulteriori informazioni, vedere la classe Eventi di progetti Visual Studio Tools per Office.
Eseguire il codice per liberare le risorse utilizzate dal componente aggiuntivo prima che questo venga scaricato.	Aggiungere codice al metodo ThisAddIn_Shutdown. È il gestore eventi predefinito per l'evento Shutdown. Per ulteriori informazioni, vedere la classe Eventi di progetti Visual Studio Tools per Office.
Automazione dell'applicazione host mediante accesso al modello a oggetti.	Utilizzare il campo Application della classe ThisAddIn. Viene restituita un'istanza della classe Application dell'applicazione utilizzata dal componente aggiuntivo. Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione.
Creare uno smart tag che possa essere riconosciuto in qualsiasi cartella di lavoro di Excel o documento di Word aperto. Si tratta di una nuova funzionalità di Visual Studio 2008 Service Pack 1 (SP1).	Utilizzare il campo VstoSmartTags della classe ThisAddIn. Questo campo è disponibile solo in progetti componente aggiuntivo per Excel 2007 e Word 2007 creati dopo l'installazione di SP1. Per ulteriori informazioni, vedere la classe Cenni preliminari sugli smart tag.
Esporre gli oggetti del componente aggiuntivo ad altre soluzioni Microsoft Office.	Sottoporre a override il metodo RequestComAddInAutomationService. Per ulteriori informazioni, vedere Chiamata di codice nei componenti aggiuntivi a livello di applicazione da altre soluzioni Office.
Personalizzare una funzionalità in Microsoft Office System 2007 implementando un'interfaccia di estensibilità.	Eseguire l'override del metodo RequestService in modo da ottenere un'istanza della classe che implementa l'interfaccia. Per ulteriori informazioni, vedere la classe Personalizzazione delle funzionalità dell'interfaccia utente utilizzando le interfacce di estensibilità. Nota: Per personalizzare l'interfaccia utente della barra multifunzione è anche possibile eseguire l'override del metodo CreateRibbonExtensibilityObject.

Vedere anche

Attività

Procedura dettagliata: chiamata di codice in un componente aggiuntivo a livello di applicazione da VBA

Concetti

Programmazione di componenti aggiuntivi a livello di applicazione

Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione

Personalizzazione delle funzionalità dell'interfaccia utente utilizzando le interfacce di estensibilità

Chiamata di codice nei componenti aggiuntivi a livello di applicazione da altre soluzioni Office

Guida introduttiva alla programmazione di componenti aggiuntivi a livello di applicazione

Eventi di progetti Visual Studio Tools per Office

Cronologia delle modifiche