These are invoked when the plugin calls the host function.
host->callback_get_strvalue(char* VARIABLENAME, char* destbuf, int maxlen):
• | Handle.MainForm - return the windows Handle for the main FARR form window. |
• | Version.FARR - returns the full version string as shown in about box. |
• | Version.FARR_PLUGINAPI - returns the plugin api version (changes much less frequently) |
• | Version.FARR_PLUGINAPI_RELEASENUM - even simpler # of plugin api to make it easy to test feature compatibility. |
• | EmbeddedWb.Contents - returns contents of embedded web browser html contents (up to maxlen) |
• | EmbeddedWb.ContentsLength - returns a string integer of length of the embedded web browser contents. |
• | pvalue.[VALNAMEHERE] - replace [VALNAMEHERE] with the name of the value you want to ask a plugin to return. this function will call all plugins get_strvalue(VALNAMEHERE) until one returns a value. this can be a useful way to get information from other plugins. no error is reported if no plugin answers (return value will be set to ""). See also the pcommand alias launch string. |
• | resolve:[STRINGHERE] - expand the [STRINGHERE] string of any %KEYWORD% type strings, typically containing virtual path values (see here). |
• | resolvelnk:[STRINGHERE] - resolve the full shortcut lnk file path pointed to by [STRINGHERE] to the real file it points to (throwaway any shortcut args). |
• | resolvelnkwa:[STRINGHERE] - resolve the full shortcut lnk file path pointed to by [STRINGHERE] to the real file it points to with any shortcut args added to end. |
• | resolvefile:[STRINGHERE] - tries to find the file even if it has moved to another drive (useful for portable use) |
• | viewmode - returns either: list | memo | html | user | spreadsheet |
• | plugin_alias, plugin_regex, plugin_keywords, plugin_score - returns current value (ie if it has been overridden by user then the overridden value will be returned). |
• | Search.keywords - space separated list of any +keywords passed on search string |
• | uservars - the contents of the uservar editbox (with commands and section headers) |
• | uservarlist - a giant list of \n separated variablepath=value lines |
• | uservar.[SectionName.variablename] - return value of a variable, with recursive replacement of % stuff like paths and environmental vars |
• | rawuservar.[SectionName.variablename] - return value of a variable, with no recursive replacements |
• | score:[STRINGHERE] - far fills char* with ascii version of the floating point score value of the string, scored against current search terms. |
• | gentlescore:[STRINGHERE] - far fills char* with ascii version of the floating point score value of the string, scored against current search terms; in this scoring not all words must match. |
• | MainFormMonitor.CenterX - pass the address of an integer variable for destbuf; filled with center x coordinate of current main form monitor. |
• | MainFormMonitor.CenterY - pass the address of an integer variable for destbuf; filled with center y coordinate of current main form monitor. |
• | MainForm.Left - pass the address of an integer variable for destbuf, it will be filled. |
• | MainForm.Top - pass the address of an integer variable for destbuf, it will be filled. |
• | MainForm.Width - pass the address of an integer variable for destbuf, it will be filled. |
• | MainForm.Height - pass the address of an integer variable for destbuf, it will be filled. |
• | userdatadir - returns the path to the FARR directory under which plugins should save their configuration files with a unique name (note if you are using the c++ plugin shell you should be able to simply refer to the char userdatadir[], which is set on initialization). |
• | searchfolders - returns a string of all search folders separated by newlines |
|