События. Данный компонент предназначен для приема и менеджмента сообщений, хранящихся на почтовых серверах, которые взаимодействуют с клиентами по протоколу РОРЗ

Методы

Тип TSummary

Тип TMailMessage

Свойства

Назначение

Данный компонент предназначен для приема и менеджмента сообщений, хранящихся на почтовых серверах, которые взаимодействуют с клиентами по протоколу РОРЗ. Он имеет следующие основные функции:

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

Данный компонент обладает свойствами, приведенными в табл. П1.15.

Таблица П1.15. Свойства компонента NMPOPS

Свойство	Описание
AttachFilePath	Содержит название каталога, в который объекту следует помещать приложенные к письмам файлы, и путь к нему
DeleteOnRead	Включает режим удаления тех сообщений с сервера, которые были загружены на компьютер клиента
MailCount	Содержит число писем, хранящихся в почтовом ящике
MailMessage	Принадлежит к типу TMailMessage, который будет описан ниже. В нем содержится текущее сообщение, а также его параметры
Password	Содержит пароль для доступа к почтовому ящику
Summary	Представляет собой описание текущего сообщения. Подробное описание типа TSuinmary, в виде которого представлены данные, дано ниже
UserlD	Содержит имя пользователя для аутентификации на РОРЗ-сервере
Host	Содержит IP-адрес или DNS имя РОРЗ-сервера
Port	Указывает номер порта, на котором работает сервер

Два свойства компонента принадлежат к специальным типам: TMailMessage и TSummary. Они используются для собрания свойств сообщения в одном свойстве.

Данный тип представляет собой запись со следующими полями:

• Attachments. Здесь содержатся имена прикрепленных к письму файлов.
• Body. Содержит само письмо.
• From. Включает электронный адрес отправителя.
• Head. Содержит расширенный заголовок сообщения.
• Messageid. Является идентификатором письма на сервере.
• Subject. Содержит тему письма.

Это тоже запись. В ней присутствуют несколько полей, в которых хранятся описательные характеристики письма:

• Bytes. Содержит размер сообщения в байтах.
• From. Включает электронный адрес отправителя.
• Header. Содержит расширенный заголовок сообщения.
• Messageid. Является идентификатором письма на сервере.
• Subject. Содержит тему письма.

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

Основные методы компонента NMРОРЗ сведены в табл. П1.16.

Таблица П1.16. Методы компонента NMРОРЗ

Метод	Описание
UniqueID	Возвращает идентификатор письма на сервере по его номеру
DeleteMailMessage	Удаляет в почтовом ящике на сервере письмо С номером, указанным в параметре метода. Удаление происходит не сразу, в связи с чем, до окончания текущей сессии работы с сервером, удаленные письма можно восстановить
GetMailMessage	Загружает и делает активным письмо с номером, указанным в параметре метода
GetSummary	Получает с сервера описание письма с номером, указанным в параметре метода

List	Последовательно загружает номера и размеры всех сообщений с сервера. Используется совместно с событием OnList
Reset	Снимает пометку об удалении со всех писем, на которых она была установлена

События, которые могут возникать при работе объектов класса NMРОРЗ, приведены в табл. П1.17.

Таблица П1.17. События компонента NMРОРЗ

Событие	Описание
OnAuthenticationFailed	Возникает по причине неудачного завершения попытки войти в почтовый сервер с указанными именем пользователя и паролем
OnAuthenticationNeeded	Возникает в случае, когда данные аутентификации (имя пользователя и пароль) указаны не полностью
OnDecodeStart	Возникает перед началом процесса извлечения прикрепленных файлов из тела письма. Путем обработки этого события можно управлять параметрами сохранения файлов
OnFailure	Является следствием неудачного завершения попытки удаления или получения идентификатора сообщения
OnList	Сопровождает получение параметров каждого нового сообщения в процессе выполнения метода List. Позволяет сохранить данные для дальнейшего использования в программе
OnReset	Является следствием выполнения команды Reset
OnRetrieveEnd	Возникает в результате завершения получения письма
OnRetrieveStart	Возникает перед началом процесса получения нового письма с сервера
OnSuccess	Возникает при успешном выполнении команды об установке пометки "как удаленное" для писем, находящихся на сервере

Дата добавления: 2014-12-29