Condividi tramite


Creare aree del modulo di Outlook

È possibile usare aree del modulo per personalizzare i moduli di Microsoft Office Outlook. Visual Studio fornisce strumenti avanzati che semplificano la progettazione, lo sviluppo e il debug delle aree del modulo.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO per Outlook. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Questo argomento contiene informazioni sui seguenti aspetti:

Vantaggi dell'uso delle aree del modulo

Le aree del modulo offrono numerosi miglioramenti rispetto allo sviluppo di moduli Outlook tradizionali:

  • Personalizzare la pagina predefinita di qualsiasi modulo standard.

  • Aggiungere fino a 12 pagine aggiuntive a qualsiasi modulo standard.

  • Sostituire o migliorare un modulo standard.

  • Visualizzare l'interfaccia utente personalizzata nel riquadro di lettura e nei controlli.

    Per altre informazioni, vedere Personalizzare le pagine dei moduli e le aree del modulo.

Aggiungere un'area del modulo di Outlook al progetto

È possibile utilizzare la procedura guidata Nuova area del modulo di Outlook per progettare una nuova area del modulo o importare un'area del modulo progettata in Outlook. È anche possibile riutilizzare un'area del modulo esistente, precedentemente usata in un altro progetto di componente aggiuntivo VSTO di Outlook.

Creare una nuova area del modulo usando la procedura guidata

Per creare un'area del modulo, aggiungere un elemento area del modulo di Outlook a un progetto di componente aggiuntivo VSTO di Outlook. Verrà avviata la procedura guidata Nuova area del modulo di Outlook.

Usare la procedura guidata per indicare se si vuole progettare una nuova area del modulo o importare un'area del modulo progettata in Outlook. Per altre informazioni sulla progettazione di una nuova area del modulo, vedere Usare la finestra di progettazione dell'area del modulo. Per altre informazioni sull'uso di un'area del modulo progettata in Outlook, vedere Importare un'area del modulo progettata in Outlook.

Usare la procedura guidata per specificare il tipo di area del modulo da creare. La tabella seguente descrive ciascun tipo di area del modulo.

Tipo di area Descrizione
Separa Aggiunge l'area del modulo come una nuova pagina a un modulo di Outlook.
Adiacente Aggiunge l'area del modulo alla parte inferiore della pagina predefinita di un modulo di Outlook.
Sostituzione Aggiunge l'area del modulo come una nuova pagina che sostituisce la pagina predefinita di un modulo di Outlook.
Sostituzione completa Sostituisce l'intero modulo di Outlook con l'area del modulo.

È anche possibile usare la procedura guidata per specificare le condizioni di visualizzazione e selezionare il tipo di modulo da estendere. Per altre informazioni, vedere Procedura: Aggiungere un'area del modulo a un progetto di componente aggiuntivo di Outlook.

Le selezioni effettuate nella procedura guidata influiscono sulle opzioni disponibili in altre pagine della procedura guidata. Ad esempio, se si seleziona Adiacente o Separato nella pagina Crea una nuova area del modulo di Outlook, i campi Titolo e Descrizione non sono disponibili nel testo descrittivo Specificare e selezionare la pagina delle preferenze di visualizzazione. Questo avviene perché Outlook non usa questi campi quando viene visualizzata un'area del modulo adiacente o separata.

File di area del modulo

Al termine della procedura guidata Nuova area del modulo di Outlook, Visual Studio aggiunge automaticamente i file seguenti al progetto:

  • Un file di codice dell'area del modulo. Questo file ha il nome specificato per l'elemento Area modulo di Outlook nella finestra di dialogo Aggiungi nuovo elemento . Aggiungere a questo file il codice per gestire gli eventi dell'area del modulo.

  • Un file di codice di Progettazione aree di form. Questo file contiene il codice generato da Progettazione aree di form e non può essere modificato direttamente.

  • File Archiviazione modulo di Outlook (con estensione ofs).

    Nota

    Questo file viene aggiunto al progetto solo se si importa un'area del modulo progettata in Outlook.

Classe factory dell'area del modulo

