XmeDrawSeparator — Draws several different types of line-based separators
#include <Xm/DrawP.h>
void XmeDrawSeparator(display, drawable, top_gc, bottom_gc, separator_gc, x, y, width, height, shadow_thickness, margin, orientation, separator_type);XmeDrawSeparator draws a Motif-style, three-dimensional line to separate various components.
| display | Specifies the display. | ||||||||||||||||||||||||||||
| drawable | Specifies the drawable on which the separator will be rendered. Typically, the drawable will be a widget window. | ||||||||||||||||||||||||||||
| top_gc | Specifies the graphics context of the top shadow on those separators that have shadows. (The separators have shadows when the separator_type is XmSHADOW_ETCHED_IN, XmSHADOW_ETCHED_OUT, XmSHADOW_ETCHED_IN_DASH, or XmSHADOW_ETCHED_OUT_DASH.) The definition of "top" depends on the values of both the separator_type and the orientation. Suppose the separator_type is XmSHADOW_ETCHED_IN or XmSHADOW_ETCHED_IN_DASH. If the orientation is XmHORIZONTAL, then the top shadow is the shadow above the separator and the bottom shadow is the shadow below the separator. However, if the orientation is XmVERTICAL, then the top shadow is immediately to the left of the separator and the bottom shadow is immediately to the right of the separator. Now consider the results if the separator_type is XmSHADOW_ETCHED_OUT or XmSHADOW_ETCHED_OUT_DASH. If the orientation is XmHORIZONTAL, the top shadow is the shadow below the separator, and the bottom shadow is the shadow above the separator. However, if the orientation is XmVERTICAL, then the top shadow is immediately to the right of the separator, and the bottom shadow is immediately to the left of the separator. | ||||||||||||||||||||||||||||
| bottom_gc | Specifies the graphics context of the bottom shadow on those separators that have shadows. (See the description of top_gc for more information.) | ||||||||||||||||||||||||||||
| separator_gc | Specifies the graphics context of the separator itself when the separator_type is XmSINGLE_LINE, XmDOUBLE_LINE, XmSINGLE_DASHED_LINE, or XmDOUBLE_DASHED_LINE. | ||||||||||||||||||||||||||||
| x | Specifies the x-coordinate of the start of the bounding box, in pixels. The XmeDrawSeparator function will draw the separator centered within the bounding box. However, the separator's exact position depends not only on the bounding box but also on the margin. (See margin for details.) | ||||||||||||||||||||||||||||
| y | Specifies the y-coordinate of the start of the bounding box, in pixels. The separator will be drawn centered within the bounding box. However, the separator's exact position depends not only on the bounding box but also on the margin. (See margin for details.) | ||||||||||||||||||||||||||||
| width | Specifies the width of the bounding box, in pixels. | ||||||||||||||||||||||||||||
| height | Specifies the height of the bounding box, in pixels. | ||||||||||||||||||||||||||||
| shadow_thickness | Specifies the shadow thickness when separator_type is XmSHADOW_ETCHED_IN_DASH, XmSHADOW_ETCHED_OUT_DASH, XmSHADOW_ETCHED_IN, or XmSHADOW_ETCHED_OUT. The value of shadow_thickness has no effect when the separator_type is XmSINGLE_LINE, XmDOUBLE_LINE, XmSINGLE_DASHED_LINE, XmDOUBLE_DASHED_LINE, or XmNO_LINE. | ||||||||||||||||||||||||||||
| margin | If the orientation is XmHORIZONTAL, margin specifies the gap between the left side of the bounding box and the left endpoint of the separator. The margin also specifies the gap, in pixels, between the right side of the bounding box and the right endpoint of the separator. If the orientation is XmVERTICAL, margin specifies the gap between the top side of the bounding box and the top endpoint of the separator. The margin also specifies the gap, in pixels, between the bottom side of the bounding box and the bottom endpoint of the separator. | ||||||||||||||||||||||||||||
| orientation | Specifies the orientation of the line, either horizontal (specify XmHORIZONTAL) or vertical (specify XmVERTICAL). | ||||||||||||||||||||||||||||
| separator_type | Specifies the type of line and shadow to be used as a separator. The possible values are as follows:
|
XmSeparator(3).