XmSeparatorGadget(X3mot)

Synopsis

#include <Xm/SeparatoG.h>

Description

Lines drawn within the SeparatorGadget are automatically centered within the height of the gadget for a horizontal orientation and centered within the width of the gadget for a vertical orientation. An XtSetValues with a new XmNseparatorType resizes the widget to its minimal height (for horizontal orientation) or its minimal width (for vertical orientation) unless height or width is explicitly set in the XtSetValues call.

SeparatorGadget does not draw shadows around the separator. The Gadget resource XmNshadowThickness is used for the SeparatorGadget's thickness when XmNseparatorType is XmSHADOW_ETCHED_IN, XmSHADOW_ETCHED_IN_DASH, XmSHADOW_ETCHED_OUT, or XmSHADOW_ETCHED_OUT_DASH.

SeparatorGadget does not highlight and allows no traversing. The Gadget resource XmNtraversalOn is forced to False.

Classes

New resources

XmSeparatorGadget resource set

Name	Class	Type	Default	Access
XmNmargin	XmCMargin	Dimension	0	CSG
XmNorientation	XmCOrientation	unsigned char	XmHORIZONTAL	CSG
XmNseparatorType	XmCSeparatorType	unsigned char	XmSHADOW_ETCHED_IN	CSG

 +-----------------+------------------+---------------+--------------------+--------+
 |Name             | Class            | Type          | Default            | Access |
 +-----------------+------------------+---------------+--------------------+--------+
 |XmNmargin        | XmCMargin        | Dimension     | 0                  | CSG    |
 +-----------------+------------------+---------------+--------------------+--------+
 |XmNorientation   | XmCOrientation   | unsigned char | XmHORIZONTAL       | CSG    |
 +-----------------+------------------+---------------+--------------------+--------+
 |XmNseparatorType | XmCSeparatorType | unsigned char | XmSHADOW_ETCHED_IN | CSG    |
 +-----------------+------------------+---------------+--------------------+--------+

XmNmargin

For horizontal orientation, specifies the space on the left and right sides between the border of SeparatorGadget and the line drawn. For vertical orientation, specifies the space on the top and bottom between the border of SeparatorGadget and the line drawn.

XmNorientation

Specifies whether SeparatorGadget is displayed vertically or horizontally. This resource can have values of XmVERTICAL and XmHORIZONTAL.

XmNseparatorType

Specifies the type of line drawing to be done in the Separator widget.

• XmSINGLE_LINE -- single line.

• XmDOUBLE_LINE -- double line.

• XmSINGLE_DASHED_LINE -- single-dashed line.

• XmDOUBLE_DASHED_LINE -- double-dashed line.

• XmNO_LINE -- no line.

• XmSHADOW_ETCHED_IN -- a line whose shadows give the effect of a line etched into the window. The thickness of the line is equal to the value of XmNshadowThickness. For horizontal orientation, the top shadow is drawn in XmNtopShadowColor and the bottom shadow is drawn in XmNbottomShadowColor. For vertical orientation, the left edge is drawn in XmNtopShadowColor and the right edge is drawn in XmNbottomShadowColor.

• XmSHADOW_ETCHED_OUT -- a line whose shadows give the effect of an etched line coming out of the window. The thickness of the line is equal to the value of XmNshadowThickness. For horizontal orientation, the top shadow is drawn in XmNbottomShadowColor and the bottom shadow is drawn in XmNtopShadowColor. For vertical orientation, the left edge is drawn in XmNbottomShadowColor and the right edge is drawn in XmNtopShadowColor.

• XmSHADOW_ETCHED_IN_DASH -- identical to XmSHADOW_ETCHED_IN except a series of lines creates a dashed line.

• XmSHADOW_ETCHED_OUT_DASH -- identical to XmSHADOW_ETCHED_OUT except a series of lines creates a dashed line.

Inherited resources

XmGadget resource set

