Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker Manager Functions / Handling Events in a Custom Color Picker Dialog Box

DoPickerEvent

Passes an event to a color picker for handling.

pascal OSErr DoPickerEvent (
picker thePicker, 
EventData *data);

thePicker

The color picker to handle the event.

data

A pointer to an EventData structure (page 2-26). On input, you supply a color picker with information about an event; on output, you receive information about how the color picker handled the event.

DISCUSSION

The DoPickerEvent function uses the EventData structure you point to in the data parameter to pass an event to the color picker specified in the parameter thePicker. If the color picker handles the event, it returns the value true in the handled field of the EventData structure; otherwise, it returns the value false, in which case your application should continue handling the event.

SPECIAL CONSIDERATIONS

The DoPickerEvent function calls the Dialog Manager function DialogSelect. If your application needs to filter or preprocess events before DialogSelect handles them, your application must do so before calling DoPickerEvent.

SEE ALSO

Listing 2-9 (page 2-19) in Advanced Color Imaging on the Mac OS illustrates how to use the DoPickerEvent function. Event handling on the Macintosh is described in the chapter "Event Manager" in Inside Macintosh: Macintosh Toolbox Essentials. The Dialog Manager and the DialogSelect function are described in the chapter "Dialog Manager" in Inside Macintosh: Macintosh Toolbox Essentials.