Cenni preliminari sul modello a oggetti di Outlook

Per sviluppare componenti aggiuntivi per Microsoft Office Outlook, è possibile interagire con gli oggetti forniti dal modello a oggetti di Outlook. Questo modello fornisce classi e interfacce che rappresentano gli elementi nell'interfaccia utente. Ad esempio, l'oggetto Application rappresenta l'intera applicazione, l'oggetto MAPIFolder rappresenta una cartella contenente messaggi di posta elettronica o altri elementi e l'oggetto MailItem rappresenta un messaggio di posta elettronica.

In questo argomento viene fornita una breve panoramica di alcuni degli oggetti principali del modello a oggetti di Outlook. Per risorse con ulteriori informazioni sull'intero modello a oggetti di Outlook, vedere Utilizzo della documentazione sul modello a oggetti 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.

Per una dimostrazione video correlata, vedere la procedura relativa all'utilizzo di Outlook per creare un rapporto sulle attività personalizzato.

Accesso agli oggetti in un progetto Outlook

In Outlook sono disponibili numerosi oggetti con cui è possibile interagire. Per utilizzare efficacemente il modello a oggetti, è necessario conoscere i seguenti oggetti di livello superiore:

• Application

• Explorer

• Inspector

• MAPIFolder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Oggetto Application

L'oggetto Application rappresenta l'applicazione Outlook ed è l'oggetto di livello più alto nel modello a oggetti di Outlook. Alcuni dei membri più importanti di questo oggetto includono:

• Il metodo CreateItem che può essere utilizzato per creare un nuovo elemento, ad esempio un messaggio di posta elettronica, un'attività o un appuntamento.

• La proprietà Explorers, che può essere utilizzata per accedere alle finestre in cui viene visualizzato il contenuto di una cartella nell'interfaccia utente (UI) di Outlook.

• La proprietà Inspectors, che può essere utilizzata per accedere alle finestre in cui viene visualizzato il contenuto di un singolo elemento, ad esempio un messaggio di posta elettronica o una convocazione riunione.

Per ottenere un'istanza dell'oggetto Application, utilizzare il campo Application della classe ThisAddIn nel progetto. Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione.

Nota

Per evitare gli avvisi di sicurezza quando si utilizzano proprietà e metodi bloccati dalla protezione del modello a oggetti di Outlook, ottenere oggetti Outlook dal campo Application della classe ThisAddIn. Per ulteriori informazioni, vedere Considerazioni specifiche sulla sicurezza per le soluzioni Office.

Oggetto Explorer

L'oggetto Explorer rappresenta una finestra in cui viene visualizzato il contenuto di una cartella che include elementi quali messaggi di posta elettronica, attività o appuntamenti. Nell'oggetto Explorer sono inclusi metodi e proprietà che possono essere utilizzati per modificare la finestra, nonché eventi che vengono generati quando la finestra viene modificata.

Per ottenere un oggetto Explorer, effettuare una delle seguenti operazioni:

• Utilizzare la proprietà Explorers dell'oggetto Application per accedere a tutti gli oggetti Explorer disponibili in Outlook.

• Utilizzare il metodo ActiveExplorer dell'oggetto Application per ottenere l'oggetto Explorer correntemente attivo.

• Utilizzare il metodo GetExplorer dell'oggetto MAPIFolder per ottenere l'oggetto Explorer della cartella corrente.

Oggetto Inspector

L'oggetto Inspector rappresenta una finestra in cui viene visualizzato un singolo elemento, ad esempio un messaggio di posta elettronica, un'attività o un appuntamento. Nell'oggetto Inspector sono inclusi metodi e proprietà che possono essere utilizzati per modificare la finestra, nonché eventi che vengono generati quando la finestra viene modificata.

Per ottenere un oggetto Inspector, effettuare una delle seguenti operazioni:

• Utilizzare la proprietà Inspectors dell'oggetto Application per accedere a tutti gli oggetti Inspector disponibili in Outlook.

• Utilizzare il metodo ActiveInspector dell'oggetto Application per ottenere l'oggetto Inspector correntemente attivo.

• Utilizzare il metodo GetInspector di un elemento specifico, ad esempio MailItem o AppointmentItem, per recuperare il controllo a esso associato.

Oggetto MAPIFolder

L'oggetto MAPIFolder rappresenta una cartella contenente messaggi di posta elettronica, contatti, attività e altri elementi. In Outlook sono disponibili 16 oggetti MAPIFolder predefiniti.

Gli oggetti MAPIFolder predefiniti sono specificati dai valori di enumerazione OlDefaultFolders. Di seguito è riportato un esempio:

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox corrisponde alla cartella Posta in arrivo di Outlook.

Per un esempio in cui venga illustrato come accedere a un oggetto MAPIFolder predefinito e creare un nuovo oggetto MAPIFolder, vedere Procedura: creare cartelle personalizzate.

Oggetto MailItem

L'oggetto MailItem rappresenta un messaggio di posta elettronica. Gli oggetti MailItem sono in genere suddivisi in cartelle, ad esempio Posta in arrivo, Posta inviata e Posta in uscita. La classe MailItem espone proprietà e metodi che possono essere utilizzati per creare e inviare messaggi di posta elettronica.