Name	Class	Type	Default	Access
XmNbottomShadowColor	XmCBottomShadowColor	Pixel	dynamic	G
XmNhelpCallback	XmCCallback	XtCallbackList	NULL	C
XmNhighlightColor	XmCHighlightColor	Pixel	dynamic	G
XmNhighlightOnEnter	XmCHighlightOnEnter	Boolean	False	CSG
XmNhighlightThickness	XmCHighlightThickness	Dimension	0	CSG
XmNnavigationType	XmCNavigationType	XmNavigationType	XmNONE	CSG
XmNshadowThickness	XmCShadowThickness	Dimension	2	CSG
XmNtopShadowColor	XmCTopShadowColor	Pixel	dynamic	G
XmNtraversalOn	XmCTraversalOn	Boolean	False	G
XmNunitType	XmCUnitType	unsigned char	dynamic	CSG
XmNuserData	XmCUserData	XtPointer	NULL	CSG

 +----------------------+-----------------------+------------------+---------+--------+
 |Name                  | Class                 | Type             | Default | Access |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNbottomShadowColor  | XmCBottomShadowColor  | Pixel            | dynamic | G      |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNhelpCallback       | XmCCallback           | XtCallbackList   | NULL    | C      |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNhighlightColor     | XmCHighlightColor     | Pixel            | dynamic | G      |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNhighlightOnEnter   | XmCHighlightOnEnter   | Boolean          | False   | CSG    |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNhighlightThickness | XmCHighlightThickness | Dimension        | 0       | CSG    |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNnavigationType     | XmCNavigationType     | XmNavigationType | XmNONE  | CSG    |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNshadowThickness    | XmCShadowThickness    | Dimension        | 2       | CSG    |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNtopShadowColor     | XmCTopShadowColor     | Pixel            | dynamic | G      |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNtraversalOn        | XmCTraversalOn        | Boolean          | False   | G      |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNunitType           | XmCUnitType           | unsigned char    | dynamic | CSG    |
 +----------------------+-----------------------+------------------+---------+--------+
 |XmNuserData           | XmCUserData           | XtPointer        | NULL    | CSG    |
 +----------------------+-----------------------+------------------+---------+--------+

RectObj resource set

Name	Class	Type	Default	Access
XmNancestorSensitive	XmCSensitive	Boolean	dynamic	G
XmNborderWidth	XmCBorderWidth	Dimension	0	CSG
XmNheight	XmCHeight	Dimension	dynamic	CSG
XmNsensitive	XmCSensitive	Boolean	True	CSG
XmNwidth	XmCWidth	Dimension	dynamic	CSG
XmNx	XmCPosition	Position	0	CSG
XmNy	XmCPosition	Position	0	CSG

 +---------------------+----------------+-----------+---------+--------+
 |Name                 | Class          | Type      | Default | Access |
 +---------------------+----------------+-----------+---------+--------+
 |XmNancestorSensitive | XmCSensitive   | Boolean   | dynamic | G      |
 +---------------------+----------------+-----------+---------+--------+
 |XmNborderWidth       | XmCBorderWidth | Dimension | 0       | CSG    |
 +---------------------+----------------+-----------+---------+--------+
 |XmNheight            | XmCHeight      | Dimension | dynamic | CSG    |
 +---------------------+----------------+-----------+---------+--------+
 |XmNsensitive         | XmCSensitive   | Boolean   | True    | CSG    |
 +---------------------+----------------+-----------+---------+--------+
 |XmNwidth             | XmCWidth       | Dimension | dynamic | CSG    |
 +---------------------+----------------+-----------+---------+--------+
 |XmNx                 | XmCPosition    | Position  | 0       | CSG    |
 +---------------------+----------------+-----------+---------+--------+
 |XmNy                 | XmCPosition    | Position  | 0       | CSG    |
 +---------------------+----------------+-----------+---------+--------+

Object resource set

Name	Class	Type	Default	Access
XmNdestroyCallback	XmCCallback	XtCallbackList	NULL	C

 +-------------------+-------------+----------------+---------+--------+
 |Name               | Class       | Type           | Default | Access |
 +-------------------+-------------+----------------+---------+--------+
 |XmNdestroyCallback | XmCCallback | XtCallbackList | NULL    | C      |
 +-------------------+-------------+----------------+---------+--------+

Behavior

References