Wimp_SetIconState (changes)
Showing changes from revision #1 to #2:
Added | Removed | Changed
Programmer's WindowManager Reference Manuals
» Part 7 - The Desktop?SWI Calls
» Wimp_SetIconStateThe Window Manager
» SWI Calls?
» Wimp_SetIconState
Wimp_SetIconState
(SWI &400CD)
| Entry | |
|---|---|
| R1 | Pointer to block |
| Block | |
| +0 | Window handle (-1 or -2 for icon bar) |
| +4 | Icon handle |
| +8 | EOR word |
| +12 | Clear word |
| Exit | |
|---|---|
| R0 | Corrupt |
Use
The purpose of this call is to set value of an icons Icon Flag by the setting of the individual bits.
Notes
This call sets the icon flags ‘state’ at the bit level. It does this by the following method:
new state = (old state AND NOT 'clear word') EOR 'EOR word'
A combination of the EOR word and the clear word determines the value of the bits of the current icon flag. The table below shows how the bits are set when the EOR and clear words are used.
| Clear | EOR | Meaning |
| 0 | 0 | Preserve the bit’s status |
| 0 | 1 | Toggle the bit’s state |
| 1 | 0 | Clear the bit |
| 1 | 1 | Set the bit |
Any change to the icon flag will result in the icon being updated automatically on screen, however, if the justification of the icon is changed, and the icon has the input focus, then Wimp_SetCaretPosition should be called to make sure the caret remains at the correct text position.
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.