GetPluginInfo

Функция GetPluginInfo вызывается для получения основной информации о плагине.
void WINAPI GetPluginInfo(
  struct PluginInfo *Info
);

Параметры

Info
Указатель на структуру типа PluginInfo. Плагин должен заполнить эту структуру.

Возвращаемое значение

Нет.

Замечания

  1. Функция вызывается для получения информации о плагине перед выполнением следующих действий:
    • перед показом меню конфигурации (Options|Plugins configuration) из функции Configure
    • перед показом меню плагинов (F11)
    • перед показом меню выбора дисков (Alt-F1/Alt-F2)
    • из командной строки по префиксу (например, net:\\share)
  2. Т.к. функция вызывается достаточно часто, то не стоит выполнять в ней длительные по времени операции.
  3. Структура PluginInfo, передаваемая функции GetPluginInfo, уже заполнена 0. Плагин обязательно должен заполнить поле PluginInfo.StructSize
  4. FAR вызывает функцию GetPluginInfo достаточно часто, поэтому при проектировании плагина необходимо минимизировать "расчеты", производимые в этой функции.

Пример

void WINAPI _export GetPluginInfo(struct PluginInfo *Info)
{
  Info->StructSize=sizeof(struct PluginInfo);
  Info->Flags=PF_EDITOR|PF_DISABLEPANELS;

  static char *PluginMenuStrings[1];
  PluginMenuStrings[0]=GetMsg(MBrackets);

  Info->PluginMenuStrings=PluginMenuStrings;
  Info->PluginMenuStringsNumber=sizeof(PluginMenuStrings)/
             sizeof(PluginMenuStrings[0]);
}
Смотрите также:
PluginInfo