![]() |
UserEventProcPtr |
||||
Header: | ColorPicker.h | Carbon status: | Supported | |
Defines a pointer to an event filter callback function. Your event filter callback function determines whether your application or the Color Picker Manager will handle this user event.
typedef Boolean(* UserEventProcPtr) ( EventRecord *event );
You would declare your function like this if you were to name it MyUserEventCallback:
Boolean MyUserEventCallback ( EventRecord *event );
A pointer to an event record. See the Event Manager for more information on event records
True if your application handles the event, false otherwise. The Color Picker Manager will process the event further only if false is returned.
Your application should supply the eventProc field of the color picker parameter block with a pointer to your filter function. Your filter function should examine the event record passed in the first parameter to determine whether your application needs to handle the event contained in the record.
Applications can generally allow the Color Picker Manager to handle all events that might occur while displaying the standard dialog box. Update events are exceptions to this, however.
The PickColor function calls the Dialog Manager function DialogSelect. DialogSelect does not allow background windows to receive update events; therefore, at a minimum, your event filter function should handle update events. If your application needs to filter or preprocess other events before DialogSelect handles them, your application should do so in its event filter function.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)