Элемент управления сообщениями MAPI

После того как с помощью элемента управления 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. Многие операции системы передачи сообщений допустимы только в буфере ре актирования, например посылка сообщений, посылка сообщений из диалогового окна, сохранение сообщений, удаление получателей и присоединений.