Monkeybread Software - MBS FileMaker Plugin: RemoteControl.PressKey

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: 7.2 7.3 7.4 7.5 8.0 8.1 8.2 8.3 8.4 8.5 Statistic

RemoteControl.PressKey

Presses a key.

Component	Version	macOS	Windows	Server	FileMaker Cloud	FileMaker iOS SDK
RemoteControl	2.8	Yes	Yes	No	No	No

MBS( "RemoteControl.PressKey"; VirtualKey; ScanCode { ; down } )

Parameters

Parameter Description Example value

VirtualKey The platform dependent virtual key code. Pass a number for a virtual key code or pass a string to let the plugin try to lookup the virtual key code. "a"

ScanCode The platform dependent scan code. Pass a number for a scan code or pass a string to let the plugin try to lookup the virtual key code. If this parameter is missing, the virtual key code is used to lookup the scan code. "a"

down Optional
Whether to press key down or release it. If parameter is missing the plugin will do both.

Parameter	Description	Example value
VirtualKey	The platform dependent virtual key code. Pass a number for a virtual key code or pass a string to let the plugin try to lookup the virtual key code.	"a"
ScanCode	The platform dependent scan code. Pass a number for a scan code or pass a string to let the plugin try to lookup the virtual key code. If this parameter is missing, the virtual key code is used to lookup the scan code.	"a"
down	Optional Whether to press key down or release it. If parameter is missing the plugin will do both.

Result

Returns OK on success.

Description

Presses a key.
Codes are platform dependent. As a help we allow you to pass the character for the key as text and the plugin looks up virtual key code and scan code. But this lookup can fail. So please try all keys for your keyboard.

Examples

Press a key

MBS( "RemoteControl.PressKey"; "a")

Press return key on Mac:

MBS( "RemoteControl.PressKey"; 36; 13)

Press cursor right key on Mac:

MBS( "RemoteControl.PressKey"; 124; 0 )

Write Hello

Set Variable [ $r ; Value: MBS("RemoteControl.PressShiftKey"; 1) ]
Set Variable [ $r ; Value: MBS("RemoteControl.PressKey"; "H") ]
Set Variable [ $r ; Value: MBS("RemoteControl.PressShiftKey"; 0) ]
Set Variable [ $r ; Value: MBS("RemoteControl.PressKey"; "e") ]
Set Variable [ $r ; Value: MBS("RemoteControl.PressKey"; "l") ]
Set Variable [ $r ; Value: MBS("RemoteControl.PressKey"; "l") ]
Set Variable [ $r ; Value: MBS("RemoteControl.PressKey"; "o") ]

Press return with plugin looking up codes:

Set Variable [ $r ; Value: MBS("RemoteControl.PressKey"; ¶) ]

Press space key:

Set Variable [ $r ; Value: MBS("RemoteControl.PressKey"; " ") ]

Example Databases

Created 18th August 2014, last changed 14th September 2017

RemoteControl.PressDialogButton.Clear - RemoteControl.PressKeyLater