Size: 2294
Comment: cleaned up and confirmed some pending comments
|
← Revision 15 as of 2015-04-26 19:50:04 ⇥
Size: 2300
Comment: Hid green comment in comment.
|
Deletions are marked like this. | Additions are marked like this. |
Line 36: | Line 36: |
<<Anchor(action)>> '''action''' may be any of the following <<Color2(col=green,text="(from enum SDL_eventaction which has no page)")>>: | <<Anchor(action)>> '''action''' may be any of the following: /* <<Color2(col=green,text="(from enum SDL_eventaction which has no page)")>> */ |
DRAFT |
SDL_PeepEvents
Use this function to check the event queue for messages and optionally return them.
Contents
Syntax
int SDL_PeepEvents(SDL_Event* events,
int numevents,
SDL_eventaction action,
Uint32 minType,
Uint32 maxType)
Function Parameters
events |
destination buffer for the retrieved events |
numevents |
if action is SDL_ADDEVENT, the number of events to add back to the event queue; if action is SDL_PEEKEVENT or SDL_GETEVENT, the maximum number of events to retrieve |
action |
action to take; see Remarks for details |
minType |
minimum value of the event type to be considered; SDL_FIRSTEVENT is a safe choice |
maxType |
maximum value of the event type to be considered; SDL_LASTEVENT is a safe choice |
Return Value
Returns the number of events actually stored or a negative error code on failure; call SDL_GetError() for more information.
Code Examples
Add a code example here.
Remarks
action may be any of the following:
SDL_ADDEVENT |
up to numevents events will be added to the back of the event queue |
SDL_PEEKEVENT |
up to numevents events at the front of the event queue, within the specified minimum and maximum type, will be returned and will not be removed from the queue |
SDL_GETEVENT |
up to numevents events at the front of the event queue, within the specified minimum and maximum type, will be returned and will be removed from the queue |
This function is thread-safe.
You may have to call SDL_PumpEvents() before calling this function. Otherwise, the events may not be ready to be filtered when you call SDL_PeepEvents().