Il file di codice dell'area del modulo contiene una classe parziale che implementa l'interfaccia IFormRegionFactory. Si tratta della classe factory dell'area del modulo che è responsabile della creazione di nuove istanze dell'area del modulo.

È possibile trovare questa classe espandendo l'area factory dell'area del modulo.

La procedura guidata Nuova area del modulo di Outlook aggiunge attributi a questa classe che specificano il nome interno dell'area del modulo e le classi messaggio che visualizzano l'area del modulo. È possibile modificare manualmente questi attributi dopo che il file è stato aggiunto al progetto.

La maggior parte della classe factory dell'area del modulo è implementata nel file di Progettazione aree di form. Tuttavia, il gestore eventi FormRegionInitializing è esposto nel file di codice dell'area del modulo e può essere usato per specificare se l'area del modulo deve essere visualizzata in Outlook. Per altre informazioni, vedere Gestire gli eventi dell'area del modulo.

Aggiungere un'area del modulo esistente al progetto

Un'area del modulo di Outlook di un altro progetto di Outlook può essere riutilizzata nel progetto corrente di componente aggiuntivo VSTO per Outlook con la finestra di dialogo Aggiungi elemento esistente .

L'area del modulo esistente deve avere un file di codice (con estensione vb o cs). Non è possibile aggiungere file di Archiviazione (con estensione ofs) di Outlook tramite la finestra di dialogo Aggiungi elemento esistente. Tuttavia, è possibile creare un'area del modulo nuova importando un file ofs (Outlook From Storage). Per altre informazioni, vedere Procedura: Aggiungere un'area del modulo a un progetto di componente aggiuntivo di Outlook.

Usare la finestra di progettazione dell'area del modulo

Progettazione aree di form consente di configurare il layout e l'aspetto di un'area del 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

È possibile trovare proprietà che influiscono sulla modalità di visualizzazione dell'area del modulo in Outlook sotto il nodo Manifesto nella finestra Proprietà .

La finestra di progettazione dell'area del modulo è disponibile solo se si seleziona Progetta una nuova area del modulo nella pagina Seleziona come creare l'area del modulo della procedura guidata Nuova area del modulo di Outlook.

È possibile aprire Progettazione aree di form in tre modi diversi:

  • In Esplora soluzioni fare doppio clic sul file di codice dell'area del modulo.

  • In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di codice dell'area del modulo e quindi scegliere Progettazione viste.

  • In Esplora soluzioni selezionare il file di codice dell'area del modulo e quindi scegliere Progettazione dal menu Visualizza.

    Progettazione aree di form supporta solo i controlli gestiti. Non è possibile aggiungere controlli nativi di Outlook.

Importare un'area del modulo progettata in Outlook

Quando si progetta in Outlook, è possibile aggiungere all'area del modulo i controlli nativi di Outlook che consentono di effettuare associazioni ai dati di Outlook in fase di progettazione. Tuttavia, non si potrà usare in seguito Progettazione aree di form per aggiungere i controlli gestiti o modificare la progettazione dell'area del modulo.

È possibile importare aree del modulo in un progetto di componente aggiuntivo VSTO di Outlook tramite la procedura guidata Nuova area del modulo di Outlook. Nella pagina Seleziona come creare l'area del modulo selezionare Importa un file di Archiviazione modulo di Outlook (con estensione ofs). È quindi possibile passare al percorso di un file di Archiviazione di modulo di Outlook (con estensione ofs). Outlook salva le aree del modulo come file con estensione ofs .

La creazione guidata Nuova area del modulo di Outlook copia il file con estensione ofs nella directory del progetto e aggiunge riferimenti di controllo al file di progettazione dell'area del modulo. È possibile quindi gestire gli eventi di controllo nel file di codice dell'area del 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 gestire gli eventi in un progetto C#, sottoscrivere gli eventi di controllo nel metodo FormRegionShowing. Per altre informazioni, vedere Procedura: Sottoscrivere e annullare la sottoscrizione agli eventi (Guida per programmatori C#).

È possibile modificare le proprietà dell'area del modulo nel metodo InitializeManifest della classe factory dell'area del 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 funzionerà solo in un progetto usando il modello di progetto del componente aggiuntivo outlook 2010 .

Aggiornare la progettazione di un'area del modulo importata

