OpenPluginInfo

main | structures
The OpenPluginInfo structure describes a plugin instance to FAR. 
struct OpenPluginInfo
{
  int StructSize;
  DWORD Flags;
  const char *HostFile;
  const char *CurDir;
  const char *Format;
  const char *PanelTitle;
  const struct InfoPanelLine *InfoLines;
  int InfoLinesNumber;
  const char * const *DescrFiles;
  int DescrFilesNumber;
  const struct PanelMode *PanelModesArray;
  int PanelModesNumber;
  int StartPanelMode;
  int StartSortMode;
  int StartSortOrder;
  const struct KeyBarTitles *KeyBar;
  const char *ShortcutData;
  long Reserverd;
};

Elements

StructSize
This field should contain size of the OpenPluginInfo structure:
C: Opi.StructSize = sizeof (struct OpenPluginInfo);
Pascal: Opi.StructSize := SizeOf(Info);
Flags
A combination of the following values (the OPENPLUGININFO_FLAGS enumeration):
FlagDescription
OPIF_USEFILTER Use filter in the plugin panel.
OPIF_USESORTGROUPS Use sort groups in the plugin panel.
OPIF_USEHIGHLIGHTING Use file highlighting in the plugin panel.
OPIF_ADDDOTS Add ".." item automatically if it is absent.
OPIF_RAWSELECTION Folders may be selected regardless of FAR settings.
OPIF_REALNAMES Turns on the standard FAR file processing mechanism if requested operation is not supported by the plugin. If this flag is set, the items on the plugin panel should be real file names.
OPIF_SHOWNAMESONLY Show file names without paths by default.
OPIF_SHOWRIGHTALIGNNAMES Show file names right-aligned by default in all panel display modes.
OPIF_SHOWPRESERVECASE Show file names using original case regardless of FAR settings.
OPIF_FINDFOLDERS Apply "Find file" command for folders. The OPIF_FINDFOLDERS flag has no effect since FAR Manager 1.70 beta 4.
OPIF_COMPAREFATTIME Convert timestamps to FAT format for the Compare folders operation. Set this flag if the plugin file system doesn't provide the time accuracy necessary for standard comparison operations.
OPIF_EXTERNALGET
OPIF_EXTERNALPUT
OPIF_EXTERNALDELETE
OPIF_EXTERNALMKDIR		 These flags can be used with OPIF_REALNAMES only. Forces usage of corresponding internal FAR functions, even if plugin exports such function.
OPIF_USEATTRHIGHLIGHTING FAR Manager 1.70 build #963 and below: use attribute-based file highlighting. All file highlighting templates, except * and *.* will be ignored.
FAR Manager 1.70 build #964 and above: use attributes only for file highlighting. File names will be ignored. Color is chosen from file color groups, which have templates excluded from analysis (i.e. option "[ ] Match file mask(s)" in file highlighting setup dialog is off).
HostFile
File name on emulated file system. If plugin doesn't emulate a file system based on files, set this field to NULL.
CurDir
Current directory of plugin. If plugin returns empty string here, FAR will close plugin automatically if ENTER is pressed on ".." item.
Format
Plugin's format name. This is shown in the file copy dialog.
PanelTitle
Plugin panel header.
InfoLines
Pointer to an array of  InfoPanelLine structures. Each structure describes one line in the information panel. If no plugin-dependent information needs to be shown in the information panel, set this field to NULL.
InfoLinesNumber
Number of structures in InfoPanelLine.
DescrFiles
Pointer to an array of pointers to strings with description file names. FAR tries to read these files (using the GetFiles function) when descriptions are shown and refresh them after file processing, if the PPIF_PROCESSDESCR flag in the PluginPanelItem structure was set. Depending on the plugin type, description processing can take significant time. If you don't need this functionality, set the field to NULL.
DescrFilesNumber
Number of description file names.
PanelModesArray
Pointer to an array of PanelMode structures. Panel display mode settings can be redefined using this field. The first structure describes display mode number 0, the second - number 1, etc. If new panel display modes are not required, set the field to NULL.
PanelModesNumber
Number of PanelMode structures.
StartPanelMode
The panel display mode to set on panel creation. Must be in the form '0'+<view mode number>. For example, '1' (0x31) will set Brief view mode. If you don't want to change panel display mode at plugin startup, set the field to 0.
StartSortMode
The sort mode to set on panel creation. One of the following values can be specified: SM_UNSORTED, SM_NAME, SM_EXT, SM_MTIME, SM_CTIME, SM_ATIME, SM_SIZE, SM_DESCR, SM_OWNER, SM_COMPRESSEDSIZE, SM_NUMLINKS. If you don't want to change sort mode at plugin startup, set the field to SM_DEFAULT or 0.
StartSortOrder
If StartSortMode is specified, this field must be used to set sort direction: 0 for ascending, 1 - for descedning.
KeyBar
Pointer to the KeyBarTitles structure. Function key labels are redefined using this field. Set to NULL if not required.
ShortcutData
Pointer to a null-terminated string, which describes the current state of the plugin. The length of string should be less than or equal to MAXSIZE_SHORTCUTDATA. This string is passed to the OpenPlugin function, when the plugin is activated by the link to folder command. For example, an FTP client can place the server host name, login and password here. The current directory is not required as FAR will restore this itself.
If no additional information is required for activation of links to a folder, set this field to NULL.
Reserverd
Reserved for future use, set to 0.

Remarks

  1. All data, passed through this structure should be valid after return from the GetOpenPluginInfo function. This means, for example, that pointers to the stack are not allowed, use static or global variables instead.
  2. When this structure is passed to a plugin's GetOpenPluginInfo function, it can be assumed to be cleared to zeros.
See also:
structures | TOpenPluginInfo