SgCreateColorChooserDialog(3X)

NAME
     SgCreateColorChooserDialog  -- The  ColorChooser  ColorChooserDialog conve-
     nience creation function

SYNOPSIS
     #include <Sgm/ColorC.h>

     Widget SgCreateColorChooserDialog (parent, name, arglist, argcount)
          Widget    parent;
          String    name;
          ArgList   arglist;
          Cardinal  argcount;


VERSION
     This page documents the version of Sgm that accompanies Motif 1.2.

DESCRIPTION
     SgCreateColorChooserDialog is a convenience creation function that  creates
     a DialogShell and an unmanaged ColorChooser child of the DialogShell.  Col-
     orChooser is a dialog widget that provides a friendly and powerful user in-
     terface for selecting colors. The ColorChooser provides a color hexagon and
     color  sliders  that  presents  the  color range in Hue, Saturation, Value,
     (HSV) and Red, Green, Blue, (RGB) color spaces.  Because of  drawing  speed
     considiration  the  color  hexagon  and color sliders are available only if
     running under GL. For X only configuration there are Scale  widget  to  re-
     place the color sliders and ther is no color hexagon.  The ColorChooser in-
     cludes the following:

     A menu for setting options for the color chooser.

       *  A  color hexagon that provides visual selection of the Hue and Satura-
          tion components of a color in an Hue, Saturation, Value,  (HSV)  color
          space.

       *  Color  slider  for  each  of  Hue, Saturation, Value, Red, Green, Blue
          color components.  The color sliders are visible depening on the  user
          color chooser menu selection.  Each of the color sliders and the color
          hexagon is accompanied with a text edit widget to view the exact value
          of the current color component and to set it's numerical value.

       *  Two color swatches: one for showing the current selected color and one
          for enabling the user to atore a second color for reference.

       *  Four buttons


     The  default button labels are OK, Cancel, Apply, and Help.  One additional
     WorkArea child may be added to the ColorChooser after creation.

     SgCreateColorChooserDialog forces the value of  the  ColorChooser  resource
     XmNdialogType to XmDIALOG_SELECTION.

     Use  XtManageChild  to  pop  up  the ColorChooserDialog (passing the Color-
     Chooser as the widget parameter); use XtUnmanageChild to pop it down.


     parent Specifies the parent widget ID

     name   Specifies the name of the created widget

     arglistSpecifies the argument list

     argcount
            Specifies the number of attribute/value pairs in the  argument  list
            (arglist)


     For a complete definition of ColorChooser and its associated resources, see
     SgColorChooser(3X).

RETURN VALUE
     Returns the ColorChooser widget ID.

RELATED INFORMATION
     SgColorChooser(3X).

                                                  SgCreateColorChooserDialog(3X)