GetIcon

Obtain handle to a specified 'ICON' resource

#include <ToolUtils.h> Toolbox Utilities

short iconID ; resource ID of desired icon

returns Handle leading to 128 bytes of image data

GetIcon searches all open resource files until it finds the specified icon. It

reads the resource from disk (if necessary) and returns a handle to a

128-byte bit-image of the icon.

iconID is the resource identifier of the desired icon.

Returns: a 32-bit Handle leading to the icon's bit image. If the resource ID

iconID can't be found, the return value is NIL.

Notes: There is no special data type for an icon. It is just 128-bytes of bit data,

arranged as 32 rows of 4 bytes-per-row (32 x 32 bits).

GetIcon is functionally equivalent to:

myIconHandle = GetResource( 'ICON', iconID );

Use PlotIcon to display the icon (in srcCopy mode), or build a BitMap

structure and use CopyBits to display it yourself (see the example under

indexed 'ICN#' resource. No rule requires icons to be in a resource; you

may build one via StuffHex or just define it as a data item.

Referenced by (18):