Интерфейс IConfigPlugin
Интерфейс IConfigPlugin может быть реализован OLE-плагином для получения доступа к объектной модели OpenConf и задания различных особенностей обработки плагина OpenConf'ом. На данный момент интерфейс включает три метода:
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