screen_get_event_property_iv()
Graphics and Screen4.0 (8.x)Screen Graphics Subsystem Developer's GuideAPIProgrammingUtilities
Retrieve the current value of the specified event property of type integer
Synopsis:
#include <screen/screen.h>
int screen_get_event_property_iv(screen_event_t ev,
int pname,
int *param)
Arguments:
- ev
- The handle of the event whose property is being queried. The event must have an event type of Screen event types.
- pname
- The name of the property whose value is being queried. The properties available for query are of type Screen property types.
- param
- A pointer to a buffer where this function stores the retrieved value(s). This buffer must be of type
int
. The buffer may be a single integer or an array of integers, depending on the property being retrieved.
Library:
libscreenDescription:
Function Type: Immediate Execution
This function stores the current value of an event property in a user-provided buffer. The list of properties that can be queried per event type are listed as follows:
Event Type: SCREEN_EVENT_DISPLAY
Event Type: SCREEN_EVENT_GAMEPAD
Event Type: SCREEN_EVENT_GESTURE
Event Type: SCREEN_EVENT_IDLE
Event Type: SCREEN_EVENT_INPUT_CONTROL
- SCREEN_PROPERTY_BUTTONS (only for events with name SCREEN_INPUT_CONTROL_POINTER_START or SCREEN_INPUT_CONTROL_POINTER_STOP)
- SCREEN_PROPERTY_DEVICE
- SCREEN_PROPERTY_NAME
- SCREEN_PROPERTY_TOUCH_ID (only for events with name SCREEN_INPUT_CONTROL_MTOUCH_START or SCREEN_INPUT_CONTROL_MTOUCH_STOP)
Event Type: SCREEN_EVENT_JOYSTICK
Event Type: SCREEN_EVENT_KEYBOARD
Event Types: SCREEN_EVENT_MTOUCH_PRETOUCH, SCREEN_EVENT_MTOUCH_TOUCH, SCREEN_EVENT_MTOUCH_MOVE, SCREEN_EVENT_MTOUCH_RELEASE
- SCREEN_PROPERTY_BUTTONS
- SCREEN_PROPERTY_DEVICE
- SCREEN_PROPERTY_MODIFIERS
- SCREEN_PROPERTY_POSITION
- SCREEN_PROPERTY_SEQUENCE_ID
- SCREEN_PROPERTY_SIZE
- SCREEN_PROPERTY_SOURCE_POSITION
- SCREEN_PROPERTY_SOURCE_SIZE
- SCREEN_PROPERTY_TOUCH_ID
- SCREEN_PROPERTY_TOUCH_ORIENTATION
- SCREEN_PROPERTY_TOUCH_PRESSURE
- SCREEN_PROPERTY_TOUCH_TYPE
Event Type: SCREEN_EVENT_POINTER
Event Type: SCREEN_EVENT_PROPERTY
Event Type: SCREEN_EVENT_USER
Returns:
0
if successful, or -1
if an error occurred (errno
is set; refer to errno.h
for more details).
Page updated: