Introducción al modelo de objetos de Outlook

Para desarrollar complementos VSTO para Microsoft Office Outlook, puede interactuar con los objetos proporcionados por el modelo de objetos de Outlook. El modelo de objetos de Outlook proporciona clases e interfaces que representan elementos en la interfaz de usuario. Por ejemplo, el Application objeto representa toda la aplicación, el Folder objeto representa una carpeta que contiene mensajes de correo electrónico u otros elementos, y el MailItem objeto representa un mensaje de correo electrónico.

En este tema se proporciona una breve introducción a algunos de los objetos principales del modelo de objetos de Outlook. Para obtener más información sobre todo el modelo de objetos de Outlook, vea Usar la documentación del modelo de objetos de Outlook.

Se aplica a: La información de este tema se aplica a los proyectos de complemento de VSTO para Outlook. Para obtener más información, vea Características disponibles por aplicación de Office y tipo de proyecto.

Obtener acceso a objetos en un proyecto de Outlook

Outlook proporciona muchos objetos con los que puede interactuar. Para usar el modelo de objetos de forma eficaz, debe estar familiarizado con los siguientes objetos de nivel superior:

• Application

• Explorer

• Inspector

• Folder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Objeto de aplicación

El Application objeto representa la aplicación de Outlook y es el objeto de nivel más alto en el modelo de objetos de Outlook. Algunos de los miembros más importantes de este objeto son:

• El método CreateItem que puede usar para crear un nuevo elemento, como un mensaje de correo electrónico, una tarea o una cita.

• La Explorers propiedad , que puede usar para acceder a las ventanas que muestran el contenido de una carpeta en la interfaz de usuario (UI) de Outlook.

• La Inspectors propiedad , que puede usar para acceder a las ventanas que muestran el contenido de un solo elemento, como un mensaje de correo electrónico o una convocatoria de reunión.

  Para obtener una instancia del objeto Application, use el campo Application de la clase ThisAddIn en su proyecto. Para obtener más información, consulte Complementos del programa VSTO.

Objeto Explorer

El Explorer objeto representa una ventana que muestra el contenido de una carpeta que contiene elementos como mensajes de correo electrónico, tareas o citas. El Explorer objeto incluye métodos y propiedades que puede usar para modificar la ventana y los eventos que se generan cuando cambia la ventana.

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

• Use la Explorers propiedad del Application objeto para tener acceso a todos los Explorer objetos de Outlook.

• Use el ActiveExplorer método del Application objeto para obtener el Explorer objeto que tiene el foco actualmente.

• Usa el método GetExplorer del objeto Folder para obtener el Explorer de la carpeta actual.

Objeto Inspector

El Inspector objeto representa una ventana que muestra un solo elemento, como un mensaje de correo electrónico, una tarea o una cita. El Inspector objeto incluye métodos y propiedades que puede usar para modificar la ventana y los eventos que se generan cuando cambia la ventana.

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

• Use la Inspectors propiedad del Application objeto para tener acceso a todos los Inspector objetos de Outlook.

• Use el ActiveInspector método del Application objeto para obtener el Inspector objeto que tiene el foco actualmente.

• Utiliza el método GetInspector de un elemento específico, como un MailItem o AppointmentItem, para recuperar el Inspector asociado a él.

Folder (objeto)

El Folder objeto representa una carpeta que contiene mensajes de correo electrónico, contactos, tareas y otros elementos. Outlook proporciona 16 objetos predeterminados Folder .

Los objetos predeterminados Folder se definen mediante los OlDefaultFolders valores de enumeración. Por ejemplo

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

Para obtener un ejemplo que muestra cómo obtener acceso a un valor predeterminado Folder y crear un nuevo Folder, vea Cómo: Crear elementos de carpeta personalizados mediante programación.

Objeto MailItem

El MailItem objeto representa un mensaje de correo electrónico. MailItem Los objetos suelen estar en carpetas, como Bandeja de entrada, Elementos enviados y Bandeja de salida. MailItem expone propiedades y métodos que se pueden usar para crear y enviar mensajes de correo electrónico.

Para obtener un ejemplo que muestra cómo crear un mensaje de correo electrónico, vea How to: Programmatically create an email item.

AppointmentItem objeto

El AppointmentItem objeto representa una reunión, una cita única o una cita periódica o una reunión en la carpeta Calendario . El AppointmentItem objeto incluye métodos que realizan acciones como responder o reenviar solicitudes de reunión y propiedades que especifican detalles de la reunión, como la ubicación y la hora.

Para obtener un ejemplo en el que se muestra cómo crear una cita, vea How to: Programmatically create a meeting request(Cómo: Crear una convocatoria de reunión mediante programación).

TaskItem objeto

El TaskItem objeto representa una tarea que se va a realizar dentro de un período de tiempo especificado. TaskItem Los objetos se encuentran en la carpeta Tareas .

Para crear una tarea, use el método CreateItem del Application objeto y pase el valor olTaskItem del parámetro .

ContactItem (objeto)

El ContactItemobjeto representa un contacto en la carpeta Contactos . ContactItem los objetos contienen una variedad de información de contacto para las personas que representan, como direcciones postales, direcciones de correo electrónico y números de teléfono.

Para obtener un ejemplo en el que se muestra cómo crear un nuevo contacto, vea How to: Programmatically add an entry to Outlook contacts (Cómo: Agregar mediante programación una entrada a los contactos de Outlook). Para obtener un ejemplo que muestra cómo buscar un contacto existente, vea Cómo: Buscar mediante programación un contacto específico.

Usar la documentación del modelo de objetos de Outlook

Para obtener información completa sobre el modelo de objetos de Outlook, puede consultar la referencia del ensamblado de interoperabilidad primario (PIA) de Outlook y la referencia del modelo de objetos VBA.

Referencia del ensamblado de interoperabilidad principal

La documentación del PIA de Outlook describe los tipos de los ensamblados de interoperabilidad primarios para Outlook 2010. Para obtener más información, vea Referencia de ensamblado de interoperabilidad principal de Outlook 2010.

Además de proporcionar información para todos los tipos de los PIA, esta documentación también proporciona información adicional sobre la estructura de los PIA y ejemplos de código para tareas comunes de automatización de Outlook.

Referencia del modelo de objetos de VBA

El modelo de objetos de VBA documenta el modelo de objetos de Outlook tal como se expone al código de Visual Basic para Aplicaciones (VBA). Para obtener más información, vea Referencia del modelo de objetos de Outlook 2010.

Todos los objetos y miembros de la referencia del modelo de objetos de VBA corresponden a tipos y miembros del PIA de Outlook. Por ejemplo, el objeto Inspector de la referencia del modelo de objetos VBA corresponde al Inspector objeto del PIA de Outlook. Aunque la referencia del modelo de objetos de VBA proporciona ejemplos de código para la mayoría de las propiedades, los métodos y los eventos, debe traducir el código VBA en esta referencia a Visual Basic o Visual C# si quiere usarlos en un proyecto de VSTO Add-In de Outlook que cree mediante Visual Studio.

Temas relacionados