Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Picker Flags
Your application specifies characteristics for the color picker dialog box in the flags field of the color picker parameter block (page 2-20), the SystemDialogInfo structure (page 2-23), the PickerDialogInfo structure (page 2-24), or the ApplicationDialogInfo structure (page 2-25).
#define DialogIsMoveable      1  
#define DialogIsModal         2  
#define CanModifyPalette      4  
#define CanAnimatePalette     8  
#define AppIsColorSyncAware   16
Constant descriptions

DialogIsMoveable
If your application sets the bit represented by this constant when creating a custom dialog box, then the color picker dialog box is moveable by the user.
DialogIsModal
If your application sets the bit represented by this constant when creating a custom dialog box, then the color picker dialog box is a modal dialog box.
CanModifyPalette
Your application should set the bit represented by this constant if your application can install a palette of its own that may modify (but not animate) the current color table. If you don't want the colors in the document to change as the user makes choices in the color picker dialog box, don't set this flag. See the "Palette Manager Reference" (page 1-3) for information about color palettes.
CanAnimatePalette
If your application sets the bit represented by this constant, then the color picker may modify or animate the palette.
AppIsColorSyncAware
Your application should set the bit represented by this constant if your application uses ColorSync color matching. If your application sets this bit, a color may be returned to your application in a different color space than the one initially passed to the PickColor function. For example, your application could pass an RGB color with no color-matching profile in the field theColor in the color picker parameter block, and the Color Picker Manager could return a CMYK color with its associated profile. If your application does not set this flag, the Color Picker Manager automatically converts any color it receives back from the color picker to an RGB color.
Important
This version of the Color Picker Manager uses ColorSync 1.0 profiles only. The ColorSync 1.0 profile is a handle-based profile. The profile format is defined by Apple Computer. You cannot use version 2.x profiles, which are identified by profile references, with this version of the Color Picker Manager. ColorSync 1.0 profiles typically reside in the ColorSyncTM Profiles folder (within the Preferences folder of the System Folder). They may also be embedded with the images to which they pertain in graphics files. The appendix "ColorSync Manager Backward Compatibility" in Advanced Color Imaging on the Mac OS provides information about the relationship between the ColorSync Manager version 2.x and ColorSync 1.0 profiles, which you may find useful.
The color picker may set any of the following flags and override your application settings:
#define InSystemDialog  32    /* the color picker is in a 
                                 system-owned dialog box */
#define InApplicationDialog64 /* the color picker is in an  
                                 application-owned 
                                 dialog box */
#define InPickerDialog  128   /* the color picker is in its 
                                 own dialog box */
#define DetachedFromChoices256/* the color picker has been 
                                 detached from the 
                                 choices list */