Table of Contents
Storyboard supports a list of standard events. These events are all prefixed
with gre. and can be used by your application.
The system has been initialized and is ready. This is the first event set in the system.
Data:
No data payload
An area of the screen has been damaged (visible data has changed). A redraw event may not cause actual screen drawing if the control which has changed is hidden or offscreen.
Data:
int32_t x
int32_t y
int32_t width
int32_t height
If the values are all 0 then the entire screen has been damaged
The following events are generated in response to a device such as a mouse or a touchscreen. These events are targeted at specific controls based upon the controls location and sensitivity.
A mouse/touchscreen has been pressed.
Data
uint32_t button
uint32_t timestamp
int16_t subtype
int16_t x
int16_t y
int16_t z
Where:
| GR_EVENT_BTN_LEFT - 0x0001: if this is a touchscreen then the button is always left |
| GR_EVENT_BTN_MIDDLE - 0x0002 |
| GR_EVENT_BTN_RIGHT - 0x0004 |
This is an event timestamp in milliseconds since application start
| GR_EVENT_RELEASE_IN |
| GR_EVENT_RELEASE_OUT |
This parameter is dependent on the availability of z- co-ordinate information
A mouse/trouchscreen has been released.
Data
uint32_t button
uint32_t timestamp
int16_t subtype
int16_t x
int16_t y
int16_t z
Where:
| GR_EVENT_BTN_LEFT - 0x0001: if this is a touchscreen then the button is always left |
| GR_EVENT_BTN_MIDDLE - 0x0002 |
| GR_EVENT_BTN_RIGHT - 0x0004 |
This is an event timestamp in milliseconds since application start
| GR_EVENT_RELEASE_IN |
| GR_EVENT_RELEASE_OUT |
This parameter is dependent on the availability of z- co-ordinate information
If a mouse/touchscreen presses and then releases on the same control then a touch event will be generated. This is useful for activating button style elements. If the release is found to intersect a different control then a touch event is not generated.
This event is synthetically generated by the framework based on
incoming gre.press and gre.release events.
Event redirectors should generally not include this event in their
list of redirection events.
Data
uint32_t button
uint32_t timestamp
int16_t subtype
int16_t x
int16_t y
int16_t z
Where:
| GR_EVENT_BTN_LEFT - 0x0001: if this is a touchscreen then the button is always left |
| GR_EVENT_BTN_MIDDLE - 0x0002 |
| GR_EVENT_BTN_RIGHT - 0x0004 |
This is an event timestamp in milliseconds since application start
| GR_EVENT_RELEASE_IN |
| GR_EVENT_RELEASE_OUT |
This parameter is dependent on the availability of z- co-ordinate information
A touchscreen has been pressed. This event is emitted where are two or more contact points. Currently multi-touch events are only supported on the Android platform.
Data
uint32_t button
uint32_t timestamp
int16_t subtype
int16_t x
int16_t y
int16_t z
Where:
| GR_EVENT_BTN_LEFT - 0x0001: if this is a touchscreen then the button is always left |
| GR_EVENT_BTN_MIDDLE - 0x0002 |
| GR_EVENT_BTN_RIGHT - 0x0004 |
This is an event timestamp in milliseconds since application start
| GR_EVENT_RELEASE_IN |
| GR_EVENT_RELEASE_OUT |
This parameter is dependent on the availability of z- co-ordinate information
A touchscreen has been released. This event is emitted when there are two or more contact points. Currently multi-touch events are only supported on the Android platform.
Data
uint32_t button
uint32_t timestamp
int16_t subtype
int16_t x
int16_t y
int16_t z
Where:
| GR_EVENT_BTN_LEFT - 0x0001: if this is a touchscreen then the button is always left |
| GR_EVENT_BTN_MIDDLE - 0x0002 |
| GR_EVENT_BTN_RIGHT - 0x0004 |
This is an event timestamp in milliseconds since application start
| GR_EVENT_RELEASE_IN |
| GR_EVENT_RELEASE_OUT |
This parameter is dependent on the availability of z- co-ordinate information
A mouse/touchscreen has entered a control (if dragging a pointer or finger). This event is generated once the coordinates enter a control boundary. If mouse motion events are disabled in the render manager then this event will not be generated.
Data
uint32_t button
uint32_t timestamp
int16_t subtype
int16_t x
int16_t y
int16_t z
Where:
| GR_EVENT_BTN_LEFT - 0x0001: if this is a touchscreen then the button is always left |
| GR_EVENT_BTN_MIDDLE - 0x0002 |
| GR_EVENT_BTN_RIGHT - 0x0004 |
This is an event timestamp in milliseconds since application start
| GR_EVENT_RELEASE_IN |
| GR_EVENT_RELEASE_OUT |
This parameter is dependent on the availability of z- co-ordinate information
A mouse/touchscreen has left a control (if dragging a pointer or finger). This event is generated once the coordinates leave a control boundary. If mouse motion events are disabled in the render manager then this event will not be generated.
Data
uint32_t button
uint32_t timestamp
int16_t subtype
int16_t x
int16_t y
int16_t z
Where:
| GR_EVENT_BTN_LEFT - 0x0001: if this is a touchscreen then the button is always left |
| GR_EVENT_BTN_MIDDLE - 0x0002 |
| GR_EVENT_BTN_RIGHT - 0x0004 |
This is an event timestamp in milliseconds since application start
| GR_EVENT_RELEASE_IN |
| GR_EVENT_RELEASE_OUT |
This parameter is dependent on the availability of z- co-ordinate information
The following events are generated if a keyboard is present and supported by the render manager.
A key is in the pressed state
Data
uint32_t code
uint32_t modifiers
Where:
This is the UTF-8 key value
A set of modifiers applied to the key
| GR_EVENT_KEYMOD_ALT |
| GR_EVENT_KEYMOD_CTRL |
| GR_EVENT_KEYMOD_SHIFT |
The following events are generated by the Screen Manager during screen transitions. These events are generated in the following order:
gre.screenshow.pre delivered to target (end)
screen |
gre.screenhide.pre delivered to source (start)
screen |
gre.screenshow.post delivered to target (end)
screen |
gre.screenhide.post delivered to source (start)
screen |
A screen is being shown. This event is triggered before the screen is shown and signifies that a transition may be starting
Data:
The name of the screen which is being shown
A screen has been shown. This event is triggered after the screen is shown and signifies that a transition has ended.
Data:
The name of the screen which has been shown
A screen is being hidden. This event is triggered before the screen is hidden and signifies that a transition may be starting.
Data:
The name of the screen which is being hidden
The following events are generated on a change of control focus. If there is no focusable control on the current screen then these events will not be generated. These events are targeted at the currently or last focused control. When focus shifts from one control to another the lost focus event is sent first followed by the got focus event.
A control has received focus, delivered to the control that received the focus.
No data payload.
The following events are generated by a Table control. If no table control is present then these events will not be generated.
A table has been resized via the table resize action. This event notifies the system of the new table size and visible area.
Data:
uint32_t top_row
uint32_t left_col
uint32_t bot_row;
uint32_t right_col;
char *table
Where:
The top row that is visible
The left column that is visible
The bottom row that is visible
The right column that is visible
The name of the table whose viewport changed to cause this event
A table cell has received focus and is the currently active cell. This is delivered to the control template with the cell focus information.
Data:
uint32_t row;
uint32_t col;
char *table
Where:
The row that received focus
The column that received focus
The name of the table where the cell focus changed
A table cell has lost focus and is no longer the active cell. This is delivered to the control template with the cell focus information
Data:
uint32_t row;
uint32_t col;
char *table
Where:
The row that received focus
The column that received focus
The name of the table where the cell focus changed
The following events are only generated when running on Android.
The Android application has resumed and has gained the foreground. This happens when the user starts the application or switches to the application. This does not mean the application is rendered yet.
Data:
No data payload
The Android application has paused and has lost its foregrounded state. This happens when the user switches applications or returns to the home screen.
Data:
No data payload