Programmazione di componenti aggiuntivi a livello di applicazione
Aggiornamento: novembre 2007
Si applica a |
|---|
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto
Versione Microsoft Office
Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione. |
Quando si estende un'applicazione di Microsoft Office creando un componente aggiuntivo Visual Studio Tools per Office, si scrive il codice direttamente a fronte della classe ThisAddIn del progetto. È possibile utilizzare questa classe per eseguire attività quali l'accesso al modello a oggetti dell'applicazione host di Microsoft Office, la personalizzazione dell'interfaccia utente (UI) dell'applicazione e l'esposizione di oggetti del componente aggiuntivo alle altre soluzioni Office.
Per informazioni generali sui componenti aggiuntivi a livello di applicazione e sugli altri tipi di soluzione che è possibile creare tramite Visual Studio Tools per Office, vedere Cenni preliminari sullo sviluppo di soluzioni Office.
Scrittura del codice nel progetto di componente aggiuntivo
È possibile iniziare a scrivere il codice del componente aggiuntivo nella classe ThisAddIn, generata automaticamente da Visual Studio Tools per Office nel file di codice ThisAddIn.vb (in Visual Basic) o ThisAddIn.cs (in C#) del progetto di componente aggiuntivo.
Nella classe ThisAddIn sono disponibili due gestori eventi predefiniti. Per eseguire il codice quando il componente aggiuntivo viene caricato, aggiungere codice al gestore eventi ThisAddIn_Startup. Per eseguire il codice poco prima che il componente aggiuntivo venga scaricato, aggiungere codice al gestore eventi ThisAddIn_Shutdown. Per ulteriori informazioni, vedere la classe Eventi di progetti Visual Studio Tools per Office.
La classe ThisAddIn deriva la maggior parte delle funzionalità dalla classe AddIn. AddIn fornisce le funzionalità principali condivise da tutti i componenti aggiuntivi per Visual Studio Tools per Office. Per ulteriori informazioni sulla classe AddIn, vedere Elementi host di componenti aggiuntivi.
Accesso al modello a oggetti dell'applicazione host
Per accedere al modello a oggetti dell'applicazione host, utilizzare il campo Application della classe ThisAddIn. Questo campo restituisce un oggetto che rappresenta l'istanza corrente dell'applicazione host.
Nell'esempio di codice seguente viene mostrato come utilizzare il campo Application per creare una nuova cartella di lavoro in un componente aggiuntivo per Microsoft Office Excel. Questo esempio deve essere eseguito dall'interno della classe ThisAddIn.
Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()
Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);
Per eseguire lo stesso esempio dall'esterno della classe ThisAddIn, utilizzare l'oggetto Globals per accedere alla classe ThisAddIn. Per ulteriori informazioni sull'oggetto Globals, vedere Accesso globale agli oggetti nei progetti Visual Studio Tools per Office.
Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()
Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);
Nella tabella seguente è indicato il tipo di valore restituito per il campo Application in ogni progetto di componente aggiuntivo.
Applicazione host |
Tipo di valore restituito |
|---|---|
Microsoft Office Excel |
|
Microsoft Office InfoPath |
Microsoft.Office.Interop.InfoPath.Application |
Microsoft Office Outlook |
Microsoft.Office.Interop.Outlook.Application |
Microsoft Office PowerPoint |
Microsoft.Office.Interop.PowerPoint.Application |
Microsoft Office Project |
Microsoft.Office.Interop.MSProject.Application |
Microsoft Office Visio |
Microsoft.Office.Interop.Visio.Application |
Microsoft Office Word |
Personalizzazione dell'interfaccia utente delle applicazioni di Microsoft Office
Mediante un componente aggiuntivo a livello di applicazione è possibile personalizzare a livello di codice l'interfaccia utente delle applicazioni di Microsoft Office. Per le applicazioni di Microsoft Office 2003, tra le funzionalità personalizzabili dell'interfaccia utente vi sono i menu e le barre degli strumenti. Le applicazioni di Microsoft Office System 2007 presentano alcune funzionalità dell'interfaccia utente diverse che è possibile personalizzare. Queste funzionalità includono la barra multifunzione, i riquadri attività personalizzati e le aree del modulo di Outlook. Per ulteriori informazioni, vedere Personalizzazione dell'interfaccia utente di Office.
Visual Studio Tools per Office fornisce finestre di progettazione e classi che è possibile utilizzare per creare riquadri attività personalizzati, personalizzazioni della barra multifunzione e aree del modulo di Outlook. Queste finestre di progettazione e classi aiutano a semplificare il processo di personalizzazione di queste funzionalità. Per ulteriori informazioni, vedere Cenni preliminari sui riquadri attività personalizzati, Finestra di progettazione della barra multifunzione e Creazione di aree di modulo di Outlook.
Per personalizzare una di queste funzionalità in una modalità non supportata dalle classi e dalle finestre di progettazione Visual Studio Tools per Office, è possibile implementare anche un'interfaccia di estensibilità nel componente aggiuntivo. Per ulteriori informazioni, vedere Personalizzazione delle funzionalità dell'interfaccia utente utilizzando le interfacce di estensibilità.
A partire da Visual Studio 2008 Service Pack 1 (SP1) è possibile modificare anche l'interfaccia utente di documenti di Word e di cartelle di lavoro di Excel mediante la creazione di elementi host che estendono il comportamento di documenti e cartelle di lavoro. Ciò consente di aggiungere controlli e smart tag Visual Studio Tools per Office gestiti in documenti e fogli di lavoro. Per ulteriori informazioni, vedere la classe Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.
Chiamata di codice nei componenti aggiuntivi a livello di applicazione da altre soluzioni Office
È possibile esporre gli oggetti del componente aggiuntivo ad altre soluzioni Microsoft Office. Ciò è utile se il componente aggiuntivo fornisce un servizio che si desidera possa essere utilizzato da altre soluzioni Office. Se ad esempio si dispone di un componente aggiuntivo per Microsoft Office Excel che effettua i calcoli dei dati finanziari di un servizio Web, le altre soluzioni Office possono effettuare tali calcoli eseguendo la chiamata nel componente aggiuntivo per Excel in fase di esecuzione.
Per ulteriori informazioni, vedere la classe Chiamata di codice nei componenti aggiuntivi a livello di applicazione da altre soluzioni Office.
Vedere anche
Attività
Procedura: creare progetti Visual Studio Tools per Office
Concetti
Elementi host di componenti aggiuntivi
Chiamata di codice nei componenti aggiuntivi a livello di applicazione da altre soluzioni Office
Architettura dei componenti aggiuntivi a livello di applicazione