GetCIcon

Obtain handle to a specified 'cicn' resource

#include <Quickdraw.h> Color QuickDraw

CIconHandle GetCIcon( id );

short id ; resource ID of desired icon

returns CIconHandle leading to the icon's data structure

GetCIcon obtains a CIcon data structure and initializes it from data in the

'cicn' resources for that specific ID.

id is the resource identifier of the desired icon.

Returns: a CIconHandle leading to the icon's bit image. If the

resource ID id can't be found, the return value is NIL.

Notes: Don't call GetCIcon before every call to PlotCIcon -- GetCIcon creates

a new CIcon data structure each time it's called and the overhead will build

up. Also, GetCIcon doesn't dispose of or detach the 'cicn' resource, so they

need to be purgeable.

Referenced by (7):