Интерфейс IConfigPlugin
Интерфейс IConfigPlugin может быть реализован OLE-плагином для получения доступа к объектной модели OpenConf и задания различных особенностей обработки плагина OpenConf'ом. На данный момент интерфейс включает три метода: Init Done GetPluginCaps
IConfigPlugin::Init
Описание метода для VB. Function Init(pConfigurator As Configurator) As String Описание для C++ STDMETHOD(Init)(IConfigurator *pConfigurator,BSTR *PluginName); Метод вызывается сразу после загрузки плагина для его инициализации. Параметры: pConfigurator Объект Configurator, корневой элемент объектной модели OpenConf. PluginName Возвращаемое значение - имя плагина. Данный метод позволяет плагину получить доступ к объектам OpenConf. Должен вернуть имя плагина, под которым он будет зарегистрирован в списке плагинов. Если метод не вернет имя, в его качестве будет использоваться ProgID плагина. Пример реализации на VB
IConfigPlugin::Done
Описание метода для VB. Sub Done() Описание для C++ STDMETHOD(Done)(void); Вызывается перед завершением работы Конфигуратора. Парамтров нет. При вызове данного метода плагин должен освободить все используемые экземпляры объектов OpenConf'а. Пример реализации на VB
IConfigPlugin::GetPluginCaps
Описание метода для VB. Function GetPluginCaps(capNum As PluginCaps) Описание для C++ STDMETHOD(GetPluginCaps)(PluginCaps capNum,VARIANT *pResult); Метод предназначен для получения информации о возможностях плагина. Параметры: CapsNum Перечисление, определяющее номер запрашиваемой возможности плагина pResult Возвращаемый результат. Зависит от запрашиваемой информации Пока определены следующие возможности: capOpenIn Запрашивает у визуального плагина, где его отображать. При возврате 0 отображает плагин в правой панели OpenConf. При возврате 1 - отображает на отдельной вкладке окна Конфигурации capShowMacros Отображать или нет макросы плагина. При возврате true - макросы отображаются в списке, при false - нет. capIconNum Запрашивает порядковый номер иконки в файле плагина для отображения его значка. Нумерация начинается с 0. Пример реализации на VB