Linee guida per la creazione delle aree di modulo di Outlook
Le seguenti informazioni consentono di ottimizzare le aree di modulo ed evitare eventuali problemi:
Utilizzo dei nomi delle aree di modulo.
Disabilitazione dell'ereditarietà delle aree di modulo.
Informazioni sui nomi dei tipi e delle classi messaggio.
Progettazione di aree di modulo adiacenti per il riquadro di lettura.
Utilizzo di dimensioni ottimali delle icone.
Per ulteriori informazioni sulle aree di modulo, vedere Creazione di aree di modulo di Outlook.
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.
Utilizzo dei nomi delle aree di modulo
Per descrivere l'area del modulo vengono utilizzati diversi nomi. È importante comprendere la differenza tra questi nomi e come influiscono sull'area del modulo. Nella tabella riportata di seguito viene descritto ciascun nome.
Nome dell'area del modulo |
Descrizione |
|---|---|
Nome di elemento dell'area del modulo |
Nome specificato per l'elemento Area del modulo di Outlook nella finestra di dialogo Aggiungi nuovo elemento. Si tratta del nome del file di codice dell'area del modulo visualizzato in Esplora soluzioni. |
Proprietà FormRegionName |
Questo nome viene specificato nella pagina Fornire un testo descrittivo e selezionare le preferenze di visualizzazione della procedura guidata Nuova area del modulo di Outlook e viene visualizzato come proprietà FormRegionName nella finestra Proprietà. Utilizzare la proprietà FormRegionName per specificare l'etichetta che identifica l'area del modulo nell'interfaccia utente di Outlook. Per le aree di modulo separate, questo nome viene visualizzato come pulsante sulla barra multifunzione dell'elemento di Outlook. Per le aree di modulo adiacenti, questo nome viene visualizzato come testo di intestazione situato sopra l'area del modulo. |
Attributo Microsoft.Office.Tools.Outlook.FormRegionName |
Quando si aggiunge un elemento Area del modulo di Outlook al progetto, in Visual Studio questa proprietà viene impostata sul nome completo dell'area del modulo. Il nome completo predefinito è costituito dal nome del componente aggiuntivo seguito da un punto e quindi dal nome dell'area del modulo, ad esempio OutlookAddIn1.FormRegion1. Questo nome completo viene anche visualizzato come attributo all'inizio della classe factory dell'area del modulo. Utilizzare l'attributo Microsoft.Office.Tools.Outlook.FormRegionName per identificare in modo univoco l'area del modulo in tutti i componenti aggiuntivi per Outlook. Non è possibile modificare il valore dell'attributo Microsoft.Office.Tools.Outlook.FormRegionName rinominando l'elemento dell'area del modulo o modificando la proprietà FormRegionName. Per modificare questo nome, è necessario modificare l'attributo Microsoft.Office.Tools.Outlook.FormRegionName nel file di codice dell'area del modulo. |
Disabilitazione dell'ereditarietà delle aree di modulo
Per impostazione predefinita, una classe messaggio personalizzata eredita tutte le associazioni dell'area del modulo della classe messaggio di base. Ad esempio, una classe messaggio denominata IPM.Task.Contoso deriva da IPM.Task. Di conseguenza, IPM.Task.Contoso eredita le associazioni dell'area del modulo di IPM.Task.
Se non si desidera che l'area del modulo venga associata a classi messaggio derivate, impostare la proprietà ExactMessageClass dell'area del modulo su true. Ad esempio, se si esegue l'associazione di un'area del modulo adiacente a IPM.Task e si imposta la proprietà ExactMessageClass su true, l'area del modulo verrà accodata solo alla fine di un modulo di attività standard e non anche alla fine di eventuali versioni personalizzate di tale modulo.
Informazioni sui nomi dei tipi e delle classi messaggio
Il nome di tipo di un elemento di Outlook è diverso dal nome di classe messaggio di tale elemento. Ad esempio, il nome di tipo di un elemento RSS è Microsoft.Office.Interop.Outlook.PostItem. Il nome di classe messaggio di un elemento RSS è, invece, IPM.Post.RSS.
Utilizzare il nome di tipo per fare riferimento a un elemento di Outlook nel codice. Per un elenco dei nomi di tipo, vedere Associazione di un'area del modulo a una classe messaggio di Outlook.
Utilizzare il nome di classe messaggio degli elementi di Outlook nella procedura guidata Nuova area del modulo di Outlook per associare l'elemento all'area del modulo. Per un elenco di nomi di classe messaggio validi, vedere Associazione di un'area del modulo a una classe messaggio di Outlook.
Progettazione di aree di modulo adiacenti per il riquadro di lettura
È possibile utilizzare il riquadro di lettura di Outlook per visualizzare in anteprima un elemento di Outlook senza aprirlo. Il riquadro di lettura è progettato esclusivamente per la lettura. Di conseguenza, è possibile che i controlli di input che si aggiungono a un'area del modulo adiacente, ad esempio una casella di testo, non si comportino nel modo previsto quando l'elemento e l'area del modulo vengono aperti nel riquadro di lettura.
Ad esempio, se un elemento con un'area del modulo adiacente viene aperto nel riquadro di lettura, può verificarsi la seguente situazione:
Selezionare il testo contenuto in una casella di testo situata nell'area del modulo.
Premere CANC.
Viene eliminato l'intero elemento di posta anziché il testo nella casella di testo.
Se si progetta un'area del modulo adiacente che contiene controlli di input, testare i controlli nel riquadro di lettura per assicurarsi che funzionino correttamente. Considerare la possibilità di aggiungere codice personalizzato che disabiliti i controlli che non si comportano nel modo previsto.
In alternativa, è possibile impostare la proprietà ShowInspectorRead dell'area del modulo su False. In tal modo, l'area del modulo non può essere utilizzata nel riquadro di lettura.
Utilizzo di dimensioni ottimali delle icone
È possibile specificare le icone che si desidera visualizzare nell'area del modulo impostando le proprietà delle icone nel gruppo di proprietà Icone della finestra Proprietà. Utilizzare le seguenti linee guida per ottenere la migliore qualità visiva:
Per l'icona Pagina utilizzare un file Portable Network Graphics (PNG).
Le icone Finestra devono presentare dimensioni di 32 per 32 pixel.
Tutte le altre icone devono presentare dimensioni di 16 per 16 pixel.
L'icona Pagina viene visualizzata nella barra multifunzione di un controllo per gli elementi che dispongono di aree di modulo separate, di sostituzione o di sostituzione completa.
L'icona Finestra viene mostrata nell'area di notifica e nella finestra di dialogo visualizzata quando si preme ALT+TAB per gli elementi aperti contenenti aree di modulo di sostituzione o di sostituzione completa.
Vedere anche
Attività
Procedura dettagliata: progettazione di un'area del modulo di Outlook
Procedura: aggiungere un'area del modulo a un progetto di componente aggiuntivo per Outlook
Concetti
Accesso a un'area del modulo in fase di esecuzione
Associazione di un'area del modulo a una classe messaggio di Outlook