 |
Index for
Section 3X |
|
 |
Alphabetical
listing for D |
|
 |
Bottom of
page |
|
DXmCreateColorMixDialog(3X)
NAME
DXmCreateColorMixDialog - Creates a color mixing widget with a dialog box.
SYNOPSIS
Widget DXmCreateColorMixDialog(
Widget parent,
String name,
ArgList arglist,
Cardinal argcount );
PARAMETERS
parent
The identifier (widget ID) of the parent widget.
name
The name of the created widget.
arglist
The application argument list.
argcount
The number of arguments in the application argument list.
DESCRIPTION
DXmCreateColorMixDialog allows your DECwindows Motif applications to query
users for a color. The color mixing widget provides users with immediate
feedback, displaying each new color as it is selected. This widget uses a
pop-up dialog box (or nonpop-up dialog box if you use the DXmCreateColorMix
routine) that is preconfigured to contain the following subwidgets:
___________________________________________________________________________
Subwidget Description
___________________________________________________________________________
Scratch pad
Stores intermediate colors for later use in
color mixing.
Color display subwidget
Displays the original color and the new
color.
Implements choice of color model.
Color model option menu
subwidget
Color mixer subwidget
Provides graphic tools users can use to
define new colors.
Push button subwidgets Activate color mixing widget functions.
Label subwidgets Provide descriptive information.
___________________________________________________________________________
The color mixing widget allows a user to choose from up to five different
color models:
Color Picker
The default color model for the color mixing widget on color systems
(it does not display on non-color systems or on systems with too few
resources).
The color picker consists of a"-color color spectrum and a color
palette option menu, a color interpolator and its title, a smear
button, and undo button, two paint bucket buttons, and arrow buttons to
control the warmth and lightness of interpolator colors.
HLS (Hue, Lightness, Saturation)
In the HLS color model, a color is specified by three characteristics:
hue, lightness, and saturation. Hue is color. Lightness describes the
intensity of the color (the amount of the color). Saturation describes
the purity of the color or how much the color is diluted by white.
To support the HLS color model, the color mixer subwidget contains
three scales that represent the ranges of hue, lightness, and
saturation. The hue scale presents color values as a range between 0
and 360. The lightness and saturation scales present their values as a
range of percentages between 0 and 100.
RGB (Red, Green, Blue)
The default color model for the color mixing widget on monochrome
systems.
In the RGB color model, a color is specified as a mixture of different
intensities of red, green, and blue. In the X Window System, Version
11, you specify the intensity of red, green, or blue as a value between
0 and 65,535. Zero is the lowest intensity. Black is defined as a
zero-intensity value for all three colors; white is"0 percent intensity
for all three colors.
To support the RGB color model, the color mixer subwidget contains
three scales that represent the ranges of intensity of red, green, and
blue. Each scale presents these color values as a percentage between 0
and 100. In addition, the color mixer subwidget contains text widgets
in which users of your application can enter RGB values directly as
text. The text widgets and the scales are linked: a change in one
effects a corresponding change in the other.
Browser (X11 named colors)
A scrolled window that presents the user with a list of X11 named
colors. Each button in the scrolled window shows the name of an X11
color. If enough resources are available, the background is set to that
color. (If the new color is not further modified by other color
models, the X11 name of this color is also returned to the application
as part of the color mixing widget's callback structure.) You can use
the scroll bar to scroll through this color list. Clicking MB1 on a
color in the list causes the color display subwidget to become filled
with that color. The color browser is available on all systems.
A complete list of all the X color values available to you is located
on your system. To find it, type the following command:
% find / -name '*rgb*' -print
Greyscale Mixer
A scale widget that allows generation of gray shades ranging from black
to white. When the Greyscale mixer is selected, the current new color
is converted to an appropriate shade of gray, which can then be
adjusted with the scale widget. All shades of gray generated by this
model are a mixture of equal portions of red, green, and blue, which
means that they appear identically on both color and gray scale
systems.
The Greyscale mixer is available on all systems.
Note
When considering whether to use a pop-up or nonpop-up color mixing
widget, the following conditions are in effect:
· The pop-up color mixing widget (which you create with the
DXmCreateColorMixDialog routine) allocates the necessary
color cells each time it is mapped and then releases them
each time the widget is unmapped.
· The nonpop-up color mixing widget (which you create with the
DXmCreateColorMix routine) allocates the necessary color
cells at creation time but does not release them until the
widget is destroyed. As such, if color resources are limited,
your application should use the pop-up color mixing widget
instead of the nonpop-up version.
Resource Information
You can set the following widget-specific resources in the arglist when
using any combination of default or application-provided color display and
color mixer subwidgets:
XmString DXmNclearLabel;
XmString DXmNdisplayLabel;
Widget DXmNdisplayWindow;
XmString DXmNhelpLabel;
XmString DXmNmainLabel;
XmString DXmNmixerLabel;
Widget DXmNmixerWindow;
unsigned short DXmNnewBlueValue;
unsigned short DXmNnewGreenValue;
unsigned short DXmNnewRedValue;
unsigned short DXmNorigBlueValue;
unsigned short DXmNorigGreenValue;
unsigned short DXmNorigRedValue;
XmString DXmNresetLabelString;
XmString DXmNscratchPadInfoLabel;
XmString DXmNscratchPadLabel;
void proc DXmNsetMixerColorProc;
void proc DXmNsetNewColorProc;
XtCallbackList XmNapplyCallback;
XmString XmNapplyLabelString;
XtCallbackList XmNcancelCallback;
XmString XmNcancelLabelString;
XtCallbackList XmNokCallback;
XmString XmNokLabelString;
Widget XmNworkWindow;
You can set the following widget-specific resources in the arglist only
when using the default color display subwidget:
unsigned short DXmNbackBlueValue;
unsigned short DXmNbackGreenValue;
unsigned short DXmNbackRedValue;
Dimension DXmNdisplayColWinHeight;
Dimension DXmNdisplayColWinWidth;
Dimension DXmNdispWinMargin;
Boolean DXmNmatchColors;
You can set the following widget-specific resources in the arglist only
when using the default color mixer subwidget:
XmString DXmNblackLabel;
XmString DXmNblueLabel;
short DXmNbrowserItemCount;
XmString DXmNbrowserLabel;
unsigned char DXmNcolorModel;
XmString DXmNcoolerLabel;
XmString DXmNdarkerLabel;
XmString DXmNearthtoneLabel;
XmString DXmNfullLabel;
XmString DXmNgrayLabel;
XmString DXmNgreenLabel;
XmString DXmNgreyscaleLabel;
Boolean DXmNgreyscaleOnGreyscale;
XmString DXmNhlsLabel;
XmString DXmNhueLabel;
short DXmNinterpTileCount;
short DXmNinterpTileHeight;
short DXmNinterpTileWidth;
XmString DXmNinterpTitleLabel;
XmString DXmNlighterLabel;
XmString DXmNlightLabel;
short DXmNlightnessIncrement;
XmString DXmNoptionLabel;
XmString DXmNpastelLabel;
unsigned short DXmNpickerColors;
XmString DXmNpickerLabel;
short DXmNpickerTileHeight;
short DXmNpickerTileWidth;
XmString DXmNpickerTitleLabel;
XmString DXmNredLabel;
XmString DXmNrgbLabel;
XmString DXmNsatLabel;
XmString DXmNsliderLabel;
XmString DXmNsmearLabel;
XmString DXmNspectrumLabel;
XmString DXmNundoLabel;
XmString DXmNuserPaletteLabel;
XmString DXmNvalueLabel;
XmString DXmNvividLabel;
XmString DXmNwarmerLabel;
unsigned short DXmNwarmthIncrement;
XmString DXmNwhiteLabel;
Resources
(Default or Application-Provided Color Display/Mixer Subwidgets)
DXmNclearLabel
Specifies the text that appears as the label of the scratch pad clear
push button. The default text is "Clear". Access is CSG.
DXmNdisplayLabel
Specifies the text that appears above the color display subwidget,
centered between the left and right borders. There is no default.
Access is CSG.
DXmNdisplayWindow
The color display subwidget. The default is the color mixing widget's
color display subwidget. Access is CSG.
Note the following:
· Setting this resource to Null at widget creation time prevents the
color display subwidget from being displayed.
· If an application substitutes its own color display subwidget for
the default color display subwidget, the application is completely
responsible for managing the subwidget (making it visible and
controlling its geometry management). An application can return
to the default color display subwidget by using the Intrinsic
routine XtSetValues to set the DXmNdisplayWindow resource to Null.
DXmNhelpLabel
Specifies the text that appears inside the Help push button. The
default text is "Help". Access is CSG.
DXmNmainLabel
Specifies the text that appears at the top of the color mixing widget,
centered between the left and right borders. There is no default.
Access is CSG.
DXmNmixerLabel
Specifies the text that appears above the color mixer subwidget,
centered between the left and right borders. There is no default.
Access is CSG.
DXmNmixerWindow
The color mixer subwidget. The default color mixer subwidget supports
the Hue Lightness Saturation (HLS), Red, Green, Blue (RGB), Color
Picker, Browser, and Greyscale Mixer color models. Setting this
resource to Null at widget creation time prevents the color mixer
subwidget from being displayed. Access is CSG.
Note the following:
· If an application substitutes its own color mixer subwidget for
the default color mixer subwidget, the application is completely
responsible for managing the subwidget (making it visible and
controlling its geometry management). An application can later
return to the default color mixer subwidget by using the Intrinsic
routine XtSetValues to set the DXmNmixerWindow resource to Null.
· Applications that use the default color mixer subwidget are not
required to update the new color value. However, applications
that provide their own color mixer subwidget must update the new
color value, by using either the Intrinsic routine XtSetValues or
the DXmColorMixSetNewColor routine (which is faster).
DXmNnewBlueValue
The new blue color value for the color mixing widget. The default is 0
unless DXmNmatchColors is True. If DXmNmatchColors is True, then
DXmNnewBlueValue is always set by default to match DXmNorigBlueValue
whenever the widget is created or made visible. Access is CSG.
DXmNnewGreenValue
The new green color value for the color mixing widget. The default is
0 unless DXmNmatchColors is True. If DXmNmatchColors is True, then
DXmNnewGreenValue is always set by default to match DXmNorigGreenValue
whenever the widget is created or made visible. Access is CSG.
DXmNnewRedValue
The new red color value for the color mixing widget. The default is 0
unless DXmNmatchColors is True. If DXmNmatchColors is True, then
DXmNnewRedValue is always set by default to match DXmNorigRedValue
whenever the widget is created or made visible. Access is CSG.
DXmNorigBlueValue
The original blue color value for the color mixing widget. The default
is 0; however, applications should set the original blue value. Access
is CSG.
DXmNorigGreenValue
The original green color value for the color mixing widget. The
default is 0; however, applications should set the original green
value. Access is CSG.
DXmNorigRedValue
The original red color value for the color mixing widget. The default
is 0; however, applications should set the original red value. Access
is CSG.
DXmNresetLabelString
Specifies the text that appears inside the Reset push button. The
default is "Reset". Access is CSG.
DXmNscratchPadInfoLabel
Specifies the text that appears as the label centered at the top of the
scratch pad pop-up. The default text is "Save colors here...". Access
is CSG.
DXmNscratchPadLabel
Specifies the text that appears as the label of the scratch pad push
button. The default text is "Scratch Pad...". Access is CSG.
DXmNsetMixerColorProc
The resource used by the color mixing widget to update the current
color mixer controls when the application sets a new color. (It is
intended for applications that use a non-default color mixer
subwidget.) The default is a procedure (specific to the color mixing
widget) that updates the appropriate default color model (Picker, HLS,
RGB, Browser, or Greyscale). Access is CSG.
DXmNsetNewColorProc
The resource used by the color mixing widget to update the new color
values displayed in the color display subwidget. If the application
replaces the default color display subwidget and requires that the
color mixing widget update the new color, the application must set this
resource. Otherwise, replacing the default color display subwidget sets
this resource to Null. Access is CSG.
If this resource is set and the application manages this subwidget, the
work window is placed below the color display and color mixer
subwidgets (if present) and above the color mixing widget push buttons.
XmNapplyCallback
Callback (or callbacks) made when the user clicks the Apply push button
widget in the color mixing widget. The reason for this callback is
XmCR_APPLY. The default is Null. Access is CSG.
XmNapplyLabelString
Specifies the text that appears inside the Apply push button. The
default is "Apply". Access is CSG.
XmNcancelCallback
Callback (or callbacks) made when the user clicks the Cancel push
button widget in the color mixing widget. The reason for this callback
is XmCR_CANCEL. The default is Null. Access is CSG.
XmNcancelLabelString
Specifies the text that appears inside the Cancel push button. The
default is "Cancel". Access is CSG.
XmNokCallback
Callback (or callbacks) made when the user clicks the OK push button
widget in the color mixing widget. The reason for this callback is
XmCR_ACTIVATE. The default is Null. Access is CSG.
XmNokLabelString
Specifies the text that appears inside the OK push button. The default
is "OK". Access is CSG.
XmNworkWindow
An optional work area subwidget. The default is Null. Access is CSG.
Resources
(Default Color Display Subwidget Only)
DXmNbackBlueValue
The value of the default color display subwidget's blue background
color. The default value is 32767 (gray). Access is CSG.
This resource is valid only if the default color display subwidget is
used; otherwise, the resource is ignored.
DXmNbackGreenValue
The value of the default color display subwidget's green background
color. The default value is 32767 (gray). Access is CSG.
This resource is valid only if the default color display subwidget is
used; otherwise, the resource is ignored.
DXmNbackRedValue
The value of the default color display subwidget's red background
color. The default value is 32767 (gray). Access is CSG.
This resource is valid only if the default color display subwidget is
used; otherwise, the resource is ignored.
DXmNdisplayColWinHeight
The height of the original and new color display windows. The default
is 80 pixels. Access is CSG.
This resource is valid only if the default color display subwidget is
used; otherwise, the resource is ignored.
DXmNdisplayColWinWidth
The width of the original and new color display windows. The default
is 80 pixels. Access is CSG.
This resource is valid only if the default color display subwidget is
used; otherwise, the resource is ignored.
DXmNdispWinMargin
The margin between the original and the new color display windows and
the outsides edges of the color display subwidget. The margin is the
area affected by the background resources (set gray by default). The
default width is 20 pixels. Access is CSG.
This resource is valid only if the default color display subwidget is
used; otherwise, the resource is ignored.
DXmNmatchColors
A Boolean resource that specifies whether new color values are matched
to original color values whenever the color mixing widget is created
and made visible. When True, new color values are matched to original
color values. When False, new color values are not matched to original
color values. The default is True. Access is CSG.
This resource is valid only if the default color display subwidget is
used; otherwise, the resource is ignored.
Resources
(Default Color Mixer Subwidget Only)
DXmNblackLabel
Specifies the text that appears below the left end of the middle scale
subwidget. The default is "Black". Access is CSG.
This resource is used in the HLS mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNblueLabel
Specifies the text that appears below the left end of the bottom scale
subwidget. The default is "Blue". Access is CSG.
This resource is used in the RGB mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNbrowserItemCount
The number of visible items in the browser's color list. You can set
this resource only at widget creation time. Each visible item requires
that the color mix widget allocate its own color cell. The default is
5. Access is CG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNbrowserLabel
Specifies the text that appears as the fourth item in the color model
option menu. The default text is "Browser". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNcolorModel
The color model currently being used. The values for this resource are
as follows:
_________________________________________________________
Color Model Value When Default
_________________________________________________________
Color Picker DXmColorModelPicker Color systems
HLS DXmColorModelHLS
Not used as
default
RGB DXmColorModelRGB
Monochrome
systems
Browser DXmColorModelBrowser
Not used as
default
Greyscale DXmColorModelGreyscale
Gray scale
systems
_________________________________________________________
Applications should set this resource before the widget is managed (if
at all), and allow users to switch color models by using the option
menu. Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNcoolerLabel
Specifies the text of the Cooler arrow button. The default text is
"Cooler". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNdarkerLabel
Specifies the text of the Darker arrow button. The default text is
"Darker". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNearthtoneLabel
The label used to represent the earthtones palette in the picker
spectrum option menu. The default text is "Earthtones". Access is
CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNfullLabel
Specifies the text that appears below the right end of the bottom scale
subwidget. The default is "Full". Access is CSG.
This resource is used in the HLS mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNgrayLabel
Specifies the text that appears below the left of the bottom scale
subwidget. The default is "Gray". Access is CSG.
This resource is used in the HLS mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNgreenLabel
Specifies the text that appears below the left end of the middle scale
subwidget. The default is "Green". Access is CSG.
This resource is used in the RGB mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNgreyscaleLabel
Specifies the text that appears as the bottom item in the color model
option menu. The default text is "Grayscale". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNgreyscaleOnGreyscale
A Boolean resource that, when True, specifies that the greyscale mixing
color model is to be the default on greyscale systems. The default is
True. Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNhlsLabel
Specifies the text that appears as the second item in the color model
option menu. The default is "HLS". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNhueLabel
Specifies the text that appears to the left of the top scale subwidget.
The default is "Hue:". Access is CSG.
This resource is used in the HLS mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNinterpTileCount
The number of interpolator tiles used. (The color mixing widget must
allocate a color cell for each interpolator tile.) You can set this
resource only at widget creation time. The default is 10. Access is
CG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNinterpTileHeight
The height of each interpolator tile, in pixels. The default is 30.
Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNinterpTileWidth
The width of each interpolator tile, in pixels. The default is 30.
Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNinterpTitleLabel
Specifies the text that appears centered above the interpolator widget.
The default text is "Interpolator". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNlighterLabel
Specifies the text of the Lighter arrow button. The default text is
"Lighter". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNlightLabel
Specifies the text that appears to the left of the bottom scale
subwidget. The default is "Lightness:". Access is CSG.
This resource is used in the HLS mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNlightnessIncrement
The percentage by which to increase or decrease the lightness of the
color of each interpolator tile when the lighter or darker buttons are
pressed. The default is 5. Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNoptionLabel
Specifies the text that appears inside the color model option menu
subwidget. The default is "Color Model:". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNpastelLabel
The label used to represent the pastels palette in the picker spectrum
option menu. The default text is "Pastels". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNpickerColors
A palette of ten colors that will be available through the user palette
menu option. If not specified, no user palette will appear in the
menu; otherwise, the user palette will become the default picker
palette. You can set this resource only at widget creation time.
Access is CG.
Note that the first item in the array is the red value of the first
spectrum tile, the second item is its green value, the third item is
its blue value, the fourth item is the second tile's red value, and so
on. Thus, this array must contain thirty elements if it is set.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNpickerLabel
Specifies the text that appears as the top item in the color model
option menu. The default text is "Picker". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNpickerTileHeight
The height of each individual spectrum tile, in pixels. The default is
30. Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNpickerTileWidth
The width of each individual spectrum tile, in pixels. The default is
30. Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNpickerTitleLabel
Specifies the text that appears centered above the picker widget. The
default text is "Spectrum". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNredLabel
Specifies the text that appears below the left end of the top scale
subwidget. The default is "Red". Access is CSG.
This resource is used in the RGB mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNrgbLabel
Specifies the text that appears as the third item in the color model
option menu. The default is "RGB". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNsatLabel
Specifies the text that appears to the left of the middle scale
subwidget. The default is "Saturation:". Access is CSG.
This resource is used in the HLS mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNsliderLabel
Specifies the text that appears above the left end of the top scale
subwidget. The default is "Percentage". Access is CSG.
This resource is used in the RGB mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNsmearLabel
Specifies the text of the Smear push button. The default text is
"Smear". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNspectrumLabel
The label used to represent the "rainbow" palette in the picker
spectrum option menu. The default text is "Spectrum". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNundoLabel
Specifies the text of the Undo push button. The default text is
"Undo". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNuserPaletteLabel
The label used to represent the application-defined user palette in the
spectrum option menu. The default text is "User palette". Access is
CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNvalueLabel
Specifies the text that appears above the column of text subwidgets.
The default is "Value". Access is CSG.
This resource is used in the RGB mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
DXmNvividLabel
The label used to represent the vivids palette in the picker spectrum
option menu. The default text is "Vivids". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNwarmerLabel
Specifies the text of the Warmer arrow button. The default text is
"Warmer". Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNwarmthIncrement
The amount of red or blue added to the color of each interpolator tile
when the warmer or cooler buttons are pressed. The default is 5000.
Access is CSG.
This resource is valid only if the default color mixer subwidget is
used; otherwise, the resource is ignored.
DXmNwhiteLabel
Specifies the text that appears below the right end of the middle scale
subwidget. The default is "White". Access is CSG.
This resource is used in the HLS mixer if the default color mixer
subwidget is used; otherwise, the resource is ignored.
Resource Information
The following resources inherited from XmBulletinBoard are supported
differently:
· The default for XmNdialogStyle is XmDIALOG_MODELESS.
· The default for XmNdialogTitle is "Color Mixing".
· The default for XmNresizePolicy is XmRESIZE_NONE.
Resource Information
typedef struct
{
int reason;
XEvent *event;
unsigned short newred;
unsigned short newgrn;
unsigned short newblu;
char *newname;
unsigned short origred;
unsigned short origgrn;
unsigned short origblu*L;
} DXmColorMixCallbackStruct;
Callback Field Descriptions
reason
An integer set to the callback reason. See the Callback Reasons section
for the values that are valid for this widget.
event
A pointer to the X event structure describing the event that generated
this callback.
newred
The new red color value for the color mixing widget.
newgrn
The new green color value for the color mixing widget.
newblu
The new blue color value for the color mixing widget.
newname
Passes a color name to an application. If the user selects a named
color from the Browser and then triggers a callback to the application
without modifying the new color, the newname field of the callback data
structure is filled in with a pointer to an ASCII, null-terminated
string that contains the color's X11 name. This string is read-only,
and should not be freed or modified.
If a color is generated in one of the other color models, or generated
in the browser and subsequently modified, the newname field in the
callback structure is set to Null.
origred
The original red color value for the color mixing widget.
origgrn
The original green color value for the color mixing widget.
origblu
The original blue color value for the color mixing widget.
Callback Reasons
XmCR_ACTIVATE
The user has activated the OK push button.
XmCR_APPLY
The user has activated the Apply push button.
XmCR_CANCEL
The user has activated the Cancel push button.
Resource Information
The color mixing widget completely controls the layout of its children.
Resizing
The color mixing widget computes the smallest possible size required to
enclose all of its children, including any of the variably sized color
mixing subwidgets. The size remains fixed while the user selects different
color models from the option menu.
Inherited Resources
DXmCreateColorMixDialog inherits behaviour and resources from the following
superclasses:
Core Resource Set
Composite Resource Set
Constraint Resource Set
XmManager Resource Set
XmBulletinBoard Resource Set
RETURN VALUES
The identifier (widget ID) of the created color mixing widget.
SEE ALSO
DXmCreateColorMix(3X), DXmColorMixGetNewColor(3X),
DXmColorMixSetNewColor(3X)
|
Index for
Section 3X |
|
|
Alphabetical
listing for D |
|
 |
Top of
page |
|