SendKeyObject
The function SendKeyObject sends a key event code to objects in the currently displayed project screen. You can use this function to trigger Command animations on those objects.
Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
---|---|---|---|---|---|---|
SendKeyObject | Module Activity | Synchronous | Supported | Supported | Supported | Not supported |
Syntax
SendKeyObject(numEvent,strMainKey,numShift,numCtrl,numAlt,strTargetScreen,optNumID)
- numEvent
- A numeric value that indicates the type of key event to send to the screen. The following values are accepted:
Value Description 0 On Down 1 On While 2 On Up For more information about these key events, see Command animation.
Note: If the “On While” event is specified, the “On While” script on the Command animation is executed just once for each time this function is executed. It is not continuously executed as if the key is pressed and held down, because this function does not have a parameter for specifying duration. If you want to cause that sort of behavior, you can include this function in an appropriately configured FOR loop. - strMainKey
- The key to be sent to the screen. The following values are accepted:
Value Description "A" … "Z" alphabetic characters A through Z "+" plus symbol "-" minus symbol "*" multiply symbol "/" divide symbol "LEFT" left arrow (←) "UP" up arrow (↑) "RIGHT" right arrow (→) "DOWN" down arrow (↓) "HOME" Home key "END" End key "PAGEUP" Page Up key "PAGEDOWN" Page Down key "INSERT" Insert key "DELETE" Delete key "SPACE" Space key "RETURN" Return key "BACKSPACE" Backspace key (if different from Delete key) "ESCAPE" Escape key "F1" … "F20" function keys F1 through F20 The key must be enclosed in quotes, as shown.
- numShift
- A numeric value that indicates whether to include Shift with the specified key (e.g., Shift+R). The following values are accepted: 0 is no, 1 is yes.
This parameter is optional; if no value is specified, the default value is 0.
- numCtrl
- A numeric value that indicates whether to include Ctrl with the specified key (e.g., Ctrl+R). The following values are accepted: 0 is no, 1 is yes.
This parameter is optional; if no value is specified, the default value is 0.
- numAlt
- A numeric value that indicates whether to include Alt with the specified key (e.g., Alt+R). The following values are accepted: 0 is no, 1 is yes.
This parameter is optional; if no value is specified, the default value is 0.
- strTargetScreen
- The name of the screen that will receive the key event code.
This parameter is optional; if no value is specified, the currently active screen is used.
- optNumID
- The specific ID number of the screen. (The ID number is assigned when the screen is opened with the function Open.)
This parameter is optional; if no value is specified, the default value is 0.
Returned value
This function does not return any value.
Notes
If the option Enforce Web functionality equivalence is selected in the project settings, this function cannot be called from Global Procedures or Script worksheets. This is because the function is meaningful only when it is executed on stations that display project screens; it might cause unexpected behavior if it is called from background tasks that are executed on the project runtime server. For more information, see Preferences tab.
Also, the parameters numShift, numCtrl, numAlt and strTargetScreen are all optional, but if you configure one of them, you must configure the others as well.
Examples
SendKeyObject(0,"R")
SendKeyObject(0,"R",1,1,0,"main",10)