| Entry | |
|---|---|
| R0 | Window handle, or -1 to turn off |
| R1 | Icon handle, or -1 for caret in window work area |
| R2 | X offset |
| R3 | Y offset |
| R4 | Caret Flags, or -1 if none |
| R5 | Index into string, or -1 if writeable icon |
The purpose of this call is to move the caret to a new position..
The index value is a byte index, and not a character index. Therefore, there is only a distinction when the system alphabet is UTF8.
Tasks are informed of a window gaining or losing input focus by Gain_Caret and Lose_Caret events via Wimp_Poll.