 |
[ История ]
[ Скачать программу ]
[ Скриншоты ]
[ Возможности ]
[ Скачать документацию ]
Спецификация модулей
MuxaSoft Dialer 4.0 Plugins Specification
версия 1.1
Правила построения модуля.
- модуль должен быть откомпилирован как COM-компонент
- молуль должен содержать в ссебе класс "Plugin" и соответствовать
спецификации, указанной ниже.
- имя модуля (имя компоненты) должно совпадать с именем файла модуля и иметь префикс
"mdplug_", например, для модуля sample.dll имя компоненты должно быть "mdplug_sample".
модуль инициализируется командой CreateObject. В данном примере модуль будет инициализироваться
командой Set PluginObject = CreateObject("mdplug_sample.Plugin").
- обязательное требование публикации модуля на официальном сайте MuxaSoft Dialer - предоставление
исходных кодов модуля для его проверки и перекомпиляции.
- скомпилированный файл модуля должен иметь расширение DLL
- скомпилированный файл проходит процесс регистрации каждый раз при его инициализации
Класс "Plugin"
function Initialize() as long
function Terminate() as long
property Caption as string
property Name as string
property Copyright as string
function Draw() as long
sub PageRect(Left, Top, Right, Bottom)
property PageHandle as long
function Clear() as long
function MainEvents(EventType, Param1, Param2) as long
property hMessagesWnd as long
property MessageResponse as variant
property StatisticObj as object
property LastError as string
property LastErrorCode as long
property PluginIndex as long
property ConfigObj as object
property ActiveConnection as string
property PhoneEntries() as string
1. Функция INITIALIZE вызывается при старте программы при попытке загрузить модуль.
Если модуль инициализирован верно, то функция возвращает значение 1. Если нет - 0.
В последнем случае модуль выгружается из памяти и больше не используется.
2. Функция TERMINATE вызывается для того, чтобы модуль смог завершить свою работу и
подготовиться к выгрузке из памяти. Функция возвращает 1 при успешном результате.
3. Свойство (Read Only) Caption. Возвращает название модуля, которое будет отображаться
в заголовке модуля (страницы).
4. Свойство (Read Only) Name. Возвращает системное имя модуля - имя COM-объекта.
5. Cвойство (Read Only) Copyright. Возвращает информацию о разработчике, как с ним
связаться и его авторские права.
6. Функция Draw. Вызывается при переходе пользователя на модуль. Функция
должна внедрить в окно PageHandle, которое находится на координатах PageRect
относительно экрана, свой модуль (параметры его). Для этого обычно применяется
либо непосредственная работа с окном либо внедрение окна через API-функцию
SetParent. При успешном выполнении возвращается 1. В противном случае
возвращается 0, а пользователю выдается сообщение об ошибке. Сообщение можно
конкретизировать через свойства LastErrorCode и LastError.
7. Функция Clear. Вызывается при переходе на другой модуль. Модуль должен
очистить окно PageHandle от всех изменений.
8. Функция MainEvents. Вызывается при возникновении ключевых событий программы.
Значения аргумента EventType:
ET_DIALSTARTED = &HF1 'получена команда Начать дозвон
ET_DIALHANGUPED = &HF2 'получена команда Прекратить соединение
ET_DIALEVENT = &HF3 'изменен статус соединения. Param1 - тип статуса (1 - сообщение, 2 - ошибка соединения), Param2 - код сообщения.
ET_ONLINESTATE = &HF5 'программа выполнила успешно соединение с сетью
ET_OFFLINESTATE = &HF6 'программа (или Windows) инициировала выход из сети
ET_STATWRITED = &HF7 'выполняется при статусе Онлайн каждые 20 секунд после записи статистики.
ET_REMOTECONNECTED = &HF8 'выполнен вход в систему удаленного администрирования
ET_REMOTEDISCONNECTED = &HF9 'выход из системы администрирования
9. Свойсво (Read/Write) hMessageWnd. Устанавливается программой. Устаналивает манипулятор
окна который может принять сообщения модуля. На это окно посылаются сообщения
командой SendMessage либо PostMessage. Сообщение (uMsg) должно быть установлено в
WM_EXTERNAL (&HF4).
Вы можете посылать на это окно следующие сообщения (wParam):
WM_EXT_W_DIAL = &H1 'начать дозвон
WM_EXT_W_HANGUP = &H2 'разорвать соединение
WM_EXT_W_AUTODIAL = &H3 'команда автоматического довзона (внешний дозвон)
WM_EXT_W_GETSTATE = &H4 'получить состояние программы. устанавливается в MessageResponse
WM_EXT_W_REMOTESESSIONS = &H5 'получить информацию о удаленных соединениях. устанавливается в MessageResponse.
Аргумент lParam должен передавать PuginIndex модуля.
10. Свойство StatisticObj указывает на объект управления статистикой типа MDStatistic.CStatBase.
11. Свойство (Read Only) LastError. Сообщает описание ошибки модуля.
12. Свойство (Read Only) LastErrorCode. Сообщает код ошибки модуля.
13. Свойство PluginIndex. Задается программой при инициализации модуля и используется
для идентификации сообщений модуля.
14. Свойство ConfigObj указывает на объект управления конфигурацией типа Config.
15. Свойство ActiveConnection устанавливается при событии ET_DIALSTARTED и указывает на имя
текущего соединения. Свойство обнуляется при событии ET_DIALHANGUPED.
16. Свойство PhoneEntries содержит массив соединений, установленных на компьютере. Заполняется
при старте программы.
www.muxasoft.com/mdialer/plugins.php - это к нам приходит
muxasoft.com/mdialer/plugins.php - это мы видим
Ссылки: Камины, печи, дымоходы
| компания росно: обязательное страхование цены | шины nokian dunlop bridgestone, летние зимние
| запчасти kia магазин hyundai daewoo
| Только в нашем магазине спецодежда москва для уборки | В наличии триколор тв
Load MainLink_Second mode.Simple v2.9:
Select now URL.REQUEST_URI: www.muxasoft.com%2Fmdialer%2Fplugins.php
Char set: data_second: Try get by Socet: www.muxasoft.com%2Fmdialer%2Fplugins.php&d=1
Data receive: www.muxasoft.com/mdialer/plugins.php - это к нам приходит
muxasoft.com/mdialer/plugins.php - это мы видим
Ссылки: Камины, печи, дымоходы
| компания росно: обязательное страхование цены | шины nokian dunlop bridgestone, летние зимние
| запчасти kia магазин hyundai daewoo
| Только в нашем магазине спецодежда москва для уборки | В наличии триколор тв
Data join with [ | ]
Load MainLink_Second mode.Simple v2.9:
Select now URL.REQUEST_URI: www.muxasoft.com%2Fmdialer%2Fplugins.php
Char set: data_second: Try get by Socet: www.muxasoft.com%2Fmdialer%2Fplugins.php&d=1
Data receive: www.muxasoft.com/mdialer/plugins.php - это к нам приходит
muxasoft.com/mdialer/plugins.php - это мы видим
Ссылки: Камины, печи, дымоходы
| компания росно: обязательное страхование цены | шины nokian dunlop bridgestone, летние зимние
| запчасти kia магазин hyundai daewoo
| Только в нашем магазине спецодежда москва для уборки | В наличии триколор тв
Data join with [ | ]
| дозатор, железнодорожные весы, платформенные весы; аренда офисных помещений; бесплатные клипы хорошего качества; автосервис авто; аренда помещений грузинская улица; задержка после аборта; инженерно защитные системы
|
 |
...:: Наши друзья ::...
|
 |
|
