PanelControl

Внимание!

• В режиме, когда Far Manager запущен с ключами /e или /v, функция обрабатывает только команды FCTL_CHECKPANELSEXIST, FCTL_GETUSERSCREEN и FCTL_SETUSERSCREEN.

В процессе исполнения запроса

Info.PanelControl(PANEL_ACTIVE,FCTL_GETPANELINFO,0,&PInfo);

В некоторых случаях (пример: поиск в архивах по Alt+F7) физически панель плагина не создаётся, поэтому необходимо обязательно проверять код возврата у PanelControl, чтобы не упасть в самый неподходящий момент, выполнив работу для панели, которой нет.

Функция возвращает размер запрашиваемого элемента панели PluginPanelItem, если Param2 = NULL или указывает на корректно заполненную структуру.

Примечание: если установить значение FarGetPluginPanelItem::Size меньше необходимого размера (но при этом не меньше размера PluginPanelItem), то будет записано столько полей, сколько поместится целиком, а остальным будет присвоено значение NULL. В частности, если установить FarGetPluginPanelItem::Size в sizeof(PluginPanelItem) то можно за один вызов и без динамического выделения памяти получить все поля, не являющиеся указателями.

Внимание! Tак делать нельзя:

PluginPanelItem PPI;
Info.PanelControl(PANEL_ACTIVE,FCTL_GETPANELITEM,J,&PPI);

Пример корректного использования:

for(int J=0; J < PInfo.ItemsNumber; J++)
{
  size_t Size=Info.PanelControl(PANEL_ACTIVE,FCTL_GETPANELITEM,J,0);
  PluginPanelItem *PPI=(PluginPanelItem*)malloc(Size);
  if (PPI)
  {
    FarGetPluginPanelItem FGPPI={sizeof(FarGetPluginPanelItem),Size,PPI};
    Info.PanelControl(PANEL_ACTIVE,FCTL_GETPANELITEM,J,&FGPPI);
    lstrcpy(CurFile[J],PPI->FileName);
    free(PPI);
  }
}

PanelInfo.SelectedItemsNumber равно 1, если не выделено никаких элементов. В этом случае PluginPanelItem содержит данные для элемента под курсором. Если вы хотите узнать, действительно ли выделен этот файл, то проверьте у него состояние флага PPIF_SELECTED.

Например, установить на пассивной панели каталог TempDirectory и сделать эту панель активной:

FarPanelDirectory dirInfo={sizeof(FarPanelDirectory),TempDirectory,nullptr,{0},nullptr};
Info.PanelControl(PANEL_PASSIVE,FCTL_SETPANELDIRECTORY,0,&dirInfo);
Info.PanelControl(PANEL_PASSIVE,FCTL_SETACTIVEPANEL,0,0);

После выполнения этой функции пропадёт выделение с элементов каталога и его будет невозможно восстановить (комбинация Ctrl+M) по желанию пользователя, даже если новый каталог равен старому.

Внимание!

• Порядок использования смотрите в примере к FCTL_SETSELECTION

Нужно вызвать FCTL_REDRAWPANEL для показа изменений.

Пример:

// начинаем операцию по выделению файлов
Info.PanelControl(PANEL_ACTIVE,FCTL_BEGINSELECTION,0,NULL);

// выделяем
for(int i=0; i < PInfo.ItemsNumber; i++)
{
  Info.PanelControl(PANEL_ACTIVE,FCTL_SETSELECTION,i,(void*)TRUE);
}
// завершаем операцию и перерисовываем панель
Info.Control(PANEL_ACTIVE,FCTL_ENDSELECTION,0,NULL);
Info.Control(PANEL_ACTIVE,FCTL_REDRAWPANEL,0,NULL);

Нужно вызвать FCTL_REDRAWPANEL для показа изменений.

Внимание!

• Порядок использования такой же, что и в примере к FCTL_SETSELECTION