MiniGUI API Reference (MiniGUI-Standalone)
v4.0.0
A mature and proven cross-platform GUI system for embedded and smart IoT devices
|
Macros | |
#define | MSG_EXIN_AXIS 0x0070 |
Indicates an axis input event. More... | |
#define | MSG_EXIN_BUTTONDOWN 0x0071 |
Indicates the user has pressed a button on joystick or other input device. More... | |
#define | MSG_EXIN_BUTTONUP 0x0072 |
Indicates the user has released a button on joystick or other input device. More... | |
#define | MSG_EXIN_TOUCH_DOWN 0x0073 |
Indicates a touch down event. More... | |
#define | MSG_EXIN_TOUCH_UP 0x0074 |
Indicates a touch up event. More... | |
#define | MSG_EXIN_TOUCH_MOTION 0x0075 |
Indicates a touch move event. More... | |
#define | MSG_EXIN_TOUCH_CANCEL 0x0076 |
Indicates a cancelled touch event. More... | |
#define | MSG_EXIN_TOUCH_FRAME 0x0077 |
Indicates the end of a set of touchpoints at one device sample time. More... | |
#define | MSG_EXIN_SWITCH_TOGGLE 0x007A |
Indicates the toggle event of a switch. More... | |
#define | MSG_EXIN_GESTURE_SWIPE_BEGIN 0x0080 |
Indicates the beginning of a swipe gesture. More... | |
#define | MSG_EXIN_GESTURE_SWIPE_UPDATE 0x0081 |
Indicates update of a swipe gesture. More... | |
#define | MSG_EXIN_GESTURE_SWIPE_END 0x0082 |
Indicates the end of a swipe gesture. More... | |
#define | MSG_EXIN_GESTURE_PINCH_BEGIN 0x0083 |
Indicates the beginning of a pinch gesture. More... | |
#define | MSG_EXIN_GESTURE_PINCH_UPDATE 0x0084 |
Indicates the beginning of a pinch gesture. More... | |
#define | MSG_EXIN_GESTURE_PINCH_END 0x0085 |
Indicates the end of a swipe gesture. More... | |
#define | MSG_EXIN_END_CHANGES 0x008F |
Indicates the end of one or more parameter changes of one hardware event. More... | |
#define | MSG_EXIN_TABLET_TOOL_AXIS 0x0090 |
Indicates an axis of the tablet tool has changed state. More... | |
#define | MSG_EXIN_TABLET_TOOL_PROXIMITY 0x0091 |
Indicates that a tool has come in or out of proximity of the tablet. More... | |
#define | MSG_EXIN_TABLET_TOOL_TIP 0x0092 |
Indicates that a tool has come in contact with the surface of the tablet. More... | |
#define | MSG_EXIN_TABLET_TOOL_BUTTON 0x0093 |
Indicates that a tool has changed a logical button state on the tablet. More... | |
#define | MSG_EXIN_TABLET_PAD_BUTTON 0x0094 |
Indicates that a button pressed on the tablet pad. More... | |
#define | MSG_EXIN_TABLET_PAD_RING 0x0095 |
Indicates that a status change on the tablet ring. More... | |
#define | MSG_EXIN_TABLET_PAD_STRIP 0x0096 |
Indicates that a status change on the tablet strip. More... | |
#define | MSG_EXIN_USER_BEGIN 0x009A |
Indicates that the beginning of a user-defined extra input event. More... | |
#define | MSG_EXIN_USER_UPDATE 0x009B |
Indicates that the update of a user-defined extra input event. More... | |
#define | MSG_EXIN_USER_END 0x009C |
Indicates that the end of a user-defined extra input event. More... | |
In addition to the standard keyboard and mouse messages, MiniGUI generates extra input messages for input events from other input devices, including multi-touch panel, tablet pad, joystick, and so on. We call these messages as 'extra input messages'. The messages can be classified the following types:
Note that the buttons other than left, right, and middle buttons on a mouse will be treated as generic buttons.
Since 4.0.0.
#define MSG_EXIN_AXIS 0x0070 |
Indicates an axis input event.
This message is sent to the active window when the user operates the axis of a pointer device such as a mouse.
scroll | one of AXIS_SCROLL_VERTICAL or AXIS_SCROLL_HORIZONTAL |
source | one of AXIS_SOURCE_WHEEL, AXIS_SOURCE_FINGER, AXIS_SOURCE_CONTINUOUS, or AXIS_SOURCE_WHEEL_TILT. |
value | The axis value. |
value_discrete | The axis value in discrete steps. |
#define MSG_EXIN_BUTTONDOWN 0x0071 |
Indicates the user has pressed a button on joystick or other input device.
This message is sent to the active window when the user pressed a button on joystick or other input device.
button | The button value. On Linux, the button values are defined in <linux/input-event-codes.h> file, and with BTN_ prefix. |
nr_down_btns | The total number of buttons pressed. |
#define MSG_EXIN_BUTTONUP 0x0072 |
Indicates the user has released a button on joystick or other input device.
This message is sent to the active window when the user released a button on joystick or other input device.
button | The button value. On Linux, the button values are defined in <linux/input-event-codes.h> file, and with BTN_ prefix. |
nr_down_btns | The total number of buttons pressed. |
#define MSG_EXIN_END_CHANGES 0x008F |
Indicates the end of one or more parameter changes of one hardware event.
count | The count of parameters changed. |
#define MSG_EXIN_GESTURE_PINCH_BEGIN 0x0083 |
Indicates the beginning of a pinch gesture.
nr_figures | The number of fingers used for the gesture. |
scale | The absolute scale of a pinch gesture. The scale is the division of the current distance between the fingers and the distance at the start of the gesture. Note that the initial scale value is 100. |
#define MSG_EXIN_GESTURE_PINCH_END 0x0085 |
Indicates the end of a swipe gesture.
nr_figures | The number of fingers used for the gesture. |
is_cancelled | TRUE if the gesture ended normally, or if it was cancelled. |
scale | The absolute scale of a pinch gesture. The scale is the division of the current distance between the fingers and the distance at the start of the gesture. Note that the initial scale value is 100. |
#define MSG_EXIN_GESTURE_PINCH_UPDATE 0x0084 |
Indicates the beginning of a pinch gesture.
scale | The absolute scale of a pinch gesture. The scale is the division of the current distance between the fingers and the distance at the start of the gesture. Note that the initial scale value is 100. |
da | The angle delta in 1/50 degrees between the last and the current MSG_EXIN_GESTURE_PINCH_UPDATE message. |
dx,dy | The motion delta between the last and the current MSG_EXIN_GESTURE_PINCH_UPDATE message. |
#define MSG_EXIN_GESTURE_SWIPE_BEGIN 0x0080 |
Indicates the beginning of a swipe gesture.
nr_figures | The number of fingers used for the gesture. |
#define MSG_EXIN_GESTURE_SWIPE_END 0x0082 |
Indicates the end of a swipe gesture.
nr_figures | The number of fingers used for the gesture. |
is_cancelled | TRUE if the gesture ended normally, or if it was cancelled. |
#define MSG_EXIN_GESTURE_SWIPE_UPDATE 0x0081 |
#define MSG_EXIN_SWITCH_TOGGLE 0x007A |
Indicates the toggle event of a switch.
switch_id | The identifier of the switch, one of SWITCH_LID or SWITCH_TABLET_MODE. |
switch_state | The state of the switch, one of SWITCH_STATE_ON or SWITCH_STATE_OFF. |
#define MSG_EXIN_TABLET_PAD_BUTTON 0x0094 |
Indicates that a button pressed on the tablet pad.
mode | The mode the button that triggered this event is in. |
button_number | The button number, which is NOT a semantic button code as defined in <linux/input.h>. |
button_state | The button state, can be TABLET_BUTTON_STATE_RELEASED or TABLET_BUTTON_STATE_PRESSED. |
#define MSG_EXIN_TABLET_PAD_RING 0x0095 |
Indicates that a status change on the tablet ring.
mode | The mode the ring that triggered this event is in. |
source | The source of the event, can be TABLET_PAD_RING_SOURCE_UNKNOWN or TABLET_PAD_RING_SOURCE_FINGER. |
position | The current position of the ring, in 1/50 degrees counterclockwise from the northern-most point of the ring in the tablet's current logical orientation. When the source is TABLET_PAD_RING_SOURCE_FINGER and the finger is lifted from the ring the value will be less than 0. |
number | The number of the ring that has changed state, with 0 being the first ring |
#define MSG_EXIN_TABLET_PAD_STRIP 0x0096 |
Indicates that a status change on the tablet strip.
mode | The mode the strip that triggered this event is in. |
source | The source of the event, can be TABLET_PAD_STRIP_SOURCE_UNKNOWN or TABLET_PAD_STRIP_SOURCE_FINGER. |
position | The current position of the strip, normalized to the range [0, 100]. When the source is TABLET_PAD_STRIP_SOURCE_FINGER and the finger is lifted from the strip, the value will be less than 0. |
number | The number of the strip that has changed state, with 0 being the first strip. |
#define MSG_EXIN_TABLET_TOOL_AXIS 0x0090 |
Indicates an axis of the tablet tool has changed state.
For a tablet tool, one or more axes may changed in one hardware event. MiniGUI will send one or more MSG_EXIN_TABLET_TOOL_XXX messages followed by a MSG_EXIN_END_CHANGES message to the current active window. Each MSG_EXIN_TABLET_TOOL_XXX message for a changed axis.
which | The axis identifier, can be one of the following identifiers:
|
value | The value of the axis. |
#define MSG_EXIN_TABLET_TOOL_BUTTON 0x0093 |
Indicates that a tool has changed a logical button state on the tablet.
button | The button identifier, which is a semantic button code as defined in <linux/input.h>. |
state | The button state, can be TABLET_BUTTON_STATE_RELEASED or TABLET_BUTTON_STATE_PRESSED. |
#define MSG_EXIN_TABLET_TOOL_PROXIMITY 0x0091 |
Indicates that a tool has come in or out of proximity of the tablet.
For a tablet tool, one or more axes may changed in one hardware event. MiniGUI will send one or more MSG_EXIN_TABLET_TOOL_XXX messages followed by a MSG_EXIN_END_CHANGES message to the current active window. Each MSG_EXIN_TABLET_TOOL_XXX message for a changed axis.
which | The axis identifier, please see |
state | The proximity state, can be TABLET_TOOL_PROXIMITY_STATE_OUT or TABLET_TOOL_PROXIMITY_STATE_IN. |
value | The value of the axis. |
#define MSG_EXIN_TABLET_TOOL_TIP 0x0092 |
Indicates that a tool has come in contact with the surface of the tablet.
For a tablet tool, one or more axes may changed in one hardware event. MiniGUI will send one or more MSG_EXIN_TABLET_TOOL_XXX messages followed by a MSG_EXIN_END_CHANGES message to the current active window. Each MSG_EXIN_TABLET_TOOL_XXX message for a changed axis.
which | The axis identifier, please see |
state | The tip state, can be TABLET_TOOL_TIP_UP or TABLET_TOOL_TIP_DOWN. |
value | The value of the axis. |
#define MSG_EXIN_TOUCH_CANCEL 0x0076 |
#define MSG_EXIN_TOUCH_DOWN 0x0073 |
Indicates a touch down event.
x,y | The position of touch. |
#define MSG_EXIN_TOUCH_FRAME 0x0077 |
Indicates the end of a set of touchpoints at one device sample time.
slot | The slot of the touch event. Please see the Linux kernel's multitouch protocol B documentation for more information. If the touch event has no assigned slot, for example, if it is from a single touch device, slot will be -1. |
seat_slot | The seat slot of the touch event. A seat slot is a non-negative seat wide unique identifier of an active touch point. |
#define MSG_EXIN_TOUCH_MOTION 0x0075 |
Indicates a touch move event.
x,y | The position of touch. |
#define MSG_EXIN_TOUCH_UP 0x0074 |
#define MSG_EXIN_USER_BEGIN 0x009A |
Indicates that the beginning of a user-defined extra input event.
wParam | The first parameter of this message. |
lParam | The second parameter of this message. |
#define MSG_EXIN_USER_END 0x009C |
Indicates that the end of a user-defined extra input event.
wParam | The first parameter of this message. |
lParam | The second parameter of this message. |
#define MSG_EXIN_USER_UPDATE 0x009B |
Indicates that the update of a user-defined extra input event.
wParam | The first parameter of this message. |
lParam | The second parameter of this message. |