PutFiles
Функция PutFiles вызывается для перемещения файлов на панель
эмулируемой файловой системы.
(FAR плагину: "этот/эти файл(ы) для тебя, можешь поместить на свою панель").
int WINAPI PutFiles(
HANDLE hPlugin,
struct PluginPanelItem *PanelItem,
int ItemsNumber,
int Move,
int OpMode
);
Параметры
hPlugin
PanelItem
Указатель на массив из структур
PluginPanelItem.
Каждая структура описывает файл для передачи.
ItemsNumber
Число элементов в массиве PanelItem.
Move
Ноль, если файл должен быть скопирован, иначе перемещен.
OpMode
Комбинация флагов
operation mode.
Эта функция должна воспринимать флаг OPM_SILENT.
Также она может использовать флаг OPM_DESCR.
Если флаг OPM_SILENT не установлен, то возможна выдача
диалога подтверждения и редактирование пути назначения.
Возвращаемое значение
В случае удачи, функция должна возвращать 1 или 2. Если плагин возвращает 1,
то FAR пытается установить курсор на последний по дате создания файл текущей
панели. Если плагин возвращает 2, то FAR никаких перемещений курсора не
предпринимает. Если функция завершилась неудачей, должен возвращаться 0.
Если же функция была прервана пользователем, то возвращаемое значение
должно равняться -1.
Замечания
- Если операция была прервана, но часть файлов все же была скопирована,
плагин может убрать выделение только с обработанных файлов. Для этого он
должен сбросить флаг PPIF_SELECTED
у соответствующих структур файлов,
передаваемых в функцию через параметр PluginPanelItem.
Смотрите также: