BlueGrey
calm
Elegant
Català-Valencià – Catalan
中文 – Chinese (Simplified)
中文 – Chinese (Traditional)
Česky – Czech
Dansk – Danish
Nederlands – Dutch
English – English
Suomi – Finnish
Français – French
Deutsch – German
עברית – Hebrew
हिंदी – Hindi
Magyar – Hungarian
Bahasa Indonesia – Indonesian
Italiano – Italian
日本語 – Japanese
한국어 – Korean
Македонски – Macedonian
मराठी – Marathi
Norsk – Norwegian
Polski – Polish
Português – Portuguese
Português – Portuguese (Brazil)
Русский – Russian
Slovenčina – Slovak
Slovenščina – Slovenian
Español – Spanish
Svenska – Swedish
Türkçe – Turkish
Українська – Ukrainian
Oëzbekcha – Uzbek
Subversion Repositories
Kolibri OS
(root)
/
contrib
/
sdk
/
sources
/
SDL-1.2.2
/
docs
/
html
/
event.html
@ 5366
– Rev 5131
Rev
Blame
|
Last modification
|
View Log
|
RSS feed
<
HTML
><
HEAD
><
TITLE
>Events<
/
TITLE
><
META
NAME
=
"GENERATOR"
CONTENT
=
"Modular DocBook HTML Stylesheet Version 1.64
"
><
LINK
REL
=
"HOME"
TITLE
=
"SDL Library Documentation"
HREF
=
"index.html"
><
LINK
REL
=
"UP"
TITLE
=
"SDL Reference"
HREF
=
"reference.html"
><
LINK
REL
=
"PREVIOUS"
TITLE
=
"SDL_WM_GrabInput"
HREF
=
"sdlwmgrabinput.html"
><
LINK
REL
=
"NEXT"
TITLE
=
"SDL Event Structures."
HREF
=
"eventstructures.html"
><
META
NAME
=
"KEYWORD"
CONTENT
=
"events"
><
META
NAME
=
"KEYWORD"
CONTENT
=
"function"
><
/
HEAD
><
BODY
CLASS
=
"CHAPTER"
BGCOLOR
=
"#FFF8DC"
TEXT
=
"#000000"
LINK
=
"#0000ee"
VLINK
=
"#551a8b"
ALINK
=
"#ff0000"
><
DIV
CLASS
=
"NAVHEADER"
><
TABLE
WIDTH
=
"100%"
BORDER
=
"0"
CELLPADDING
=
"0"
CELLSPACING
=
"0"
><
TR
><
TH
COLSPAN
=
"3"
ALIGN
=
"center"
>SDL Library Documentation<
/
TH
><
/
TR
><
TR
><
TD
WIDTH
=
"10%"
ALIGN
=
"left"
VALIGN
=
"bottom"
><
A
HREF
=
"sdlwmgrabinput.html"
>Prev<
/
A
><
/
TD
><
TD
WIDTH
=
"80%"
ALIGN
=
"center"
VALIGN
=
"bottom"
><
/
TD
><
TD
WIDTH
=
"10%"
ALIGN
=
"right"
VALIGN
=
"bottom"
><
A
HREF
=
"eventstructures.html"
>Next<
/
A
><
/
TD
><
/
TR
><
/
TABLE
><
HR
ALIGN
=
"LEFT"
WIDTH
=
"100%"
><
/
DIV
><
DIV
CLASS
=
"CHAPTER"
><
H1
><
A
NAME
=
"EVENT"
>Chapter
8
. Events<
/
A
><
/
H1
><
DIV
CLASS
=
"TOC"
><
DL
><
DT
><
B
>Table of Contents<
/
B
><
/
DT
><
DT
><
A
HREF
=
"event.html#AEN3269"
>Introduction<
/
A
><
/
DT
><
DT
><
A
HREF
=
"eventstructures.html"
>SDL Event Structures.<
/
A
><
/
DT
><
DT
><
A
HREF
=
"eventfunctions.html"
>Event Functions.<
/
A
><
/
DT
><
/
DL
><
/
DIV
><
DIV
CLASS
=
"SECT1"
><
H1
CLASS
=
"SECT1"
><
A
NAME
=
"AEN3269"
>Introduction<
/
A
><
/
H1
><
P
>Event handling allows your application to receive input from the user. Event handling is initalised
(
along with video
)
with a call to:
<
PRE
CLASS
=
"PROGRAMLISTING"
>SDL_Init
(
SDL_INIT_VIDEO
)
;<
/
PRE
>
Interally, SDL stores all the events waiting to be handled in an event queue. Using functions like <
A
HREF
=
"sdlpollevent.html"
><
TT
CLASS
=
"FUNCTION"
>SDL_PollEvent<
/
TT
><
/
A
> and <
A
HREF
=
"sdlpeepevents.html"
><
TT
CLASS
=
"FUNCTION"
>SDL_PeepEvents<
/
TT
><
/
A
> you can observe and handle waiting input events.<
/
P
><
P
>The key to event handling in SDL is the <
A
HREF
=
"sdlevent.html"
><
SPAN
CLASS
=
"STRUCTNAME"
>SDL_Event<
/
SPAN
><
/
A
> union. The event queue itself is composed of a series of <
SPAN
CLASS
=
"STRUCTNAME"
>SDL_Event<
/
SPAN
> unions, one
for
each waiting event. <
SPAN
CLASS
=
"STRUCTNAME"
>SDL_Event<
/
SPAN
> unions are read from the queue with the <
TT
CLASS
=
"FUNCTION"
>SDL_PollEvent<
/
TT
> function and it is then up to the application to process the information stored with them.<
/
P
><
/
DIV
><
/
DIV
><
DIV
CLASS
=
"NAVFOOTER"
><
HR
ALIGN
=
"LEFT"
WIDTH
=
"100%"
><
TABLE
WIDTH
=
"100%"
BORDER
=
"0"
CELLPADDING
=
"0"
CELLSPACING
=
"0"
><
TR
><
TD
WIDTH
=
"33%"
ALIGN
=
"left"
VALIGN
=
"top"
><
A
HREF
=
"sdlwmgrabinput.html"
>Prev<
/
A
><
/
TD
><
TD
WIDTH
=
"34%"
ALIGN
=
"center"
VALIGN
=
"top"
><
A
HREF
=
"index.html"
>Home<
/
A
><
/
TD
><
TD
WIDTH
=
"33%"
ALIGN
=
"right"
VALIGN
=
"top"
><
A
HREF
=
"eventstructures.html"
>Next<
/
A
><
/
TD
><
/
TR
><
TR
><
TD
WIDTH
=
"33%"
ALIGN
=
"left"
VALIGN
=
"top"
>SDL_WM_GrabInput<
/
TD
><
TD
WIDTH
=
"34%"
ALIGN
=
"center"
VALIGN
=
"top"
><
A
HREF
=
"reference.html"
>Up<
/
A
><
/
TD
><
TD
WIDTH
=
"33%"
ALIGN
=
"right"
VALIGN
=
"top"
>SDL Event Structures.<
/
TD
><
/
TR
><
/
TABLE
><
/
DIV
><
/
BODY
><
/
HTML
>