Important: The information in this document is obsolete and should not be used for new development.
Creating an Icon SuiteYou typically create an icon suite by reading all resources from a specific icon family into memory and storing handles to the icon resource data in a new icon suite. You can do this using the
GetIconSuitefunction. Alternatively, you can create an empty icon suite using the
NewIconSuitefunction and then add icons to it one at a time using the
Although you typically create an icon suite using
GetIconSuite(which fills the suite with handles to icon resource data), you can also create an icon suite and then add handles to icon data. The handles that you add to the suite do not have to be associated with a resource fork. For example, your application might get icon data from the desktop database rather than reading it from a resource, or your application might read icon data from a resource and then detach it. In either case, you can provide a handle to the icon data and use
AddIconToSuiteto add the handle to the icon suite. You need to release the memory occupied by the icon suite when you're finished using it. The
DisposeIconSuitefunction releases this memory but does not release the memory
of any resource handles. You can request
DisposeIconSuiteto release the memory of any other handles to icon data in the suite.
- When you create an icon suite from icon family resources, the associated resource file should remain open while you use Icon Utilities routines.