Purpose

To draw an icon.

Syntax

winio@('%ic[icon_name]')
winio@('%`ic', handle)
integer(7) handle     (input)

Modifiers

Grave accent (`) - use a Windows API handle.

Caret (^) - the call-back function is called when the user clicks on the icon.

Question mark (?) - a help string is supplied.

Description

icon_name is a standard character string (can be replaced by @) associated with a icon file in a resource script.

handle is a value returned by a modified form of the API function LoadIcon.

Icons can include transparent regions where the background can be seen. They can be of any size. Standard sizes are 16x16, 32x32, 48x48 and 64x64 pixels. Icons can be monochrome or use 16 or 256 colours.

icon_name can also take the form of an integer handle surrounded by curly brackets (this is integer kind=7) or the name of an external file surrounded by curly brackets.

%`ic[static] gives a "static" image rather than a control that can have a callback function.  The image can be supplied as an argument that has the value returned by a call to LoadResource@.

Example

winio@('%^ic[myicon]',cb_func)

myicon ICON file.ico      (resource file)

See also

make_icon@,%bm (Bitmap),%gi (GIF)