Información general sobre el modelo de objetos de Outlook

Artículo
04/28/2010

Actualización: noviembre 2007

Para desarrollar complementos para Microsoft Office Outlook, puede interactuar con los objetos suministrados por el modelo de objetos de Outlook. El modelo de objetos de Outlook proporciona clases que representan elementos de la interfaz de usuario. Por ejemplo, la clase Application representa la aplicación completa, la clase MAPIFolder representa una carpeta que contiene mensajes de correo electrónico u otros elementos y la clase MailItem representa un mensaje de correo electrónico.

Este tema proporciona una descripción breve de algunas de las clases principales del modelo de objetos de Outlook. Para obtener la documentación completa del modelo de objetos de Outlook, vea las secciones de MSDN Outlook 2007 Developer Reference y Welcome to the Microsoft Office Outlook 2003 VBA Language Reference.

Obtener acceso a objetos en un proyecto de Outlook

Outlook proporciona muchas clases con las que se puede interactuar. Para utilizar el modelo de objetos de forma eficaz, debe estar familiarizado con las siguientes clases de nivel superior:

Application (Clase)

La clase Application representa la aplicación de Outlook y es la clase de nivel superior del modelo de objetos de Outlook. Algunos de los miembros más importantes de esta clase incluyen:

El método CreateItem, que se puede utilizar para crear un nuevo elemento, como un mensaje de correo electrónico, una tarea o una cita.
La propiedad Explorers, que se puede utilizar para obtener acceso a las ventanas que muestran el contenido de una carpeta en la interfaz de usuario de Outlook.
La propiedad Inspectors, que se puede utilizar para obtener acceso a las ventanas que muestran el contenido de un único elemento, como un mensaje de correo electrónico o una convocatoria de reunión.

Para obtener una instancia de la clase Application, utilice la propiedad Application de la clase ThisAddin.

Clase ThisAddIn

