This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtColorPatch

A widget for selecting a hue and shading or tint

Class hierarchy:

PtWidget --> PtBasic --> PtContainer --> PtCompound --> PtColorSel --> PtColorPatch

For more information, see the diagram of the widget hierarchy.

PhAB icon:

Public header:

<photon/PtColorPatch.h>

Description:

A PtColorPatch is a widget that you can use to select a color from a three dimensional color space by means of a 2-dimensional color spectrum and a slider.

The widget includes:

• An optional combo box used to select the color space (HSB, and so on). It's displayed if Pt_CPATCH_SHOW_SELECTOR is set in Pt_ARG_CPATCH_FLAGS.
• An optional slider on the left controls one of the variables of the three-dimensional color space. It's displayed if Pt_CPATCH_SHOW_SLIDER is set in Pt_ARG_CPATCH_FLAGS.
• An area displaying a "plane of color" defined by the remaining two variables in the three-dimensional color space. You can use the pointer to select a color from this plane.

New resources:

Pt_ARG_CPATCH_FLAGS

Flags that affect the appearance and behavior of the color patch. Bits include:

Pt_CPATCH_SHOW_SELECTOR

Show a PtComboBox selector that lets you select the color models that are supported by the color patch (see the Pt_ARG_CS_COLOR_MODELS resource defined by PtColorSel).

Pt_CPATCH_SHOW_SLIDER

Show a slider on the left that lets you change the channel not shown in the spectrum. Clear this bit if you want that channel to remain fixed (your application will need to set it programmatically).

Pt_CPATCH_ENABLE_MENU

Enable a popup menu that lets you change the patch's configuration. orientation of the palette, and so on.

Inherited resources:

If the widget modifies an inherited resource, the "Default override" column indicates the new value. This modification affects any subclasses of the widget.