Important: The information in this document is obsolete and should not be used for new development.
DisposeIconSuiteYou can use the
DisposeIconSuitefunction to release the memory occupied by an icon suite.
FUNCTION DisposeIconSuite (theIconSuite: Handle; disposeData: Boolean): OSErr;
- A handle to the icon suite to be disposed of.
- A Boolean value indicating whether or not to dispose of handles in the icon suite that are not associated with a resource fork.
DisposeIconSuitefunction releases the memory occupied by the specified icon suite. However,
DisposeIconSuitedoes not release the memory of any icons explicitly associated with an open resource fork, that is, any handles to icon resource data that your application added to the suite using
AddIconToSuite. For handles to icon data that your application added to the icon suite using
AddIconToSuite(for example, if your application read in an icon resource, detached it, then added the handle to the suite), you can request that
AddIconToSuiterelease the memory associated with the handles.
TRUEto automatically release icon data that is associated with the specified icon suite but not explicitly associated with a resource fork. If you set
DisposeIconSuitedoes not dispose of any icon data that is associated with the specified icon suite.
noErr 0 No error memWZErr -111 Attempt to operate on a free block
SEE ALSOFor more information on icon suites, see "Creating an Icon Suite" beginning on page 5-30.