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

SetPickerColor

Sets the original or the new color for a color picker.

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

thePicker

The color picker for which to set a color.

whichColor

Either of two values: kOriginalColor or kNewColor.

color

A pointer to a PMColor structure (page 2-15) specifying the color to set.

DISCUSSION

The SetPickerColor function sets the color picker specified by the parameter thePicker to use the color specified in the color parameter. If your application passes kOriginalColor in the whichColor parameter, then SetPickerColor sets this color as the original color to be edited. If your application passes kNewColor, then SetPickerColor sets the color to be used as if it were the last color selected by the user.

Use the SetPickerColor function for setting colors for color pickers in custom dialog boxes. When your application uses the PickColor function to display the standard dialog box, your application supplies the original color in the field theColor of the color picker parameter block. This color is used as the new color until the user begins editing the color.

SEE ALSO

Listing 2-7 (page 2-16) in Advanced Color Imaging on the Mac OS illustrates how to use the SetPickerColor function.