NAME
SmeBSB object − basic menu entry.
SYNOPSIS
Public Headers:<X11/StringDefs.h> <X11/Xaw/SmeBSB.h>
Private Header:<X11/Xaw/SmeBSBP.h>
Class Name:SmeBSB
Class Pointer:smeBSBObjectClass
Instantiation:widget = XtCreateWidget(name, smeBSBObjectClass, ...)
CLASS HIERARCHY
Object → RectObj → Sme → SmeBSB
DESCRIPTION
The SmeBSB object is used to create a menu entry that contains a string, and optional bitmaps in its left and right margins. The parent is expected to be SimpleMenu. Since each menu entry is an independent object, the application is able to change the font, color, height, and other attributes of the menu entries, on an entry-by-entry basis.
RESOURCES
The resources associated with the SmeBSB 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 | (D) 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(). | |||
| XtNfont | XFontStruct∗ | XtDefaultFont | Menu entry font. | |||
| XtNforeground | Pixel | XtDefault− Foreground |
Foreground color. | |||
| XtNheight | Dimension | Font height + XtNvertSpace |
(A) Menu entry height. | |||
| XtNjustify | XtJustify | XtJustifyCenter | Type of text alignment. | |||
| XtNlabel | String | Name of widget. | Menu entry text. | |||
| XtNleftBitmap | Pixmap | XtUnspecified− Pixmap |
See below. | |||
| XtNleftMargin | Dimension | 4 | See below. | |||
| XtNrightBitmap | Pixmap | XtUnspecified− Pixmap |
See below. | |||
| XtNrightMargin | Dimension | 4 | See below. | |||
| XtNsensitive | Boolean | True | Whether widget receives input. | |||
| vertSpace | int | 25 | ||||
| XtNwidth | Dimension | Text width + margins | (A) Width of menu entry. | |||
| XtNx | Position | 0 | x-coordinate in pixels. | |||
| XtNy | Position | 0 | y-coordinate in pixels. | |||
The new resources (not inherited from superclasses) associated with the SmeBSB object are:
XtNforeground
Specifies 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.
XtNjustify
Specifies how the label is to be rendered between the left and right margins when the space is wider than the actual text. This resource may be specified with the values XtJustifyLeft, XtJustifyCenter, or XtJustifyRight. When specifying the justification from a resource file, the values left, center, or right may be used.
XtNlabel
Specifies the string to be display in the menu entry. The exact location of this string within the bounds of the menu entry is controlled by the resources XtNleftMargin, XtNrightMargin, XtNvertSpace, and XtNjustify.
XtNleftBitmap
XtNrightBitmap
Specifies a name of a bitmap to display in the left or right margin of the menu entry. All 1’s in the bitmap are rendered in the foreground color of the SimpleMenu widget, and all 0’s will be drawn in the background color of the SimpleMenu widget. The programmer must ensure that the menu entry is tall enough and that the appropriate margin is wide enough to accept the bitmap. If care is not taken, the bitmap might extend into either another menu entry or this entry’s label.
XtNleftMargin
XtNrightMargin
Specifies the amount of space (in pixels) to leave between the edge of the menu entry and the label string.
XtNvertSpace
Specifies the amount of vertical padding to place around the label of a menu entry. The label and bitmaps are always centered vertically within the menu. Values for this resource are expressed as a percentage of the font’s height. The default value (25) increases the default height to 125% of the font’s height.
SEE ALSO
MenuButton, SimpleMenu, Sme, SmeLine.