Carbon


PickerSetOriginProcPtr

Header: ColorPickerComponents.h Carbon status: Supported

Defines a pointer to a color picker-defined origin setter callback function. Your origin setter function sets the window origin for the color picker.

typedef ComponentResult(* PickerSetOriginProcPtr) (
    SInt32 storage, 
    Point where
);

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

ComponentResult MyPickerSetOriginCallback (
    SInt32 storage, 
    Point where
);
Parameter descriptions
storage

A handle to your color picker’s global data.

where

The new window origin for the color picker.

function result

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

DISCUSSION

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

If your color picker maintains any information based on the local coordinate system of its dialog box, your MyPickerSetOriginCallback function should update that information.

The Color Picker Manager moves all dialog box items automatically in response to a new window origin for the dialog box, so it is not necessary for your color picker to move its items.

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)