XmColorSelector(3X)                                        XmColorSelector(3X)

NAME
       The Color Selector widget

SYNOPSIS
       #include <Xm/ColorS.h>

DESCRIPTION
       The Color Selector widget allows users to choose a color by using
       either a set of RGB sliders or choosing from a list of all colors
       available in the rgb database. The name or rgb value, as well as the
       color selected, are dynamically displayed to the user as they pick and
       choose different colors.

Normal Resources

       Name                Class           Type                  Initial Value
       blueSliderLabel     SliderLabel     XmString              "Blue"
       colorListTogLabel   TogLabel        XmString              "Color List"
       colorMode           ColorMode       XiColorMode           XmScaleMode
       colorName           String          String                White
       fileReadError       FileReadError   XmString              "Could not read
                                                                  RGB.txt file"
       greenSliderLabel    SliderLabel     XmString              "Green"
       marginHeight        MarginHeight    VerticalDimension     2
       marginWidth         MarginWidth     HorizontalDimension   2
       noCellError         NoCellError     XmString              "No Color Cell
                                                                  Available"
       redSliderLabel      SliderLabel     XmString              "Red"
       rgbFile             String          String                /usr/lib/X11/rgb.txt
       sliderTogLabel      TogLabel        XmString              "Color Sliders"

       All resource names begin with XmN and all resource class names begin
       with XmC.

blueSliderLabel
       The string appearing for the label of the blue slider

colorListTogLabel
       The string appearing for the label of the color list toggle

colorMode
       The color list can be used in either slider or list mode. Acceptable
       values are XmListMode and XmScaleMode. This resource allows the
       application to determine the mode that the color selector should use
       when it is created. After this point, the user may freely change modes
       by utilizing a pair of radio buttons in the color selector. A type
       converter is registered to convert the strings "ScaleMode" and
       "ListMode" to color modes for use with the resource database.

colorName
       This resource controls the color name that is currently displayed to
       the user. This value can be modified to change the color displayed in
       the color selector or queried to find the color the user has selected.
       The string returned here is either a color name or a pound sign (#)
       followed by a set of rgb values as specified in the Xlib specification.

fileReadError
       The message which is displayed when the Color Selector cannot read the
       rgb.txt file. The message is displayed at the top of the window in
       which the color list would normally appear.

greenSliderLabel
       The string appearing for the label of the green slider

marginHeight
marginWidth
       This is the amount of space left between each of the children in the
       color selector and between the outside children and the edge of the
       color selector widget.

noCellError
       This resource controls the message which is displayed in the sample
       color field when the Color Selector cannot allocate a read/write color
       cell

redSliderLabel
       The string appearing for the label of the red slider

rgbFile
       This is the name of the file to be loaded, which contains the valid
       color names.  Each of these names is sorted and the duplicates removed
       before being shown to the user.

sliderTogLabel
       The string appearing for the label of the color slider toggle

Convenience Routine



XmCreateColorSelector - Widget creation convenience routine

       Widget XmCreateColorSelector(
            Widget parent,     /* Widget id of parent for ColorSelector */
            String name,       /* Name of the created widget */
            ArgList args,      /* argument list */
            Cardinal num_args  /* number of items in argument list */
            )


Children
       The color selector is composed of many sub-widgets. As with all
       widgets, most values are passed to this widget through the argument
       list at creation time or via set values and are passed to each of this
       widget's children, although get values requests must be made on a
       child-by-child basis. The children of the color selector are listed
       below. The documentation for each of the children should be consulted
       for a list of resources for each child.


       XmColorSelector<named by application>

            XmScrolledWindowscrolled

            XmScrollBarListvScrollBar

            XmScrollBarListhScrollBar

            XmListlist

            XmButtonBoxbuttonBox

            XmScalescale

            XmLabelGadgetscale_title

            XmScrollBarscale_scrollbar

            XmRowColumnradioBox

            XmToggleButtoncolorListToggle

            XmToggleButtoncolorSlidersToggle

            XmFramecolorFrame

            XmLabelcolorWindow

COPYRIGHT
       Copyright (c) 1992 by Integrated Computer Solutions, Inc.

                                                           XmColorSelector(3X)