Per un esempio in cui venga illustrato come creare un messaggio di posta elettronica, vedere Procedura: creare un elemento di posta elettronica.

Oggetto AppointmentItem

L'oggetto AppointmentItem rappresenta un appuntamento occasionale o ricorrente oppure una riunione contenuta nella cartella Calendario. Nell'oggetto AppointmentItem sono inclusi metodi che eseguono azioni quali la risposta o l'inoltro di convocazioni riunione e proprietà che specificano i dettagli delle riunioni, ad esempio il luogo e l'ora.

Per un esempio in cui venga illustrato come creare un appuntamento, vedere Procedura: creare una convocazione riunione.

Oggetto TaskItem

L'oggetto TaskItem rappresenta un'attività da eseguire in un intervallo di tempo specificato. Gli oggetti TaskItem si trovano nella cartella Attività.

Per creare un'attività, utilizzare il metodo CreateItem dell'oggetto Application e passare il valore olTaskItem per il parametro.

Oggetto ContactItem

L'oggetto ContactItemrappresenta un contatto della cartella Contatti. Gli oggetti ContactItem contengono una varietà di informazioni sui contatti per le persone che rappresentano, ad esempio indirizzi postali, indirizzi di posta elettronica e numeri telefonici.

Per un esempio in cui venga illustrato come creare un nuovo contatto, vedere Procedura: aggiungere una voce ai contatti di Outlook. Per un esempio in cui venga illustrato come cercare un contatto esistente, vedere Procedura: eseguire la ricerca di un contatto specifico.

Utilizzo della documentazione sul modello a oggetti di Outlook

Per informazioni complete sul modello a oggetti di Outlook, vedere la documentazione di riferimento degli assembly di interoperabilità primari di Outlook e del modello a oggetti di VBA.

Riferimento all'assembly di interoperabilità primario

Nella documentazione di riferimento degli assembly di interoperabilità primari (PIA) di Outlook sono descritti i tipi di assembly di interoperabilità primari per Outlook 2010 e Outlook 2007. Questa documentazione è disponibile dai seguenti percorsi:

• Riferimento all'assembly di interoperabilità primario di Outlook 2010

• Riferimento all'assembly di interoperabilità primario di Outlook 2007

Oltre a fornire informazioni per tutti i tipi negli assembly di interoperabilità primari, questa documentazione fornisce informazioni aggiuntive sulla struttura degli assembly di interoperabilità primari ed esempi di codice per le attività di automazione comuni di Outlook.

Riferimento del modello a oggetti di VBA

Nella documentazione di riferimento del modello a oggetti di VBA viene illustrato il modello a oggetti di Outlook e come viene esposto al codice Visual Basic, Applications Edition (VBA). La documentazione di riferimento del modello a oggetti di VBA per Outlook è disponibile nei percorsi seguenti:

• Riferimento del modello a oggetti di Outlook 2010

• Riferimento del modello a oggetti di Outlook 2007

Tutti gli oggetti e i membri nel riferimento del modello a oggetti di VBA corrispondono a tipi e membri nell'assembly di interoperabilità primario (PIA) di Outlook. Ad esempio, l'oggetto Inspector nel riferimento del modello a oggetti di VBA corrisponde all'oggetto Microsoft.Office.Interop.Outlook.Inspector nell'assembly di interoperabilità primario (PIA) di Outlook. Sebbene il riferimento del modello a oggetti di VBA fornisca esempi di codice per la maggior parte delle proprietà, dei metodi e degli eventi, è necessario convertire il codice VBA in questo riferimento a Visual Basic o a Visual C# se si desidera utilizzarli in un progetto di componente aggiuntivo di Outlook creato mediante Visual Studio.

Argomenti correlati

Titolo	Descrizione
Utilizzo dei contatti	Vengono forniti argomenti che illustrano come eseguire attività con i contatti.
Utilizzo degli elementi di posta	Vengono forniti argomenti che illustrano come eseguire attività con elementi di posta elettronica.
Utilizzo delle cartelle	Vengono forniti argomenti che illustrano come eseguire attività con cartelle.
Utilizzo degli elementi di calendario	Vengono forniti argomenti che illustrano come eseguire attività con elementi del calendario.
Procedura: aggiungere Windows Form a soluzioni Outlook	Viene illustrato come aggiungere un Windows Form a un progetto Microsoft Office Outlook e visualizzare il form all'utente.
Procedura: leggere dati da un campo personalizzato di un elemento	Viene illustrato come leggere i dati da un campo personalizzato di un elemento contatto.
Procedura: determinare la cartella padre che contiene elementi non salvati	Viene illustrato come determinare l'oggetto MAPIFolder padre di un elemento contatto non salvato.
Procedura: determinare l'elemento corrente di Outlook	Viene illustrato come visualizzare il nome della cartella corrente e alcune informazioni sull'elemento selezionato.

Cronologia delle modifiche

Data	Cronologia	Motivo
Maggio 2010	Aggiornamento delle informazioni sulla documentazione di riferimento del modello a oggetti.	Miglioramento delle informazioni.