GetPackerCaps: Difference between revisions
Jump to navigation
Jump to search
Francoisal (talk | contribs) |
m (Backlinks) |
||
(2 intermediate revisions by one other user not shown) | |||
Line 30: | Line 30: | ||
Omitting PK_CAPS_NEW and PK_CAPS_MODIFY means [[PackFiles]] will never be called and so you don’t have to implement [[PackFiles]]. Omitting PK_CAPS_MULTIPLE means [[PackFiles]] will be supplied with just one file. Leaving out PK_CAPS_DELETE means [[DeleteFiles]] will never be called; | * Omitting PK_CAPS_NEW and PK_CAPS_MODIFY means [[PackFiles]] will never be called and so you don’t have to implement [[PackFiles]]. | ||
* Omitting PK_CAPS_MULTIPLE means [[PackFiles]] will be supplied with just one file. | |||
* Leaving out PK_CAPS_DELETE means [[DeleteFiles]] will never be called; | |||
* Leaving out PK_CAPS_OPTIONS means [[ConfigurePacker]] will not be called. | |||
* PK_CAPS_MEMPACK enables the functions [[StartMemPack]], [[PackToMem]] and [[DoneMemPack]]. | |||
* If PK_CAPS_BY_CONTENT is returned, Totalcmd calls the function [[CanYouHandleThisFile]] when the user presses Ctrl+PageDown on an unknown archive type. | |||
* If PK_CAPS_SEARCHTEXT is returned, Total Commander will search for text inside files packed with this plugin. This may not be a good idea for certain plugins like the diskdir plugin, where file contents may not be available. | |||
* Finally, if PK_CAPS_HIDE is set, the plugin will not show the file type as a packer. This is useful for plugins which are mainly used for creating files, e.g. to create batch files, avi files etc. The file needs to be opened with Ctrl+PgDn in this case, because Enter will launch the associated application. | |||
'''Important note:''' | '''Important note:''' | ||
If you change the return values of this function, e.g. add packing support, you need to reinstall the packer plugin in Total Commander, otherwise it will not detect the new capabilities. | If you change the return values of this function, e.g. add packing support, you need to reinstall the packer plugin in Total Commander, otherwise it will not detect the new capabilities. | ||
{{backlink|Packer plugins developer guide|Packer plugins developer guide}} | |||
{{back|Packer plugins developer guide overview|Packer plugins developer guide overview}} | |||
{{back|ConfigurePacker|ConfigurePacker}} | |||
{{back|What's new|What's new}} |
Latest revision as of 18:50, 18 April 2006
GetPackerCaps tells Totalcmd what features your packer plugin supports.
int __stdcall GetPackerCaps();
Description
Implement GetPackerCaps to return a combination of the following values:
Constant | Value | Description |
---|---|---|
PK_CAPS_NEW | 1 | Can create new archives |
PK_CAPS_MODIFY | 2 | Can modify existing archives |
PK_CAPS_MULTIPLE | 4 | Archive can contain multiple files |
PK_CAPS_DELETE | 8 | Can delete files |
PK_CAPS_OPTIONS | 16 | Has options dialog |
PK_CAPS_MEMPACK | 32 | Supports packing in memory |
PK_CAPS_BY_CONTENT | 64 | Detect archive type by content |
PK_CAPS_SEARCHTEXT | 128 | Allow searching for text in archives created with this plugin |
PK_CAPS_HIDE | 256 | Don't show packer icon, don't open with Enter but with Ctrl+PgDn |
- Omitting PK_CAPS_NEW and PK_CAPS_MODIFY means PackFiles will never be called and so you don’t have to implement PackFiles.
- Omitting PK_CAPS_MULTIPLE means PackFiles will be supplied with just one file.
- Leaving out PK_CAPS_DELETE means DeleteFiles will never be called;
- Leaving out PK_CAPS_OPTIONS means ConfigurePacker will not be called.
- PK_CAPS_MEMPACK enables the functions StartMemPack, PackToMem and DoneMemPack.
- If PK_CAPS_BY_CONTENT is returned, Totalcmd calls the function CanYouHandleThisFile when the user presses Ctrl+PageDown on an unknown archive type.
- If PK_CAPS_SEARCHTEXT is returned, Total Commander will search for text inside files packed with this plugin. This may not be a good idea for certain plugins like the diskdir plugin, where file contents may not be available.
- Finally, if PK_CAPS_HIDE is set, the plugin will not show the file type as a packer. This is useful for plugins which are mainly used for creating files, e.g. to create batch files, avi files etc. The file needs to be opened with Ctrl+PgDn in this case, because Enter will launch the associated application.
Important note:
If you change the return values of this function, e.g. add packing support, you need to reinstall the packer plugin in Total Commander, otherwise it will not detect the new capabilities.
Back to Packer plugins developer guide
Back to Packer plugins developer guide overview Back to ConfigurePacker Back to What's new