RU

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

Выдача лицензии приостановлена.
Обмен сообщениями между 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 и телом сообщения, равным не пустому значению (произвольное сообщение)
Для отправки сообщения, которое требуется вывести в системном трее оболочки необходимо использовать тип сообщения 6. Тело сообщения необходимо разбить на части, разделенные символом |
Тело сообщения в таком случае составляется по критерию:
<заголовок сообщения> | <тип сообщения (0 - none, 1 - info, 2 - warning, 3 - error)> | <timeout сообщения> | <текст сообщения>
Пример частичного модуля отправки и приема сообщений на языке Object Pascal (Delphi):
Скачать файл (3 Kb)
Copyright © 2011 - 2017 forwebm.net
 
Яндекс цитирования
Поддержка
E-mail: Задать вопрос ,

Рейтинг@Mail.ru

Создание сайта: forwebm.net