Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker-Defined Functions / Responding to Requests to Return and Set Color Picker Information

MySetBaseItem

Color picker-defined subroutine that handles a kSetBaseItem request.

If you create a color picker, it must respond to the kSetBaseItem request code. The Color Picker Manager sends this code to obtain the first item in your color picker's item list. A color picker responds to the kSetBaseItem request code by calling a color picker-defined subroutine (for example, MySetBaseItem) to handle the request.

pascal ComponentResult MySetBaseItem (
PickerStorageHndl storage, 
short baseItem);

storage

A handle to your color picker's global data.

baseItem

In the dialog item list, the number of the first item that belongs to your color picker.

DISCUSSION

Your MySetBaseItem function allows your color picker to access its dialog items through the Dialog Manager, where

RealItemNumber = baseItem + locaItemNumber (1 based)

Your function should return noErr if successful, or an appropriate result code otherwise.