![]() |
RegisterAppearanceClient |
||||
Header: | Appearance.h | Carbon status: | Supported | |
Registers your program with the Appearance Manager.
OSStatus RegisterAppearanceClient ();
A result code. The result code appearanceProcessRegisteredErr indicates that your program was already registered when you called the RegisterAppearanceClient function.
The RegisterAppearanceClient function must be called at the beginning of your program, prior to initializing or drawing any onscreen elements or invoking any definition functions, such as the menu bar.
You should call RegisterAppearanceClient in order to receive Appearance Manager Apple events. Under Appearance Manager 1.1 and later, when the user changes the current appearance (that is, when a theme switch occurs), the Appearance Manager sends Apple events to all running applications that are registered as clients of the Appearance Manager and which are high-level event aware. Because typical results of a theme switch might include a change in menu bar height or window structure dimensions, as well as changes to the system fonts, colors, and patterns currently in use, you should listen for and respond to the Appearance Manager Apple events under most circumstances. See
When your program calls RegisterAppearanceClient, the Appearance Manager also automatically maps standard preAppearance Manager definition functions to their theme-compliant equivalents for your program, whether or not systemwide appearance is active.
See also the function UnregisterAppearanceClient.
This function is available with Appearance Manager 1.0 and later.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 5/8/2000)