Carbon


PickerSetBaseItemProcPtr

Header: ColorPickerComponents.h Carbon status: Supported

Defines a pointer to a color picker-defined base item setter callback function. Your base item setter callback function sets the first item in your color picker’s item list.

typedef ComponentResult(* PickerSetBaseItemProcPtr) (
    SInt32 storage, 
    SInt16 baseItem
);

You would declare your function like this if you were to name it MyPickerSetBaseItemCallback:

ComponentResult MyPickerSetBaseItemCallback (
    SInt32 storage, 
    SInt16 baseItem
);
Parameter descriptions
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.

function result

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

DISCUSSION

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

RealItemNumber = baseItem + locaItemNumber (1 based)

If you create a color picker, it must respond to the kSetBaseItem request code, by calling a color picker-defined subroutine (MyPickerSetBaseItemCallback, for example).

When you create a color picker, the Color Picker Manager uses the Component Manager to request services from your color picker. The code for your color picker should be contained in a resource. The Component Manager expects that the entry point into this resource is a color picker-defined dispatch function. For information on how to create this dispatch function, see the Component Manager callback, ComponentRoutineProcPtr.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)