Cuando se crea un nuevo proyecto de complemento de Outlook, Visual Studio Tools para Office crea automáticamente un archivo de código ThisAddIn.vb o ThisAddIn.cs en el nuevo proyecto. Este archivo de código define una clase ThisAddin que hereda de OutlookAddIn. Puede obtener acceso a los miembros de la clase OutlookAddIn si utiliza las palabras clave Me (en Visual Basic) o this (en C#) en la clase ThisAddIn. El código que está fuera de la clase ThisAddIn puede obtener acceso al objeto ThisAddIn mediante la propiedad estática Globals.ThisAddIn.

Nota:
Para evitar las advertencias de seguridad cuando utiliza propiedades y métodos que están bloqueados por el guardián del modelo de objetos de Outlook, obtenga los objetos de Outlook del objeto ThisAddIn. Para obtener más información, vea Consideraciones de seguridad específicas para soluciones de Office.

Explorer (Clase)

La clase Explorer representa una ventana que muestra el contenido de una carpeta que contiene elementos, como por ejemplo, mensajes de correo electrónico, tareas o citas. La clase Explorer incluye métodos y propiedades, que se pueden utilizar para modificar la ventana, y eventos que se generan cuando la ventana cambia.

Para obtener un objeto Explorer, realice una de las siguientes operaciones:

Utilice la propiedad Explorers de la clase Application para obtener acceso a todos los objetos Explorer en Outlook.
Utilice el método ActiveExplorer de la clase Application para obtener el objeto Explorer que tenga el foco actualmente.
Utilice el método GetExplorer de la clase MAPIFolder para obtener el objeto Explorer de la carpeta actual.

Inspector (Clase)

La clase Inspector representa una ventana que muestra un único elemento, como por ejemplo, un mensaje de correo electrónico, una tarea o una cita. La clase Inspector incluye métodos y propiedades, que se pueden utilizar para modificar la ventana, y eventos que se generan cuando la ventana cambia.

Para obtener un objeto Inspector, realice una de las siguientes operaciones:

Utilice la propiedad Inspectors de la clase Application para obtener acceso a todos los objetos Inspector en Outlook.
Utilice el método ActiveInspector de la clase Application para obtener el objeto Inspector que tenga el foco actualmente.
Utilice el método GetInspector de un elemento específico, como por ejemplo, un elemento MailItem o AppointmentItem, para recuperar el inspector que tiene asociado.

MAPIFolder (Clase)

La clase MAPIFolder representa una carpeta que contiene mensajes de correo electrónico, contactos, tareas y otros elementos. Outlook proporciona 16 objetos MAPIFolder predeterminados.

Los valores de enumeración OlDefaultFolders definen los objetos MAPIFolder predeterminados. Por ejemplo,

T:Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox corresponde a la carpeta Bandeja de entrada de Outlook.

Para obtener un ejemplo que muestre cómo tener acceso a un objeto MAPIFolder predeterminado y crear un nuevo objeto MAPIFolder, vea Cómo: Crear elementos de carpeta personalizados.

MailItem (Clase)

La clase MailItem representa un mensaje de correo electrónico. Los objetos MailItem suelen encontrarse en carpetas, como por ejemplo, Bandeja de entrada, Elementos enviados y Bandeja de salida. MailItem expone propiedades y métodos que se pueden utilizar para crear y enviar mensajes de correo electrónico.

Para obtener un ejemplo que muestre cómo crear un mensaje de correo electrónico, vea Cómo: Crear un elemento de correo electrónico.

AppointmentItem (Clase)

La clase AppointmentItem representa una reunión, una cita única o bien una reunión o cita periódicas en la carpeta Calendario. La clase AppointmentItem incluye métodos que realizan acciones, como responder o reenviar convocatorias de reunión, y propiedades que especifican los detalles de la reunión, como su ubicación y hora.

Para obtener un ejemplo que muestre cómo crear una cita, vea Cómo: Crear una convocatoria de reunión.

TaskItem (Clase)

La clase TaskItem representa una tarea que se va a realizar en un margen de tiempo especificado. Los objetos TaskItem se encuentran en la carpeta Tareas.

Para crear una tarea, utilice el método CreateItem de la clase Application y pase el valor olTaskItem para el parámetro.

ContactItem (Clase)

La clase ContactItemrepresenta un contacto en la carpeta Contactos. Los objetos ContactItem contienen información de contacto de diversa índole para las personas a las que representan, como por ejemplo, domicilio, direcciones de correo electrónico y números de teléfono.

Para obtener un ejemplo que muestre cómo crear un nuevo contacto, vea Cómo: Agregar una entrada a los contactos de Outlook. Para obtener un ejemplo que muestre cómo buscar un contacto existente, vea Cómo: Buscar un contacto específico.

Usar la documentación del modelo de objetos de Outlook

Para obtener información sobre las clases que se pueden utilizar en el modelo de objetos de Outlook, vea los siguientes conjuntos de documentación:

El primer vínculo proporciona información sobre las clases e interfaces en el ensamblado de interoperabilidad primario de Outlook. Los otros vínculos proporcionan información sobre el modelo de objetos de Outlook tal como se expone al código de Visual Basic para Aplicaciones (VBA). Cada conjunto de documentación presenta ventajas y desventajas para los programadores que utilizan Visual Studio Tools para Office.

Referencia del ensamblado de interoperabilidad primario

En esta documentación se describen todos los tipos del ensamblado de interoperabilidad primario de Outlook que se pueden utilizar en los proyectos de Visual Studio Tools para Office:

Describe los tipos del ensamblado de interoperabilidad primario para Outlook 2007. Por consiguiente, si está desarrollando un complemento de Outlook 2003, no podrá utilizar algunas de las clases y miembros que aparecen en esta documentación. Para obtener descripciones de los tipos y miembros disponibles para Outlook 2003, vea la referencia de lenguaje VBA de Microsoft Office Outlook 2003.
Actualmente no se proporciona ningún ejemplo de código.

Referencia de VBA

Todos los objetos y miembros en la referencia de VBA corresponden a las clases y los miembros del ensamblado de interoperabilidad primario que se utilizan en los proyectos de Visual Studio Tools para Office. Por ejemplo, el objeto Inspector de la documentación de VBA para Outlook corresponde a la clase Microsoft.Office.Interop.Outlook.Inspector en el ensamblado de interoperabilidad primario.

La referencia de VBA presenta las ventajas siguientes:

Proporciona ejemplos de código para la mayoría de los miembros.

La referencia de VBA presenta las desventajas siguientes:

Sólo proporciona sintaxis y ejemplos de código para VBA. Para usar los ejemplos de código en un proyecto de Visual Studio Tools para Office, debe traducir el código de VBA a Visual Basic o Visual C#.

Tipos adicionales en los ensamblados de interoperabilidad primarios

Los ensamblados de interoperabilidad primarios contienen muchos tipos que no están disponibles para VBA. Estos tipos adicionales ayudan a convertir los objetos del modelo de objetos basado en COM de Outlook a código administrado; no están pensados para usarlos directamente en el código.

Para obtener más información, vea Architecture of the Outlook PIA.