Создание проекта

Плагин к Far - программный компонент-добавка к FAR Manager, позволяющая реализовать дополнительные функции. Плагин фактически - обычная библиотека, которая выполняется в контексте консольного процесса - так что ваш плагин может делать всё (ну или почти всё), что может делать обычное консольное Windows приложение. Сама идея плагинов позволяет настраивать оболочку под себя, добавляя нужное и выкидывая лишнее.

В общем, плагин к Far - обычная DLL с определённым набором экспортных функций.
(например, GetGlobalInfoW, SetStartupInfoW, GetPluginInfoW, OpenW)
Полный список экспортных функций

Инсталляция происходит элементарно - копируем DLL в каталог FarPlugins и перезапускаем Far. Вызов плагина - F11 ("Команды внешних модулей"), потом "Название плагина". Far находит плагин автоматически, просматривая все DLL в подкаталоге Plugins и автоматически выполняя в каждой функцию GetPluginInfo (если такую найдёт), при этом плагин не обязательно должен появляться в меню внешних модулей.

Создание простого плагина:

• Нужно запустить Visual Studio, сделать новый проект типа "Win32 Dynamic-Link Library" по имени Probe.
• Теперь надо сделать .def файл - это файл, в котором описываются функции, которые вызываются из внешних модулей. Описываем функции Far-а, которые будут использоваться в нашем модуле.
  Делаем текстовый файл probe.def, в котором пишем:
   

LIBRARY probe ; DESCRIPTION 'This is probe Far Plugin' EXPORTS GetGlobalInfoW SetStartupInfoW GetPluginInfoW OpenW

Здесь мы описываем 4 функции, которые нам пригодятся. А теперь добавим probe.def к файлам проекта (Project - Add existing element - probe.def).

• Дальше добавляем заголовок plugin.hpp: в каталог Probe копируем header файл plugin.hpp из архива PlugDoc.rar либо из каталога Include(появляется после компиляции исходников самого far-a). И добавляем его в проект.

• Теперь пишем сам plug-in - работаем с файлом probe.cpp.

Немного о том, что присутствует в каждом плагине: #include "plugin.hpp" // содержит нужные заголовки /* Структура PluginStartupInfo должна быть в каждом plug-in'e Far использует её для получения информации о модуле и передачи информации в модуль. */ static struct PluginStartupInfo Info; /* Экспортируемые функции */ extern "C" { /* Вызывается Far'ом для заполнения структуры PluginStartupInfo. */ void WINAPI _export SetStartupInfo (struct PluginStartupInfo *Info); /* Главная функция плагина - вызывается при выборе плагина из списка, который появляется при нажатии F11. */ HANDLE WINAPI _export OpenPlugin(int OpenFrom, int Item); /* Вызывается Far'ом для получения информации о плагине. Экземпляр структуры PluginInfo создаётся Far'ом, а её адрес передаётся в GetPluginInfo. */ void WINAPI _export GetPluginInfo(struct PluginInfo Info); } /* Функция OpenPluginW вызывается при создании новой копии плагина. */ HANDLE WINAPI _export OpenPlugin(int OpenFrom, int Item);