Screen event types

Types of events.

Synopsis:

#include <screen/screen.h>
 
enum {
      SCREEN_EVENT_NONE = 0   
      SCREEN_EVENT_CREATE = 1   
      SCREEN_EVENT_PROPERTY = 2   
      SCREEN_EVENT_CLOSE = 3   
      SCREEN_EVENT_INPUT = 4   
      SCREEN_EVENT_JOG = 5   
      SCREEN_EVENT_POINTER = 6   
      SCREEN_EVENT_KEYBOARD = 7   
      SCREEN_EVENT_USER = 8   
      SCREEN_EVENT_POST = 9   
      SCREEN_EVENT_DISPLAY = 11   
      SCREEN_EVENT_IDLE = 12   
      SCREEN_EVENT_UNREALIZE = 13   
      SCREEN_EVENT_GAMEPAD = 14   
      SCREEN_EVENT_JOYSTICK = 15   
      SCREEN_EVENT_DEVICE = 16   
      SCREEN_EVENT_INPUT_CONTROL = 17   
      SCREEN_EVENT_GESTURE = 18   
      SCREEN_EVENT_MTOUCH_PRETOUCH = 99   
      SCREEN_EVENT_MTOUCH_TOUCH = 100   
      SCREEN_EVENT_MTOUCH_MOVE = 101   
      SCREEN_EVENT_MTOUCH_RELEASE = 102   
};

Since:

BlackBerry 10.0.0

Data:

SCREEN_EVENT_NONE
A blocking event indicating that there are currently no events in the queue.
SCREEN_EVENT_CREATE
Dispatched when a child window is created.
SCREEN_EVENT_PROPERTY
Dispatched when a property is set.
SCREEN_EVENT_CLOSE
Dispatched when a child window is destroyed.
SCREEN_EVENT_INPUT
Dispatched when an unknown input event occurs.
SCREEN_EVENT_JOG
Used to describe various Screen API objects:
  • device: represents a valid input device type; used for a device object's SCREEN_PROPERTY_TYPE
  • event: dispatched when a jog dial input event occurs
  • session: represents a valid input session type; used for a session object's SCREEN_PROPERTY_TYPE
SCREEN_EVENT_POINTER
Used to describe various Screen API objects:
  • device: represents a valid input device type; used for a device object's SCREEN_PROPERTY_TYPE
  • event: dispatched when a pointer input event occurs
  • session: represents a valid input session type; used for a session object's SCREEN_PROPERTY_TYPE
SCREEN_EVENT_KEYBOARD
Used to describe various Screen API objects:
  • device: represents a valid input device type; used for a device object's SCREEN_PROPERTY_TYPE
  • event: dispatched when a keyboard input event occurs
  • session: represents a valid input session type; used for a session object's SCREEN_PROPERTY_TYPE
SCREEN_EVENT_USER
Dispatched when a user event is detected.
SCREEN_EVENT_POST
Dispatched when a child window has posted its first frame.
SCREEN_EVENT_DISPLAY
Dispatched when an external display is detected.
SCREEN_EVENT_IDLE
Dispatched when the window enters an idle state.
SCREEN_EVENT_UNREALIZE
Dispatched when a handle to a window is lost.
SCREEN_EVENT_GAMEPAD
Used to describe various Screen API objects:
  • device: represents a valid input device type; used for a device object's SCREEN_PROPERTY_TYPE
  • event: dispatched when a gamepad input event occurs
  • session: represents a valid input session type; used for a session object's SCREEN_PROPERTY_TYPE
SCREEN_EVENT_JOYSTICK
Used to describe various Screen API objects:
  • device: represents a valid input device type; used for a device object's SCREEN_PROPERTY_TYPE
  • event: dispatched when a joystick input event occurs
  • session: represents a valid input session type; used for a session object's SCREEN_PROPERTY_TYPE
SCREEN_EVENT_DEVICE
Dispatched when an input device is detected.
SCREEN_EVENT_INPUT_CONTROL
Dispatched when changes to the input state require that a notification be sent to the application for the event processing to be performed correctly.

This includes gestures that may start without a touch or button press; or end without a release.

Since: BlackBerry 10.2.0

SCREEN_EVENT_GESTURE
Used to describe a device or event API object:
  • device: represents a valid input device type; used for a device object's SCREEN_PROPERTY_TYPE
  • event: dispatched when a gesture-based input event occurs or when gesture recognition is enabled on a touch or pointer device.

Since: BlackBerry 10.3.0

SCREEN_EVENT_MTOUCH_PRETOUCH
Dispatched when a multi-touch event is detected before it can be properly resolved.

This event is used to help reduce latency when touch processing requires several samples before a touch event can be formulated. Any handling of delayed touch events should keep in mind that the event is very likely to be aborted by an input control event.

Since: BlackBerry 10.3.0

SCREEN_EVENT_MTOUCH_TOUCH
Used to describe various Screen API objects:
  • device: represents a valid input device type; used for a device object's SCREEN_PROPERTY_TYPE
  • event: dispatched when a multi-touch event is detected
  • session: represents a valid input session type; used for a session object's SCREEN_PROPERTY_TYPE
SCREEN_EVENT_MTOUCH_MOVE
Dispatched when a multi-touch move event is detected.

For example, when the user moves his or her fingers to make an input gesture.

SCREEN_EVENT_MTOUCH_RELEASE
Dispatched when a multi-touch release event occurs, or when the user completes the multi-touch gesture.

Library:

libscreen (For the qcc command, use the -l screen option to link against this library)

Description:

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus