Общие сведения об объектной модели Outlook

Для разработки надстроек для Microsoft Office Outlook необходимо взаимодействие с объектами, предоставленными объектной моделью Outlook.Объектная модель Outlook предоставляет классы и интерфейсы для представления элементов пользовательского интерфейса.Например, объект Application представляет целое приложение, объект MAPIFolder — папку, содержащую сообщения электронной почты или иные элементы, а объект MailItem — сообщение электронной почты.

В этом разделе представлен краткий обзор некоторых основных объектов объектной модели Outlook.Список документации для более глубокого изучения всей объектной модели Outlook см. в разделе Использование документации по объектной модели Outlook.

Применение. Сведения этого раздела применяются к проектам уровня приложения для Outlook 2013 и Outlook 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

Для просмотра связанных демонстрационных видеороликов перейдите по ссылке How Do I: Use Outlook to Create a Custom Task Report?.

Доступ к объектам в проекте Outlook

В Outlook предоставляется множество объектов, с которыми можно взаимодействовать.Для эффективного использования объектной модели необходимо знать следующие объекты верхнего уровня:

• Application

• Explorer

• Inspector

• MAPIFolder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Объект приложения

Объект Application представляет приложение Outlook и является объектом самого верхнего уровня в объектной модели Outlook.К некоторым наиболее важным элементам этого объекта относятся следующие.

• метод CreateItem, который может использоваться для создания нового элемента, такого как сообщение электронной почты, задача или встреча;

• свойство Explorers, которое может использоваться для доступа к окнам, в которых отображается содержимое папки в пользовательском интерфейсе Outlook;

• свойство Inspectors, которое может использоваться для доступа к окнам, в которых отображается содержимое отдельного элемента, такого как сообщение электронной почты или приглашение на собрание.

Чтобы получить экземпляр объекта Application, используйте поле Application класса ThisAddIn в проекте.Дополнительные сведения см. в разделе Программирование надстроек уровня приложения.

Примечание
Во избежание получения предупреждений безопасности при использовании свойств и методов, блокируемых системой безопасности объектной модели Outlook, следует получать объекты Outlook от поля Application класса ThisAddIn.Дополнительные сведения см. в разделе Рекомендации по обеспечению безопасности для решений Office.

Объект проводника

Объект Explorer представляет окно, в котором отображается содержимое папки, содержащей элементы, например сообщения электронной почты, задачи или встречи.Объект Explorer включает методы и свойства, которые могут использоваться для изменения окна и события при изменении окна.

Чтобы получить объект Explorer, можно воспользоваться одним из следующих способов.

• Используйте свойство Explorers объекта Application для доступа ко всем объектам Explorer в Outlook.

• Используйте метод ActiveExplorer объекта Application для получения объекта Explorer, в котором в данный момент находится фокус.

• Используйте метод GetExplorer объекта MAPIFolder для получения объекта Explorer для текущей папки.

Объект инспектора

Объект Inspector представляет окно, в котором отображается отдельный элемент, например сообщение электронной почты, задача или встреча.Объект Inspector включает методы и свойства, которые могут использоваться для изменения окна и события при изменении окна.

Чтобы получить объект Inspector, можно воспользоваться одним из следующих способов.

• Используйте свойство Inspectors объекта Application для доступа ко всем объектам Inspector в Outlook.

• Используйте метод ActiveInspector объекта Application для получения объекта Inspector, в котором в данный момент находится фокус.

• Для извлечения инспектора, связанного с элементом, таким как MailItem или AppointmentItem, используется метод GetInspector данного элемента.

Объект MAPIFolder

Объект MAPIFolder представляет папку, содержащую элементы, например сообщения электронной почты, контакты, задачи и т.п.В Outlook предоставляется 16 объектов MAPIFolder по умолчанию.

Объекты MAPIFolder по умолчанию определяются значениями перечисления OlDefaultFolders.Например:

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox соответствует папке Входящие в Outlook.

Пример, иллюстрирующий способ доступа к объекту MAPIFolder по умолчанию и создания нового объекта MAPIFolder, см. в разделе Практическое руководство. Программное создание настраиваемых элементов папок.

Объект MailItem

Объект MailItem представляет сообщение электронной почты.Объекты MailItem обычно расположены в папках, таких как Входящие, Отправленные и Исходящие.Класс MailItem предоставляет свойства и методы, которые можно использовать для создания и отправки сообщений электронной почты.

Пример создания сообщения электронной почты см. в разделе Практическое руководство. Программное создание элемента электронной почты.

Объект AppointmentItem

Объект AppointmentItem представляет однократную или повторяющуюся встречу в папке Календарь.Объект AppointmentItem включает методы для выполнения таких действий, как ответ или пересылка приглашений на встречу, и свойства, определяющие подробности встречи, например время и место.

Пример создания встречи см. в разделе Практическое руководство. Программное создание приглашения на собрание.

Объект TaskItem

Объект TaskItem представляет задачу, которая должна быть выполнена в указанный отрезок времени.Объекты TaskItem расположены в папке Задачи.

Чтобы создать задачу, воспользуйтесь методом CreateItem объекта Application, передав ему в качестве параметра значение olTaskItem.

Объект ContactItem

Объект ContactItem представляет контакт в папке Контакты.Объекты ContactItem содержат различные сведения о людях, которых они представляют, например почтовый адрес, адреса электронной почты и телефонные номера.

Пример создания нового контакта см. в разделе Практическое руководство. Программное добавление записи в контакты Outlook.Пример поиска существующего контакта см. в разделе Практическое руководство. Программный поиск определенного контакта.

Использование документации по объектной модели Outlook

Полные сведения об объектной модели Outlook см. в справочнике по основной сборке взаимодействия (PIA) Outlook и справочнике по объектной модели VBA.

Документация по основной сборке взаимодействия

Документы ссылки PIA outlook типы в основных сборках взаимодействия для outlook 2010.Дополнительные сведения см. в разделе Справочник по основным сборкам взаимодействия outlook 2010.

Помимо информации обо всех типах в основных сборках взаимодействия эта документация предоставляет дополнительные сведения о структуре основных сборок взаимодействия и примеры кода основных задач автоматизации Outlook.

Справка по объектной модели VBA

В справочных документах по объектной модели VBA объектная модель Outlook описана в том виде, в котором она предоставляется коду Visual Basic для приложений.Дополнительные сведения см. в разделе Справочник по объектной модели outlook 2010.

Все объекты и участники справочника объектной модели VBA соответствуют типам и участникам основной сборки взаимодействия Outlook.Например, объект Inspector в справочнике по объектной модели VBA соответствует объекту Microsoft.Office.Interop.Outlook.Inspector в основной сборке взаимодействия Outlook.Хотя в справочнике по объектной модели VBA содержатся примеры кода для большинства свойств, методов и событий, необходимо преобразовать код VBA в этом справочнике в код Visual Basic или Visual C#, если требуется использовать их в проекте надстройки Outlook, создаваемом с помощью Visual Studio.

Связанные разделы

Заголовок	Описание
Работа с элементами контактов	Разделы о выполнении различных задач с контактами.
Работа с элементами почты	Разделы о выполнении различных задач с элементами почты.
Работа с папками	Разделы о выполнении различных задач с папками.
Работа с элементами календаря	Разделы о выполнении различных задач с элементами календаря.
Практическое руководство. Программное определение текущего элемента Outlook	Описание способов отображения имени текущей папки и некоторых сведений о выбранном элементе.