Creazione di aree di modulo di Outlook
È possibile utilizzare aree del modulo per personalizzare i moduli di Microsoft Office Outlook. In Visual Studio sono disponibili strumenti avanzati che semplificano la progettazione, lo sviluppo e il debug delle aree del modulo.
Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Outlook 2007 e Outlook 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.
In questo argomento vengono fornite le seguenti informazioni:
Vantaggi dell'utilizzo delle aree di modulo
Aggiunta di un'area di modulo di Outlook a un progetto
Utilizzo di Progettazione aree di modulo
Utilizzo di un'area di modulo progettata in Outlook
Aggiunta di codice personalizzato a un'area di modulo
Compilazione del progetto
Debug di un'area di modulo
Distribuzione di un'area di modulo
Vantaggi dell'utilizzo delle aree di modulo
Le aree di modulo offrono molte caratteristiche avanzate rispetto allo sviluppo tradizionale dei moduli di Outlook:
Personalizzazione della pagina predefinita di qualsiasi modulo standard.
Aggiunta di un massimo di 12 pagine a qualsiasi modulo standard.
Sostituzione o miglioramento di qualsiasi modulo standard.
Visualizzazione dell'interfaccia utente personalizzata nel riquadro di lettura e nei controlli.
Per ulteriori informazioni, vedere Customizing Form Pages and Form Regions (informazioni in lingua inglese).
Aggiunta di un'area di modulo di Outlook a un progetto
Utilizzare la procedura guidata Nuova area del modulo di Outlook per progettare una nuova area di modulo o importare un'area di modulo progettata in Outlook. È inoltre possibile utilizzare un'area del modulo che è già stata impiegata in un altro progetto di componente aggiuntivo per Outlook.
Creazione di una nuova area di modulo con la procedura guidata
Per creare un'area di modulo, aggiungere un elemento Area del modulo di Outlook al progetto di componente aggiuntivo per Outlook. Viene avviata la procedura guidata Nuova area del modulo di Outlook.
Utilizzare la procedura guidata per indicare se si desidera progettare una nuova area di modulo o importare un'area di modulo progettata in Outlook. Per ulteriori informazioni sulla progettazione di una nuova area di modulo, vedere Utilizzo di Progettazione aree di modulo. Per ulteriori informazioni sull'utilizzo di un'area di modulo progettata in Outlook, vedere Importazione di un'area di modulo progettata in Outlook.
Utilizzare la procedura guidata per specificare il tipo di area di modulo da creare. Nella tabella riportata di seguito vengono descritti i tipi di area di modulo disponibili:
Tipo di area |
Descrizione |
|---|---|
Separate |
Aggiunge l'area del modulo come una nuova pagina in un modulo di Outlook. |
Adiacente |
Aggiunge l'area di modulo alla fine della pagina predefinita di un modulo di Outlook. |
Replacement |
Aggiunge l'area di modulo come una nuova pagina in sostituzione della pagina predefinita di un modulo di Outlook. |
Sostituzione completa |
Sostituisce tutto il modulo di Outlook con l'area di modulo. |
È possibile utilizzare la procedura guidata anche per specificare le condizioni di visualizzazione e selezionare il tipo di modulo da estendere. Per ulteriori informazioni, vedere Procedura: aggiungere un'area del modulo a un progetto di componente aggiuntivo per Outlook.
Le opzioni disponibili nelle pagine della procedura guidata variano a seconda delle selezioni effettuate nella procedura guidata stessa. Ad esempio, se si seleziona Adiacente o Separa nella pagina Crea nuova area di modulo di Outlook, i campi Titolo e Descrizione non sono disponibili nella pagina Fornire un testo descrittivo e selezionare le preferenze di visualizzazione. Ciò accade perché questi campi non sono utilizzati in Outlook quando viene visualizzata un'area di modulo adiacente o separata.
File dell'area di modulo
Al termine della procedura guidata Nuova area del modulo di Outlook, Visual Studio aggiunge automaticamente al progetto i seguenti file:
Un file di codice dell'area di modulo. Il nome di questo file corrisponde a quello specificato per l'elemento Area del modulo di Outlook nella finestra di dialogo Aggiungi nuovo elemento. Aggiungere a questo file il codice per gestire gli eventi dell'area di modulo.
Un file di codice di Progettazione aree di modulo. Questo file contiene il codice generato da Progettazione aree di modulo e non può essere modificato direttamente.
Un file ofs (Outlook Form Storage).
Nota
Questo file viene aggiunto al progetto solo se si importa un'area di modulo progettata in Outlook.
Classe factory dell'area di modulo
Il file di codice dell'area di modulo contiene una classe parziale che implementa l'interfaccia IFormRegionFactory. Si tratta della classe factory dell'area di modulo che è responsabile della creazione di nuove istanze dell'area di modulo.
Tale classe è disponibile espandendo l'area Factory area del modulo.
La procedura guidata Nuova area del modulo di Outlook aggiunge a questa classe gli attributi che specificano il nome interno dell'area di modulo e le classi di messaggio che visualizzano l'area di modulo. È possibile modificare manualmente questi attributi dopo che il file è stato aggiunto al progetto.
La maggior parte della classe factory dell'area di modulo è implementata nel file di Progettazione aree di modulo. Tuttavia, il gestore eventi FormRegionInitializing è esposto nel file di codice dell'area di modulo e può essere utilizzato per specificare se l'area di modulo deve essere visualizzata in Outlook. Per ulteriori informazioni, vedere Gestione degli eventi dell'area di modulo.
Aggiunta di un'area di modulo esistente a un progetto
Un'area del modulo di Outlook di un altro progetto di Outlook può essere riutilizzata nel progetto corrente di componente aggiuntivo per Outlook tramite la finestra di dialogo Aggiungi elemento esistente .
L'area di modulo esistente deve disporre di un file di codice (vb o cs) in quanto non è possibile aggiungere i file ofs (Outlook From Storage) tramite la finestra di dialogo Aggiungi elemento esistente. Tuttavia, è possibile creare un'area di modulo nuova importando un file ofs (Outlook From Storage). Per ulteriori informazioni, vedere Procedura: aggiungere un'area del modulo a un progetto di componente aggiuntivo per Outlook.
Utilizzo di Progettazione aree di modulo
Progettazione aree di modulo consente di configurare il layout e l'aspetto di un'area di modulo. È possibile trascinare i controlli gestiti nell'area di progettazione, fare doppio clic sui controlli per aprire i gestori eventi e impostare le proprietà nella finestra Proprietà.
Nota
Le proprietà che influiscono sulla modalità di visualizzazione dell'area di modulo in Outlook sono disponibili sotto il nodo Manifesto nella finestra Proprietà.
Progettazione aree di modulo è disponibile solo se si seleziona Progetta nuova area del modulo nella pagina Selezionare la modalità di creazione dell'area del modulo della procedura guidata Nuova area del modulo di Outlook.
È possibile aprire Progettazione aree di modulo in tre modi diversi:
In Esplora soluzioni fare doppio clic sul file di codice dell'area di modulo.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di codice dell'area di modulo, quindi scegliere Visualizza finestra di progettazione.
In Esplora soluzioni selezionare il file di codice dell'area di modulo, quindi scegliere Finestra di progettazione dal menu Visualizza.
Progettazione aree di modulo supporta solo i controlli gestiti. Non è possibile aggiungere controlli nativi di Outlook.
Importazione di un'area di modulo progettata in Outlook
Quando si progetta in Outlook, è possibile aggiungere all'area di modulo i controlli nativi di Outlook che consentono di effettuare associazioni ai dati di Outlook in fase di progettazione. Tuttavia, non si potrà utilizzare in seguito Progettazione aree di modulo per aggiungere i controlli gestiti o modificare la progettazione dell'area di modulo.
È possibile importare aree di modulo in un progetto di componente aggiuntivo per Outlook utilizzando la procedura guidata Nuova area del modulo di Outlook. Nella pagina Selezionare la modalità di creazione dell'area del modulo, scegliere Importa un file OFS (Outlook Form Storage). Quindi, selezionare il percorso di un file ofs (Outlook Form Storage). Outlook salva le aree di modulo come file ofs.
La procedura guidata Nuova area del modulo di Outlook copia il file ofs nella directory del progetto e aggiunge i riferimenti ai controlli al file di Progettazione aree di modulo. È possibile quindi gestire gli eventi di controllo nel file di codice dell'area di modulo.
Per gestire gli eventi in un progetto Visual Basic, selezionare un evento dall'elenco dei nomi di metodo nella parte superiore dell'editor di codice. Per ulteriori informazioni, vedere How to: Create Event Handlers in the Visual Basic Code Editor.
Per gestire gli eventi in un progetto C#, sottoscrivere gli eventi di controllo nel metodo FormRegionShowing. Per ulteriori informazioni, vedere Procedura: sottoscrivere e annullare la sottoscrizione di eventi (Guida per programmatori C#).
È possibile modificare le proprietà dell'area di modulo nel metodo InitializeManifest della classe factory dell'area di modulo.
Nota
Per importare un'area del modulo, è necessario lavorare a un progetto destinato alla stessa versione di Outlook installata nel computer di sviluppo. Ad esempio, se è installato Outlook 2010, l'importazione di un'area del modulo potrà essere eseguita solo in un progetto creato tramite il modello di progetto Componente aggiuntivo per Outlook 2010.
Aggiornamento della progettazione di un'area di modulo importata
È possibile aggiungere, rimuovere o modificare i controlli dell'area di modulo. Prima di eseguire queste operazioni, effettuare il backup del codice aggiunto al file di codice dell'area di modulo. Quindi, aprire il file OFS in Outlook, modificare l'area del modulo e salvare le modifiche. Utilizzare la procedura guidata Nuova area del modulo di Outlook per importare il file OFS modificato. È quindi possibile incollare il codice nel file di codice della nuova area di modulo.
Aggiunta di codice personalizzato a un'area di modulo
Lo spazio dei nomi Microsoft.Office.Tools.Outlook fornisce l'accesso alle classi che rappresentano l'area di modulo, all'elemento di Outlook che visualizza l'area di modulo e ad altri elementi utili. L'elemento Area del modulo di Outlook aggiunge automaticamente un riferimento a questo assembly nel progetto e inserisce l'istruzione using o Imports appropriata all'inizio del file di codice dell'area di modulo.
È possibile utilizzare classi, metodi e proprietà nello spazio dei nomi Microsoft.Office.Interop.Outlook per eseguire la maggior parte delle attività di programmazione di Outlook. Per ulteriori informazioni sul modello a oggetti di Outlook, vedere Cenni preliminari sul modello a oggetti di Outlook. Per esempi di attività tipiche che si avvalgono del modello a oggetti di Outlook, vedere Soluzioni Outlook.
Gestione di eventi dell'area di modulo
L'elemento Area del modulo di Outlook aggiunge automaticamente al file di codice dell'area di modulo i seguenti tre gestori eventi.
Evento |
Descrizione |
|---|---|
FormRegionInitializing |
Si verifica prima dell'inizializzazione dell'area di modulo. È possibile selezionare le condizioni di questo gestore eventi per determinare se l'area di modulo deve essere visualizzata in Outlook. Per ulteriori informazioni, vedere Procedura: impedire la visualizzazione di un'area del modulo in Outlook. |
FormRegionShowing |
Si verifica dopo la creazione di un'istanza dell'area del modulo, ma prima della visualizzazione dell'area del modulo. |
FormRegionClosed |
Si verifica prima della chiusura dell'area del modulo. |
Compilazione del progetto
Quando si compila un progetto di componente aggiuntivo per Outlook contenente un'area del modulo, Visual Studio aggiunge le informazioni seguenti al Registro di sistema:
Una chiave per ogni classe di messaggi associata a una o più aree del modulo.
Una voce per ogni area di modulo e un valore associato che rappresenta il nome del componente aggiuntivo di Outlook.
Outlook utilizza queste informazioni per caricare le aree di modulo.
Debug di un'area di modulo
È possibile eseguire il debug di un componente aggiuntivo di Outlook contenente un'area di modulo proprio come se si trattasse del debug di altri progetti Visual Studio. All'avvio del debugger di Visual Studio, Visual Studio avvia automaticamente Outlook.
Per visualizzare l'area di modulo è necessario aprire l'elemento di Outlook appropriato. Ad esempio, se un'area di modulo adiacente viene aggiunta alla fine di un elemento di posta, aprire un elemento di posta.
Distribuzione di un'area di modulo
Le aree di modulo sono distribuite automaticamente con il componente aggiuntivo di Outlook associato. Pertanto, non è necessario eseguire un'attività particolare per distribuire un'area di modulo. Per ulteriori informazioni sulla distribuzione di componenti aggiuntivi, vedere Distribuzione di soluzioni Office.
Argomenti correlati
Titolo |
Descrizione |
|---|---|
Linee guida per la creazione delle aree di modulo di Outlook |
Vengono fornite informazioni che consentono di ottimizzare le aree del modulo ed evitare eventuali problemi. |
Procedura: aggiungere un'area del modulo a un progetto di componente aggiuntivo per Outlook |
Viene illustrato come creare un'area del modulo per estendere un modulo standard o personalizzato di Microsoft Office Outlook utilizzando la procedura guidata Nuova area del modulo di Outlook. |
Associazione di un'area del modulo a una classe messaggio di Outlook |
Viene illustrato come specificare quali elementi di Microsoft Office Outlook consentono di visualizzare un'area del modulo associando l'area del modulo alla classe di messaggio di ogni elemento. |
Viene illustrato come progettare un'area del modulo personalizzata che viene visualizzata come nuova pagina nella finestra di controllo di un elemento di contatto. |
|
Procedura dettagliata: importazione di un'area di modulo progettata in Outlook |
Viene illustrato come progettare un'area del modulo in Microsoft Office Outlook e come importare l'area di modulo in un progetto di componente aggiuntivo di Outlook mediante la procedura guidata Nuova area del modulo di Outlook. |
Viene descritto come scrivere codice per mostrare, nascondere o modificare i controlli presenti in un'area del modulo e consentire agli utenti di eseguire il codice da altre aree del progetto utilizzando la classe Globals. |
|
Procedura: impedire la visualizzazione di un'area del modulo in Outlook |
Viene illustrato come impedire a Microsoft Office Outlook di visualizzare un'area del modulo per un particolare elemento. |
Procedura: accedere all'elemento di Outlook in cui viene visualizzata l'area del modulo |
Viene illustrato come accedere all'elemento di Outlook in cui viene visualizzata un'area del modulo. |
Viene descritto come consentire agli utenti di rispondere a un elemento di Outlook. |
|
Viene illustrato come aggiungere un'azione personalizzata utilizzando un elemento Area del modulo di Outlook. |