Carbon


Picker Flags

Header: ColorPicker.h

enum {
    kColorPickerDialogIsMoveable = 1,
    kColorPickerDialogIsModal = 2,
    kColorPickerCanModifyPalette = 4,
    kColorPickerCanAnimatePalette = 8,
    kColorPickerAppIsColorSyncAware = 16,
    kColorPickerInSystemDialog = 32,
    kColorPickerInApplicationDialog = 64,
    kColorPickerInPickerDialog = 128,
    kColorPickerDetachedFromChoices = 256,
    kColorPickerCallColorProcLive = 512
};

Constant descriptions

kColorPickerDialogIsMoveable

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.

kColorPickerDialogIsModal

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.

kColorPickerCanModifyPalette

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 do not want the colors in the document to change as the user makes choices in the color picker dialog box, do not set this flag.

kColorPickerCanAnimatePalette

If your application sets the bit represented by this constant, then the color picker may modify or animate the palette.

kColorPickerAppIsColorSyncAware

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 ColorPickerInfo, 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.

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.0 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.

kColorPickerInSystemDialog

The color picker sets this flag to indicate that the color picker is in a system-owned dialog box.

kColorPickerInApplicationDialog

The color picker sets this flag to indicate that the color picker is in an application-owned dialog box.

kColorPickerInPickerDialog

The color picker sets this flag to indicate that the color picker is in its own dialog box.

kColorPickerDetachedFromChoices

The color picker sets this flag to indicate that the color picker has been detached from the choices list.

kColorPickerCallColorProcLive

In the flags field of the ColorPickerInfo parameter block, the SystemDialogInfo structure, the PickerDialogInfo structure, or the ApplicationDialogInfo structure, your application specifies characteristics for the color picker dialog box.

The color picker may set any of the InSystemDialog, InApplicationDialog, InPickerDialog, or DetachedFromChoices flags and override your application settings.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)