Scroll to navigation

SDL_UserEvent(3type) SDL3 DATATYPES SDL_UserEvent(3type)

NAME

SDL_UserEvent - A user-defined event type (event.user.*)

HEADER FILE

Defined in SDL3/SDL_events.h

SYNOPSIS

#include "SDL3/SDL.h"
typedef struct SDL_UserEvent
{
    Uint32 type;        /**< SDL_EVENT_USER through SDL_EVENT_LAST-1, Uint32 because these are not in the SDL_EventType enumeration */
    Uint32 reserved;
    Uint64 timestamp;   /**< In nanoseconds, populated using SDL_GetTicksNS() */
    SDL_WindowID windowID; /**< The associated window if any */
    Sint32 code;        /**< User defined event code */
    void *data1;        /**< User defined data pointer */
    void *data2;        /**< User defined data pointer */
} SDL_UserEvent;

DESCRIPTION

This event is unique; it is never created by SDL, but only by the application. The event can be pushed onto the event queue using

SDL_PushEvent (). The contents of the structure members are completely up to the programmer; the only requirement is that '''type''' is a value obtained from SDL_RegisterEvents ().

AVAILABILITY

This struct is available since SDL 3.1.3.

SDL 3.1.6 Simple Directmedia Layer