4D v13.4
POST EVENT
- 4D Language Reference
-
- User Interface
-
- BEEP
- Caps lock down
- Focus object
- GET FIELD TITLES
- GET MOUSE
- Get platform interface
- GET TABLE TITLES
- HIDE MENU BAR
- HIDE TOOL BAR
- INVERT BACKGROUND
- Macintosh command down
- Macintosh control down
- Macintosh option down
- OBJECT Get name
- OBJECT Get pointer
- PLAY
- Pop up menu
- POST CLICK
- POST EVENT
- POST KEY
- REDRAW
- SET ABOUT
- SET CURSOR
- SET FIELD TITLES
- SET PLATFORM INTERFACE
- SET TABLE TITLES
- Shift down
- SHOW MENU BAR
- SHOW TOOL BAR
- Tool bar height
- Windows Alt down
- Windows Ctrl down
POST EVENT
| POST EVENT ( what ; message ; when ; mouseX ; mouseY ; modifiers {; process} ) | ||||||||
| Parameter | Type | Description | ||||||
| what | Longint |
|
Type of event | |||||
| message | Longint |
|
Event message | |||||
| when | Longint |
|
Event time expressed in ticks | |||||
| mouseX | Longint |
|
Horizontal coordinate of mouse | |||||
| mouseY | Longint |
|
Vertical coordinate of mouse | |||||
| modifiers | Longint |
|
Modifier keys state | |||||
| process | Longint |
|
Destination process reference number, or Application event queue, if omitted, or 0 | |||||
The POST EVENT command simulates a keyboard or mouse event. Its effect is as if the user actually acted on the keyboard or the mouse.
You pass one of the following values in what:
| Constant | Type | Value |
| Auto key event | Longint | 5 |
| Key down event | Longint | 3 |
| Key up event | Longint | 4 |
| Mouse down event | Longint | 1 |
| Mouse up event | Longint | 2 |
If the event is a mouse-related event, you pass 0 (zero) in message. If the event is a keyboard-related event, you pass the code of the simulated character in message.
Usually, you pass the value returned by Tickcount in when.
If the event is a mouse-related event, you pass the horizontal and vertical coordinates of the click in mouseX and mouseY.
In the parameter modifiers, you pass one or a combination of the constants of the Events (Modifiers) theme.
| Constant | Type | Value | Comment |
| Activate window bit | Longint | 0 | |
| Activate window mask | Longint | 1 | |
| Caps Lock key bit | Longint | 10 | |
| Caps Lock key mask | Longint | 1024 | |
| Command key bit | Longint | 8 | |
| Command key mask | Longint | 256 | Windows = Ctrl key, Mac OS = Command key |
| Control key bit | Longint | 12 | |
| Control key mask | Longint | 4096 | Mac OS only |
| Mouse button bit | Longint | 7 | |
| Mouse button mask | Longint | 128 | |
| Option key bit | Longint | 11 | |
| Option key mask | Longint | 2048 | Windows = Alt key, Mac OS = Option key |
| Right control key bit | Longint | 15 | |
| Right control key mask | Longint | 32768 | |
| Right option key bit | Longint | 14 | |
| Right option key mask | Longint | 16384 | |
| Right shift key bit | Longint | 13 | |
| Right shift key mask | Longint | 8192 | |
| Shift key bit | Longint | 9 | |
| Shift key mask | Longint | 512 | Windows and Mac OS |
For example, to simulate the Shift key, pass Shift key bit.
If you specify the process parameter, the event is sent to the process whose process number you pass in process. If you pass 0 (zero) or if you omit the parameter, the event is sent at the application level, and the 4D scheduler will dispatch it to the appropriate process.
Product: 4D
Theme: User Interface
Number:
467
Created: 4D v6
