Updated: April 19, 2023 |
Types of notifications
#include <screen/screen.h>
enum { SCREEN_NOTIFY_UPDATE = 1, SCREEN_NOTIFY_INPUT = 2, SCREEN_NOTIFY_EVENT = 3, SCREEN_NOTIFY_DISPLAY = 4 };
When you register for SCREEN_NOTIFY_UPDATE notifications, Screen still adds SCREEN_EVENT_POST events to your context's event queue when applicable.
When you register for SCREEN_NOTIFY_INPUT notifications with a NULL object, then you receive notifications when any input device is sending input
When you register for SCREEN_NOTIFY_EVENT notifications for any of the above API objects, Screen sends a notification when a property has been changed on that specified object. If the property change also invokes Screen to send a SCREEN_EVENT_PROPERTY event, then you will receive this event in your context's event queue in addition to the notification; otherwise, you receive only the notification. Refer to Screen property types to determine whether a property sends a change event.
When you register for SCREEN_NOTIFY_EVENT notifications with a NULL object, then you receive one notification for each event that's residing in your context's event queue (i.e., one notification for each event that you can call screen_get_event() to retrieve).