All Databases Inside Mac - Basic Toolbox

GetIconSuite

Create and fill a new icon family

#include <Icons.h> Finder Interface

OSErr GetIconSuite (theSuite, theID, theSelector );

Handle *theSuite ; icon family

short theID ; resource id of icon family members

long theSelector ; types of icons to add to icon family

returns Error Code; 0 = no error

GetIconSuite will create a new icon family and then fill it with the icons

with the id in theID, of the types indicated by theSelector, from the current

resource chain. This the call that you will probably use most often to create an

icon family.

Notes: GetIconSuite takes a selector value that specifies which icons in the

family to operate on. The values for theSelector are as follows:

svLarge1Bit ÍsvMini8Bit
svLarge4Bit ÍsvAllLargeData
svLarge8Bit ÍsvAllSmallData
svSmall1Bit ÍsvAllMiniData
svSmall4Bit ÍsvAll1BitData
svSmall8Bit ÍsvAll4BitData
svMini1Bit ÍsvAll8BitData
svMini4Bit ÍsvAllAvailableData

If you call SetResLoad (FALSE) before making this call, the suite will be

filled with unloaded resource handles.

This routine is not currently documented in MPW header files (hence, it is

not in any THINK C or THINK Pascal header file either). The information

given above comes from Macintosh Technical Note #306. This tech. note

also gives the inline glue for the call as follows:

pascal OSErr GetIconSuite (Handle *theSuite, short theID,

long theSelector) = {0x303C, 0x0501, 0xABC9};

Referenced by (12):