A fast and easily customised operating system
for ARM devices
Gain_Caret
Programmer's Reference Manuals
» Part 7 - The Desktop
» The Window Manager
» SWI Calls
» Wimp_Poll
» Reason Codes
» Gain_Caret
Gain_Caret
(Reason Code 12)
| Exit | |
|---|---|
| Block | |
| +0 | Window handle |
| +4 | Icon handle, or -1 if none |
| +8 | X offset (relative to window origin) |
| +12 | Y offset (relative to window origin) |
| +16 | Caret Flags |
| +20 | Index into string, or -1 if none |
Use
This code is returned from Wimp_Poll and indicates that the window has now received the input focus.
Notes
This event usually occurs due to a user clicking on an icon or window that accepts text. It can also happen if an application explicitly calls Wimp_SetCaretPosition.
Windows and icons can be set to accept text by setting the button types within the window flag and icon flags respectively.
This event code is not generated if the input focus changes within the same window.