Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4    Statistic  


Sets expression to be run when hotkey is pressed.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
HotKey 6.1 Yes Yes No No No
MBS( "HotKey.SetEvaluate"; HotKeyRef; Expression )   More


Parameter Description Example
HotKeyRef The reference value for the hotkey as returned by HotKey.Register function. $hotkey
Expression The expression to evaluate.
Can be in local language of FileMaker Pro or english.
For Server must always be in english.
"Let ( $$Done = 1 ; 1 )"


Returns OK or error.


Sets expression to be run when hotkey is pressed.
In the expression the text $$ID$$ will be replaced when evaluated with the hotkey reference, so you can pass it to other functions if needed.


Sets expression to run when hotkey is pressed:

Variable setzen [ $result ; Wert: MBS( "HotKey.SetEvaluate"; $curl; "Let ( $$Cancelled = 1 ; 1 )" ) ]

Set to write to a log file when a key is pressed:

MBS( "HotKey.SetEvaluate"; $hotkey; "MBS(\"Text.AppendTextFile\"; Get(CurrentHostTimeStamp) & \": Key F5 pressed¶\"; \"/Users/cs/Desktop/hotkey.txt\"; \"native\")")

Register Control-F5 for showing/hiding data viewer:

Set Variable [$hotkey; Value:MBS("HotKey.Register"; "F5"; "control")]
Set Variable [$r; Value:MBS( "HotKey.SetEvaluate"; $hotkey; "MBS(\"Menubar.RunMenuCommand\"; 49297)" )]

Register Control-F5 to write text file on desktop with content of data viewer:

MBS( "HotKey.SetEvaluate";
    MBS("HotKey.Register"; "F5"; "control");
    "MBS( \"Text.WriteTextFile\";
        MBS( \"FM.DataViewerContent\" );
        MBS( \"Path.AddPathComponent\";
            MBS( \"Folders.UserDesktop\" );
            \"Data Viewer \" & substitute(substitute(Get(CurrentTimestamp); \":\"; \"-\"); \"/\"; \"-\") & \".txt\" );

Register Control-F6 to write current script a text file to desktop:

MBS( "HotKey.SetEvaluate";
    MBS("HotKey.Register"; "F6"; "control");
    "MBS( \"Text.WriteTextFile\";
        MBS( \"ScriptWorkspace.ScriptText\" );
        MBS( \"Path.AddPathComponent\";
            MBS( \"Folders.UserDesktop\" );
            \"Script \" & substitute(substitute(MBS( \"ScriptWorkspace.CurrentTab\" ); \":\"; \"-\"); \"/\"; \"-\") & \".txt\" );

See also

Blog Entries

Created 4th March 2016, last changed 15th November 2019

HotKey.SetEnabled   -   HotKey.SetIgnoreOnModal

Feedback: Report problem or ask question.

MBS Xojo Plugins