Safeguarding the past, present and future of RISC OS for everyone
Gain_Caret
WindowManager
» 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.
See also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.