Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 8.4   8.5   9.0   9.1   9.2   9.3   9.4   9.5   10.0   10.1    Statistic  

HotKey.SetEvaluate

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

Parameters

Parameter Description Example value
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 )"

Result

Returns OK or error.

Description

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.

Examples

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\" );
        \"UTF-8\"
    )"
)

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\" );
        \"UTF-8\"
    )"
)

See also

Blog Entries

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


HotKey.SetEnabled   -   HotKey.SetIgnoreOnModal

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins