Wiki Page Content

Differences between revisions 15 and 16
Revision 15 as of 2015-04-26 19:22:03
Size: 1441
Comment: Sorted related functions, see SGStructures.
Revision 16 as of 2015-10-29 21:58:30
Size: 1487
Comment: Added comment about SDL_zero() in example (Feedback 2015-10-03).
Deletions are marked like this. Additions are marked like this.
Line 22: Line 22:
    SDL_zero(event);     SDL_memset(&event, 0, sizeof(event)); /* or SDL_zero(event) */

SDL_UserEvent

A structure that contains an application-defined event type.

Data Fields

Uint32

type

value obtained from SDL_RegisterEvents()

Uint32

timestamp

timestamp of the event

Uint32

windowID

the associated window, if any

Sint32

code

user defined event code

void*

data1

user defined data pointer

void*

data2

user defined data pointer

Code Examples

Uint32 myEventType = SDL_RegisterEvents(1);
if (myEventType != ((Uint32)-1)) {
    SDL_Event event;
    SDL_memset(&event, 0, sizeof(event)); /* or SDL_zero(event) */
    event.type = myEventType;
    event.user.code = my_event_code;
    event.user.data1 = significant_data;
    event.user.data2 = 0;
    SDL_PushEvent(&event);
}

Remarks

SDL_UserEvent is in the user member of the SDL_Event union. 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().


CategoryStruct, CategoryEvents

None: SDL_UserEvent (last edited 2015-10-29 21:58:30 by PhilippWiesemann)

Feedback
Please include your contact information if you'd like to receive a reply.
Submit