Viewer

Функция Viewer позволяет открыть внутреннюю программу просмотра FAR Manager.
int WINAPI Viewer (
  const char *FileName,
  const char *Title,
  int X1,
  int Y1,
  int X2,
  int Y2,
  DWORD Flags
);

Параметры

FileName
Файл для просмотра
Title
Текстовая строка, которая будет показана вверху окна вьюера. Если этот параметр равен NULL, то используется имя файла.
X1, Y1, X2, Y2
Координаты окна вьюера. Если координата X2 или Y2 равна -1, то она будет замещена соответственно шириной или высотой экрана. Если координата X1 или Y1 меньше нуля, то считается, что она равна нулю.
Flags
Может быть комбинацией следующих значений (перечисление VIEWER_FLAGS):
ФлагОписание
VF_DELETEONCLOSE FAR удалит просматриваемый файл после закрытия вьюера. Если в директории, содержащей просматриваемый файл, нет других файлов, она также будет удалена. Если требуется удаление только файла, то используйте VF_DELETEONLYFILEONCLOSE. Файл не удаляется, если было произведено переключение по F6 и если существуют другие открытые вьюеры/редакторы с этим же файлом.
VF_DELETEONLYFILEONCLOSE Аналог VF_DELETEONCLOSE, но удаляется только файл. Этот флаг имеет более низкий приоритет при обработке, чем VF_DELETEONCLOSE.
VF_DISABLEHISTORY Запретить добавление имени файла в историю просмотра (Alt-F11). По умолчанию имя в историю добавляется.
VF_ENABLE_F6 Разрешает переключение по F6 из вьюера в редактор.
VF_IMMEDIATERETURN Позволяет плагину получать управление сразу же после открытия программы просмотра. Открываемая программа просмотра становится активной. Выставлять этот флаг имеет смысл только в паре с флагом VF_NONMODAL.
VF_NONMODAL Создать немодальное окно вьюера. Если этот флаг присутствует, пользователь сможет переключаться между программой просмотра и другими окнами FAR Manager.

Плагин получит управление только после закрытия или ухода из открытой программы просмотра (например, пользователь нажал Ctrl-Tab). Если вам нужно, чтобы плагин получал управление сразу же после открытия программы просмотра, то используйте флаг VF_IMMEDIATERETURN.

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

Если флаг VF_NONMODAL отсутствует, эта функция возвращает TRUE в случае успеха или FALSE, если файл не удалось открыть. Если этот флаг присутствует, то всегда возвращается TRUE.
Смотрите также:
Editor