Información general sobre el modelo de objetos de Outlook
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 e interfaces que representan elementos de la interfaz de usuario. Por ejemplo, el objeto Application representa la aplicación completa, el objeto MAPIFolder representa una carpeta que contiene mensajes de correo electrónico u otros elementos y el objeto MailItem representa un mensaje de correo electrónico.
Este tema proporciona una descripción breve de algunos de los objetos principales del modelo de objetos de Outlook. Para conocer los recursos donde puede obtener más información sobre el modelo de objetos de Outlook completo, 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 nivel de aplicación para Outlook 2007 y Outlook 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.
.gif "vínculo a vídeo")
Dispone de una demostración en vídeo relacionada en How Do I: Use Outlook to Create a Custom Task Report?.
Obtener acceso a objetos en un proyecto de Outlook
Outlook proporciona muchos objetos con los que se puede interactuar. Para utilizar el modelo de objetos de forma eficaz, debe estar familiarizado con los siguientes objetos de nivel superior:
Objeto Application
El objeto Application representa la aplicación de Outlook y es el objeto de nivel superior del modelo de objetos de Outlook. Algunos de los miembros más importantes de este objeto 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 del objeto Application, utilice el campo Application de la clase ThisAddIn del proyecto. Para obtener más información, vea Programar complementos de nivel de aplicación.
Nota
Para evitar las advertencias de seguridad cuando utilice propiedades y métodos que están bloqueados por la protección del modelo de objetos de Outlook, obtenga los objetos de Outlook en el campo Application de la clase ThisAddIn. Para obtener más información, vea Consideraciones de seguridad específicas para soluciones de Office.
Objeto Explorer
El objeto 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. El objeto 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 del objeto Application para obtener acceso a todos los objetos Explorer en Outlook.
Utilice el método ActiveExplorer del objeto Application para obtener el objeto Explorer que tenga el foco actualmente.
Utilice el método GetExplorer del objeto MAPIFolder para obtener el objeto Explorer de la carpeta actual.
Objeto Inspector
El objeto Inspector representa una ventana que muestra un único elemento, como por ejemplo, un mensaje de correo electrónico, una tarea o una cita. El objeto 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 del objeto Application para obtener acceso a todos los objetos Inspector en Outlook.
Utilice el método ActiveInspector del objeto 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.
Objeto MAPIFolder
El objeto 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,
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.
Objeto MailItem
El objeto MailItem representa un mensaje de correo electrónico. Los objetos MailItem normalmente están en carpetas, como Bandeja de entrada, Elementos enviados y Bandeja de salida. MailItem expone las propiedades y los métodos que se pueden usar 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.
Objeto AppointmentItem
El objeto AppointmentItem representa una reunión, una cita única o bien una reunión o cita periódicas 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 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.
Objeto TaskItem
El objeto TaskItem representa una tarea que se va a realizar en un intervalo de tiempo especificado. Los objetos TaskItem se encuentran en la carpeta Tareas.
Para crear una tarea, utilice el método CreateItem del objeto Application y pase el valor olTaskItem para el parámetro.
Objeto ContactItem
El objeto ContactItem representa un contacto de la carpeta Contactos. Los objetos ContactItem contienen información de contacto diversa para las personas que representan, como direcciones postales, 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 completa sobre el modelo de objetos de Outlook, puede consultar la referencia del ensamblado de interoperabilidad primario de Outlook (PIA) y a la referencia del modelo de objetos de VBA.
Referencia del ensamblado de interoperabilidad primario
La referencia de PIA de Outlook documenta los tipos de los ensamblados de interoperabilidad primarios de Outlook 2010 y Outlook 2007. Esta documentación está disponible en las siguientes ubicaciones:
Referencia del ensamblado de interoperabilidad primario de Outlook 2010
Referencia del ensamblado de interoperabilidad primario de Outlook 2007
Además de proporcionar información sobre 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 las 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). La referencia del modelo de objetos de VBA para Outlook está disponible en las siguientes ubicaciones:
Todos los objetos y miembros de la referencia del modelo de objetos de VBA corresponden a tipos y miembros del ensamblado de interoperabilidad primario de Outlook. Por ejemplo, el objeto Inspector de la referencia del modelo de objetos de VBA corresponde al objeto Microsoft.Office.Interop.Outlook.Inspector 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, métodos y eventos, debe convertir el código de VBA de esta referencia a Visual Basic o Visual C# si desea utilizarlos en un proyecto de complemento de Outlook que cree mediante Visual Studio.
Temas relacionados
Título |
Descripción |
|---|---|
Proporciona temas que muestran cómo realizar tareas con contactos. |
|
Proporciona temas que muestran cómo realizar tareas con elementos de correo. |
|
Proporciona temas que muestran cómo realizar tareas con carpetas. |
|
Proporciona temas que muestran cómo realizar tareas con elementos de calendario. |
|
Cómo: Agregar formularios Windows Forms a soluciones de Outlook |
Explica cómo agregar un formulario de Windows a un proyecto de Microsoft Office Outlook y mostrar el formulario al usuario. |
Muestra cómo leer datos de un campo personalizado de un elemento de contacto. |
|
Cómo: Determinar la carpeta primaria de elementos no guardados |
Muestra cómo determinar el MAPIFolder primario de un elemento de contacto no guardado. |
Indica cómo mostrar el nombre de la carpeta actual y alguna información sobre el elemento seleccionado. |
Historial de cambios
Fecha |
Historial |
Motivo |
|---|---|---|
|
Mayo de 2010 |
Se ha actualizado la información sobre la documentación de referencia del modelo de objetos. |
Mejora de la información. |