0
|
1 .TH "SDL_UserEvent" "3" "Mon 12 Mar 2001, 01:03" "SDL" "SDL API Reference"
|
|
2 .SH "NAME"
|
|
3 SDL_UserEvent\- A user-defined event type
|
|
4 .SH "STRUCTURE DEFINITION"
|
|
5 .PP
|
|
6 .nf
|
|
7 \f(CWtypedef struct{
|
|
8 Uint8 type;
|
|
9 int code;
|
|
10 void *data1;
|
|
11 void *data2;
|
|
12 } SDL_UserEvent;\fR
|
|
13 .fi
|
|
14 .PP
|
|
15 .SH "STRUCTURE DATA"
|
|
16 .TP 20
|
|
17 \fBtype\fR
|
|
18 \fBSDL_USEREVENT\fP through to \fBSDL_NUMEVENTS-1\fP
|
|
19 .TP 20
|
|
20 \fBcode\fR
|
|
21 User defined event code
|
|
22 .TP 20
|
|
23 \fBdata1\fR
|
|
24 User defined data pointer
|
|
25 .TP 20
|
|
26 \fBdata2\fR
|
|
27 User defined data pointer
|
|
28 .SH "DESCRIPTION"
|
|
29 .PP
|
|
30 \fBSDL_UserEvent\fR is in the \fBuser\fR member of the structure \fI\fBSDL_Event\fR\fR\&. This event is unique, it is never created by SDL but only by the user\&. The event can be pushed onto the event queue using \fI\fBSDL_PushEvent\fP\fR\&. The contents of the structure members or completely up to the programmer, the only requirement is that \fBtype\fR is a value from \fBSDL_USEREVENT\fP to \fBSDL_NUMEVENTS-1\fP (inclusive)\&.
|
|
31 .SH "EXAMPLES"
|
|
32 .PP
|
|
33 .PP
|
|
34 .nf
|
|
35 \f(CWSDL_Event event;
|
|
36
|
|
37 event\&.type = SDL_USEREVENT;
|
|
38 event\&.user\&.code = my_event_code;
|
|
39 event\&.user\&.data1 = significant_data;
|
|
40 event\&.user\&.data2 = 0;
|
|
41 SDL_PushEvent(&event);\fR
|
|
42 .fi
|
|
43 .PP
|
|
44 .SH "SEE ALSO"
|
|
45 .PP
|
|
46 \fI\fBSDL_Event\fR\fR, \fI\fBSDL_PushEvent\fP\fR
|
|
47 ...\" created by instant / docbook-to-man, Mon 12 Mar 2001, 01:03
|