Обмен сообщениями

Проект закрыт.

Обмен сообщениями между WebMaster Utility и приложениями состава WebMaster Utility (инструментами), а также пользовательскими программами, добавленными в список приложений оболочки WebMaster Utility предоставляет возможность управления приложениями из общего списка оболочки, отображать прогресс выполнения той или иной операции, выполняемой в инструменте непосредственно в окне оболочки, например если выполняемая некоторое действие программа свернута или находится в системном трее.

Сообщения передаются и принимаются посредством их отправки между окнами, отправкой сообщений WM_COPYDATA в определенном формате.

Сообщение отправляется в виде строки, формат которой выглядит таким образом:

<ID окна отправителя> : <тип сообщения> : <тело сообщения>

Оболочка WebMaster Utility имеет идентификатор приема сообщений: WMUTILITY_GENERAL_APP, на данный идентификатор необходимо отправить команду или данные, для обработки их оболочкой WebMaster Utility

Типы сообщений (общедоступные)

• 0 или не числовое
  неизвестный тип сообщения, не обрабатывается WebMaster Utility
• 1
  стандартное сообщение (произвольная строка)
• 2
  числовое сообщение (числа типа int64)
• 3
  числовое сообщение (числа типа Extended)
• 4
  сообщение - команда выполнения определенного действия (тип int64)
• 5
  уведомление о прекращении выполняемой операции
• 6
  текстовое сообщение, направляемое в системный трей оболочки (сообщение BalloonHint в трее)

Пакет отправляемого сообщения представляет собой структуру tagCOPYDATASTRUCT в котором следующие параметры должны быть обязательными для успешного приема сообщений оболочкой:

• dwData
  должен быть равен числовому значению 77139

остальные данные пакета указываются стандартно (отправка сообщения, тело сообщения, общая длина сообщения и прочее указывается/или используется с учетом Unicode)

Для отправки состояния прогресса выполняемой операции достаточно отправить сообщение типа Integer (тип: 2) с телом сообщения, которое содержит число (прогресс выполнения в процентах, от 0 до 100)

Для отправки сообщения (уведомления) о прекращении выполнения операции необходимо отправить сообщение с типом 5 и телом сообщения, равным не пустому значению (произвольное сообщение)

Пример частичного модуля отправки и приема сообщений на языке Object Pascal (Delphi):

Скачать файл (3 Kb) (загрузок: 1227)