Wimp_CreateIcon (icon bar syntax)
Programmer's Reference Manuals
» Part 7 - The Desktop
» The Window Manager
» SWI Calls
» Wimp_CreateIcon
» Wimp_CreateIcon (icon bar syntax)
Wimp_ CreateIcon (icon bar syntax)
(SWI &400C2)
| Entry | |
|---|---|
| R0 | Icon Priority, or |
| Icon handle number | |
| R1 | Pointer to block |
| +0 | Icon bar Position |
| +4 | Icon Block |
| Exit | |
|---|---|
| R0 | Icon handle |
Use
This purpose of this call is to create and display an icon on the icon bar. An icon can be positioned next to a specific icon, or displayed in order of priority.
Icon bar Position
A list of all the different methods an icon can be positioned on the icon bar is in the Icon bar Position page.
The Wimp is able to group icons together on the icon bar if values -3 or -4 are used. Icons can also be positioned based in the order of their priority.
Icon Priority
This is used to specify the placement of an icon in relation to other icon priority values. Icons with higher values are placed towards the outer edge of the icon bar, which is determined by the scan direction.
For a list of common desktop module priority values, please see the Icon Priority page.
Icon Block
The icon block contains all the information required to create the icon itself. The block starts at R1+4 for this call. A full detailed description can be found in the Icon Block page.