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 Components

This section describes the Component Manager routines that are used by components. It also discusses routines a component or application can use to register a component. This section first describes the routines for registering components then describes the routines that allow your component to

Note that version 3 and above of the Component Manager supports automatic version control, the unregister request, and icon families. You should test the version number before using any of these features. You can use the Gestalt function with the gestaltComponentMgr selector to do this. When you specify this selector, Gestalt returns in the response parameter a 32-bit value indicating the version of the Component Manager that is installed.

If you are developing an application that uses components but does not register them, you do not have to read this material, though it may be interesting to you. For a discussion of the Component Manager routines that support applications that use components, see "Routines for Applications" beginning on page 6-39.

If you are developing an application that registers components, you should read the next section, "Registering Components." You may also find the other topics in this section interesting.

If you are developing a component, you should read this entire section. For more information about creating components, see "Creating Components" beginning on page 6-12.

Several of the routines discussed in this section use the component parameters record. For a complete description of that structure, see "Data Structures for Components" beginning on page 6-50. For information on the distinction between component identifiers and component instances, see page 6-38.

Note
Any of the routines discussed in this section that require a component identifier also accept a component instance. Similarly, you can supply a component identifier to any routine that requires a component instance (except for the DelegateComponentCall function). If you do this, you must always coerce the data type appropriately. For more information, see "Component Identifiers and Component Instances" on page 6-38.

Subtopics
Registering Components
Dispatching to Component Routines
Managing Component Connections
Setting Component Errors
Working With Component Reference Constants
Accessing a Component's Resource File
Calling Other Components
Capturing Components
Targeting a Component Instance
Changing the Default Search Order

Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996