NAME
SmeLine object − menu item separator.
SYNOPSIS
Public Headers:<X11/StringDefs.h> <X11/Xaw/SmeLine.h>
Private Header:<X11/Xaw/SmeLineP.h>
Class Name:SmeLine
Class Pointer:smeLineObjectClass
Instantiation:widget = XtCreateWidget(name, smeLineObjectClass, ...)
CLASS HIERARCHY
Object → RectObj → Sme → SmeLine
DESCRIPTION
The SmeLine object is used to add a horizontal line or menu separator to a SimpleMenu. Since each menu entry is an independent object, the application is able to change the color, height, and other attributes of the menu entries, on an entry-by-entry basis. This entry is not selectable, and does not highlight when the pointer cursor is over it.
RESOURCES
The resources associated with the SmeLine object are defined in this section, and affect only the single menu entry specified by this object.
| Name (XtN...) | Class Type | Default | Description | |||
| XtNancestor− Sensitive |
Boolean | True | Sensitivity state of the ancestors of this widget: a widget is insensitive if either it or any of its ancestors is insensitive. | |||
| XtNborderWidth | Dimension | 1 | Width of button border. | |||
| XtNcallback | XtCallbackList | NULL | Callback for notify action. | |||
| XtNdestroy− Callback |
XtCallbackList | NULL | Callbacks for XtDestroyWidget(). | |||
| XtNforeground | Pixel | XtDefault− Foreground |
Foreground color. | |||
| XtNheight | Dimension | 0 | Object height. | |||
| XtNlineWidth | Dimension | 1 | See below. | |||
| XtNsensitive | Boolean | True | Whether widget receives input. | |||
| XtNstipple | Pixmap | XtUnspecified− Pixmap |
See below. | |||
| XtNwidth | Dimension | 1 | Object width. | |||
| XtNx | Position | 0 | x-coordinate in pixels. | |||
| XtNy | Position | 0 | y-coordinate in pixels. | |||
XtNforeground
A pixel value that indexes the parent’s colormap to derive the foreground color of the menu entry’s window. This color is also used to render all 1’s in XtNleftBitmap and XtNrightBitmap.
XtNlineWidth
The width of the horizontal line to be displayed.
XtNstipple
If a bitmap is specified for this resource, the line will be stippled through it. This allows the menu separator to be rendered as something more exciting than just a line. For instance, if you define a stipple that is a chain link, then your menu separators will look like chains.
SEE ALSO
MenuButton, SimpleMenu, Sme, SmeBSB.