Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: More Macintosh Toolbox /
Chapter 6 - Component Manager / Component Manager Reference
Routines for Applications / Getting Information About Components


GetComponentIconSuite

The GetComponentIconSuite function returns a handle to the component's icon suite (if it provides one).

FUNCTION GetComponentIconSuite (aComponent: Component; 
                                VAR iconSuite: Handle): OSErr;
aComponent
A component identifier that specifies the component for the operation. Your application obtains a component identifier from the FindNextComponent function. If your application registers a component, it can also obtain a component identifier from the RegisterComponent or RegisterComponentResource function.
iconSuite
GetComponentIconSuite returns, in this parameter, a handle to the component's icon suite, if any. If the component has not provided an icon suite, GetComponentIconSuite returns NIL in this parameter.
DESCRIPTION
The GetComponentIconSuite function returns a handle to the component's icon suite. A component provides to the Component Manager the resource ID of its icon family in the optional extensions to the component resource. Your application is responsible for disposing of the returned icon suite handle.

SPECIAL CONSIDERATIONS
The GetComponentIconSuite function is available only in version 3 of the Component Manager.

RESULT CODES
noErr0No error
invalidComponentID-3000No component with this component identifier
SEE ALSO
For information about icon suites and icon families, see the chapter "Icon Utilities" in this book.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996