h6. [[WindowManager]] h6(. » [[WindowManager SWI Calls|SWI Calls]] h6((. » [[Wimp_CreateIcon]] h6(((. » Wimp_CreateIcon (icon bar syntax) h2. Wimp_CreateIcon (icon bar syntax) h5. (SWI &400C2) |_<. Entry | | |/2^. R0 | [[Icon Priority|Icon Priority]], or | | Icon handle number | |R1 |Pointer to block | |>. +0 |[[Icon Bar Position|Icon bar Position]] | |>. +4 |[[Icon Block|Icon Block]] | |_<. Exit | | |R0 |Icon handle | h4. 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. h4(#iconbar_position). 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|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. h4(#icon_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|Icon Priority]] page. h4(#icon_block). 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|Icon Block]] page. h4. See also * [[Wimp_CreateIcon (window syntax)|Wimp_CreateIcon (window syntax)]] * [[Wimp_DeleteIcon|Wimp_DeleteIcon]] * [[Wimp_CreateWindow|Wimp_CreateWindow]]