Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker Manager Functions / Getting Colors From and Setting Colors for a Custom Color Picker Dialog Box

GetPickerColor

Returns the original or the new color from a color picker.

pascal OSErr GetPickerColor (
picker thePicker, 
ColorType whichColor, 
PMColor *color);

thePicker

The color picker from which to obtain a color.

whichColor

Either of two values: kOriginalColor or kNewColor.

color

A pointer to a PMColor structure (page 2-15). On output, the original or the new color from the picker (as specified by the whichColor parameter).

DISCUSSION

In the PMColor structure pointed to by the color parameter, the GetPickerColor function returns a color from the color picker specified by the parameter thePicker. If your application passes kOriginalColor in the whichColor parameter, then GetPickerColor returns the color that the user began editing. If your application passes kNewColor, then GetPickerColor returns the new color selected by the user.

Use the GetPickerColor function for getting colors from color pickers in custom dialog boxes. When your application uses the PickColor function to display the standard dialog box, and the user clicks the OK button, the Color Picker Manager returns the new color in the field theColor of the color picker parameter block.

SEE ALSO

Listing 2-8 (page 2-17) in Advanced Color Imaging on the Mac OS illustrates how to use the GetPickerColor function.