Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 5 - Icon Utilities / Icon Utilities Reference

Icon Utilities Routines / Creating an Icon Suite

NewIconSuite

You can use the NewIconSuite function to get a handle to an empty icon suite.
Then you can use AddIconToSuite to add handles to icon data.

FUNCTION NewIconSuite (VAR theIconSuite: Handle): OSErr;

theIconSuite

NewIconSuite allocates the memory for a new icon suite and returns, in this parameter, a handle to an empty icon suite.

DESCRIPTION

The NewIconSuite function returns a handle to an empty icon suite in the parameter theIconSuite. When you create an icon suite using NewIconSuite, it sets the default label for the suite to none. To set a new default label for an icon suite, use the SetSuiteLabel function. NewIconSuite allocates the memory for the icon suite handle. To release the memory occupied by an icon suite, you must use the DisposeIconSuite function.

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough memory in heap zone

SEE ALSO

For information on the DisposeIconSuite function, see page 5-42.