Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker-Defined Functions / Setting Up a Color Picker

MyGetItemList

Color picker-defined subroutine that handles a kGetItemList request.

If you create a color picker, it must respond to the kGetItemList request code. The Color Picker Manager sends this request code to obtain the dialog items for your color picker. A color picker responds to the kGetItemList request code by calling a color picker-defined subroutine (for example, MyGetItemList) to handle the request.

pascal ComponentResult MyGetItemList (PickerStorageHndl storage);

storage

A handle to your color picker's global data.

DISCUSSION

Your MyGetItemList function should coerce a handle for one or more dialog items into a long integer and return this as a function result. The Color Picker Manager adds these items to the color picker dialog box. If your color picker has no items to add, it should return nil.

If your color picker saved the items in a dialog item list ('DITL') resource, your color picker should use the Resource Manager function GetResource to obtain the handle, and the Resource Manager function DetachResource to detach the resource.

SEE ALSO

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