Allocate a set of user-defined events, and return the beginning event number for that set of events.
int numevents); Uint32 SDL_RegisterEvents(
numevents | the number of events to be allocated |
Returns the beginning event number, or (Uint32)-1 if there are not enough user-defined events left.
Calling this function with numevents
<= 0 is an error and will return (Uint32)-1.
Note, (Uint32)-1 means the maximum unsigned 32-bit integer value (or 0xFFFFFFFF), but is clearer to write.
This function is available since SDL 3.0.0.
<<Include(SDL_UserEvent, , , from="== Code Examples ==", to="== Remarks ==")>>