После того как с помощью элемента управления MAPI Session установлен сеанс обмена сообщениями, элемент управления MAPI может выполнять разнообразные функции системы передачи сообщений.

Синтаксис:

MapiMessages

Комментарии:
Элемент управления MAPI Messages позволяет делать следующее:

• Получать доступ к сообщениям во входном ящике пользователя.
• Составлять новое сообщение.
• Добавлять и удалять получателей сообщений и присоединений к сообщениям.
• Посылать сообщения (независимо от поддержки пользовательского интерфейса).
• Сохранять, копировать и удалять сообщения.
• Отображать диалоговое окно Address Book.
• Отображать диалоговое окно Details.
• Получать доступ к присоединениям, в том числе к присоединениям типа OLE Automation.
• Разрешать имена получателей в процессе адресования.
• Отвечать на сообщения и переадресовывать их.

Большинство свойств элемента управления MAPI Messages можно отнести к одной из четырех функциональных областей: свойства адресной книги, свойства файлов присоединений, свойства сообщений и свойства получателей. Свойства файлов присоединений, сообщений и получателей контролируются соответственно свойствами AttachmentIndex, MsgIndex и RecipIndex.

Например, при изменении значения индекса в свойстве MsgIndex изменяются и все остальные свойства сообщений, присоединений и получателей, чтобы отразить характеристики заданного сообщения. Набор свойств сообщений работает аналогично набору свойств получателей. Свойства адресной книги определяют внешний вид диалогового окна Address Book.

Буферы сообщений:

При использовании элемента управления MAPI Messages необходимо следить за двумя буферами: буфером редактирования и буфером чтения. Буфер чтения образуется из индексированного набора сообщений, выбранных из входного ящика пользователя. С помощью свойства MsgIndex можно получать доступ к отдельным сообщениям внутри этого набора, начиная с первого, которому соответствует индекс 0, и кончая последним (индекс при прохождении набора последовательно наращивается на единицу).

Набор сообщений строится с помощью метода Fetch. Такой набор включает сообщения типа, определяемого свойством FetchMsgType, и сортируется в соответствии с установкой свойства FetchSorted. Свойство FetchUnreadOnly позволяет определить, включаются ли в набор ранее прочитанные сообщения. Сообщения, находящиеся в буфере чтения, не могут быть изменены пользователем, но их можно скопировать в буфер редактирования и там изменить.

Сообщения можно создавать и редактировать в буфере редактирования. Буфер редактирования является активным, когда свойство MsgIndex имеет значение -1. Многие операции системы передачи сообщений допустимы только в буфере редактирования, например посылка сообщений, посылка сообщений из диалогового окна, сохранение сообщений, удаление получателей и присоединений.