Help

Script triggers reference
F
ILEMAKER PRO HELP 1173
• See Changing object data without activating script triggers for a list of actions that do not
activate this script trigger.
Related topics
Setting up script triggers
Setting script triggers for layouts
Setting script triggers for objects
OnObjectKeystroke
Triggers a script to run when an object is active and receives one or more characters from the
keyboard, either directly or via an input method editor (IME). Use the
Get(TriggerKeystroke) function
to return the characters that activated the script trigger.
When the script runs
Before the event has been processed.
Modes in which the trigger can be used
Browse and Find modes.
Result
You can use the Exit Script script step within the triggered script to return True or False.
• True: The event that triggered the script proceeds.
• False: The event that triggered the script is canceled.
Originated in
FileMaker Pro 10.0
Notes
• This script trigger is not supported in FileMaker WebDirect.
• Combining keystrokes in an IME will not activate this trigger. Instead, the trigger activates
after the text is committed in the IME. The triggered script processes the committed string.
• Use the Get(TriggerModifierKeys), Code, and Char functions to work with special
characters such as navigational keys like the Tab and the arrow keys, and with general
Unicode characters. See the Code function for a list of navigational keys and the codes
reported to a script. The Char function returns the characters for Unicode code points.
• Keystrokes are processed in the following order:
1. The operating system processes certain keys.
2. FileMaker Pro processes keyboard shortcut keys.
3. A script triggered by OnObjectKeystroke processes the characters.
4. A script triggered by OnLayoutKeystroke processes the characters.
5. Navigational keys are used for navigation, while non-navigational keys are processed
by the active object if there is one.
6. If there is no active object, an alert displays for non-navigational keys.