È possibile aggiungere, rimuovere o modificare i controlli dell'area del modulo. Prima di eseguire queste operazioni, effettuare il backup del codice aggiunto al file di codice dell'area del modulo. Aprire quindi il file con estensione ofs in Outlook, modificare l'area del modulo e quindi salvare le modifiche. Utilizzare la procedura guidata Nuova area del modulo di Outlook per importare il file con estensione ofs modificato. È quindi possibile incollare il codice nel file di codice della nuova area del modulo.

Aggiungere codice personalizzato a un'area del modulo

Lo spazio dei nomi Microsoft.Office.Tools.Outlook fornisce l'accesso alle classi che rappresentano l'area del modulo, all'elemento di Outlook che visualizza l'area del modulo e ad altri elementi utili. L'elemento Area 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 del modulo.

È possibile usare classi, metodi e proprietà nello spazio dei nomi Microsoft.Office.Interop.Outlook per eseguire la maggior parte delle attività di programmazione di Outlook. Per altre informazioni sul modello a oggetti di Outlook, vedere Panoramica del modello a oggetti di Outlook. Per esempi di attività tipiche che utilizzano il modello a oggetti di Outlook, vedere Soluzioni outlook.

Gestire gli eventi dell'area del modulo

L'elemento Area modulo di Outlook aggiunge automaticamente i tre gestori eventi seguenti al file di codice dell'area del modulo.

Evento Descrizione
FormRegionInitializing Si verifica prima dell'inizializzazione dell'area del form. È possibile selezionare le condizioni di questo gestore eventi per determinare se l'area del modulo deve essere visualizzata in Outlook. Per altre 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.

Compilare il progetto

Quando si compila un progetto di componente aggiuntivo VSTO 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 del modulo e un valore associato che rappresenta il nome del componente aggiuntivo VSTO di Outlook.

    Outlook usa queste informazioni per caricare le aree del modulo.

Eseguire il debug di un'area del modulo

È possibile eseguire il debug di un componente aggiuntivo VSTO di Outlook che contiene un'area del modulo esattamente come si eseguirà il debug di altri progetti di Visual Studio. Quando si avvia il debugger di Visual Studio, Visual Studio avvia automaticamente Outlook.

Per visualizzare l'area del modulo è necessario aprire l'elemento di Outlook appropriato. Ad esempio, se un'area del modulo adiacente viene aggiunta alla fine di un elemento di posta, aprire un elemento di posta.

Distribuire un'area del modulo

Le aree del modulo sono distribuite automaticamente con il componente aggiuntivo VSTO di Outlook associato. Non è quindi necessario eseguire un'attività particolare per distribuire un'area del modulo. Per altre informazioni sulla distribuzione di componenti aggiuntivi VSTO, vedere Distribuire una soluzione Office.

Posizione Descrizione
Linee guida per la creazione di aree del modulo di Outlook Fornisce 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 di Outlook Viene illustrato come creare un'area del modulo per estendere un modulo standard o personalizzato di Microsoft Office Outlook tramite la procedura guidata Nuova area del modulo di Outlook.
Associare un'area del modulo a una classe messaggio di Outlook Illustra 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.
Procedura dettagliata: Progettare un'area del modulo di Outlook Mostra come progettare un'area del modulo personalizzata che viene visualizzata come una nuova pagina nella finestra di controllo di un contatto.
Procedura dettagliata: Importare un'area del modulo progettata in Outlook Viene illustrato come progettare un'area del modulo in Microsoft Office Outlook e quindi importare l'area del modulo in un progetto di componente aggiuntivo VSTO di Outlook tramite la procedura guidata Nuova area del modulo di Outlook.
Accedere a un'area del modulo in fase di esecuzione Descrive 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 usando la classe Globals.
Procedura: Impedire la visualizzazione di un'area del modulo in Outlook Illustra come impedire a Microsoft Office Outlook di visualizzare un'area del modulo per un particolare elemento.
Illustra come accedere all'elemento di Outlook in cui viene visualizzata un'area del modulo.
Azioni personalizzate nelle aree del modulo di Outlook Descrive come consentire agli utenti di rispondere a un elemento di Outlook.