Introducción al modelo de objetos de Outlook

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

En este tema se proporciona una breve introducción de 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 complementos de VSTO para Outlook. Para obtener más información, consulte Características disponibles por aplicación de Office lication 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 objeto Application representa la aplicación Outlook y es el objeto de nivel superior 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 propiedad Explorers , que puede usar para acceder a las ventanas que muestran el contenido de una carpeta en la interfaz de usuario (UI) de Outlook.

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

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

Nota:

Para evitar advertencias de seguridad al usar propiedades y métodos bloqueados por la protección del modelo de objetos de Outlook, obtenga objetos de Outlook del campo Aplicación de la ThisAddIn clase . Para obtener más información, vea Consideraciones de seguridad específicas para las soluciones de Office.

Explorer (objeto)

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

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

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

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

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

Inspector (objeto)

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

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

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

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

• Use el método GetInspector de un determinado elemento, como un MailItem o AppointmentItem, para recuperar el Inspector que está asociado a él.

Folder (objeto)

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

Los objetos Folder predeterminados se definen mediante los valores de enumeración OlDefaultFolders . 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.

MailItem (objeto)

El objeto MailItem representa un mensaje de correo electrónico. Los objetosMailItem normalmente están en carpetas, como Bandeja de entrada, Elementos enviadosy 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 objeto AppointmentItem representa una reunión, una cita única o una reunión o cita periódica en la carpeta Calendario . El objeto 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 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 objeto TaskItem representa una tarea que debe realizarse dentro de un período de tiempo especificado. Los objetosTaskItem se encuentran en la carpeta Tareas .

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

ContactItem (objeto)

El objeto ContactItemrepresenta un contacto de la carpeta Contactos . Los objetosContactItem contienen una gran variedad de información de contacto de 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 referencia de PIA de Outlook documenta los tipos en 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 de todos los tipos de los PIA, esta documentación proporciona información adicional acerca de la estructura de los PIA y ejemplos de código de tareas comunes de automatización de Outlook.

Referencia del modelo de objetos de VBA

La referencia del 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 VBA proporciona ejemplos de código para la mayoría de las propiedades, métodos y eventos, debe traducir el código VBA de esta referencia a Visual Basic o Visual C# si quiere usarlo en un proyecto de complemento de VSTO de Outlook creado con Visual Studio.

Temas relacionados

Title	Descripción
Trabajar con elementos de contacto	Proporciona temas que muestran cómo realizar tareas con los contactos.
Trabajar con elementos de correo	Proporciona temas que muestran cómo realizar tareas con los elementos de correo.
Trabajar con carpetas	Proporciona temas que muestran cómo realizar tareas con carpetas.
Trabajar con elementos de calendario	Proporciona temas que muestran cómo realizar tareas con elementos del calendario.
Cómo: Determinar mediante programación el elemento actual de Outlook	Muestra cómo mostrar el nombre de la carpeta actual y alguna información sobre el elemento seleccionado.