Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker-Defined Functions / Setting Up a Color Picker

MyTestGraphicsWorld

Color picker-defined subroutine that handles a kTestGraphicsWorld request.

If you create a color picker, it must respond to the kTestGraphicsWorld request code. So that your color picker can test whether it can operate under existing conditions, the Color Picker Manager gives your color picker a copy of the picker flags as if the Color Picker Manager were requesting the color picker to open. A color picker typically responds to the kTestGraphicsWorld request code by calling a color picker-defined subroutine (for example, MyTestGraphicsWorld) to handle the request.

pascal ComponentResult MyTestGraphicsWorld (
PickerStorageHndl storage, 
PickerInitData *data);

storage

A handle to your color picker's global data.

data

A pointer to a PickerInitData structure (page 2-18), in which one or more color picker flags may be set by the application. Your color picker may need to change some of these flags (such as those indicating the type of dialog box in which it appears).

DISCUSSION

Your MyTestGraphicsWorld function should return noErr if your color picker can operate on the current system with the restrictions pointed to in the data parameter. If your color picker cannot operate under these conditions, it should return a result code other than noErr.

SEE ALSO

Listing 2-18 (page 2-35) in Advanced Color Imaging on the Mac OS illustrates how to implement this function.