# SmeBSB Object

    Application Header file	<X11/Xaw/SmeBSB.h>

    Class Header file	<X11/Xaw/SmeBSBP.h>

    Class		smeBSBObjectClass

    Class Name	SmeBSB

    Superclass	Sme

The SmeBSB object is used to create a menu entry that contains a string, and optional bitmaps in its left and right margins. 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. The format of the string may either be the encoding of the 8 bit `font` utilized, or in a multi-byte encoding for use with a `fontSet`.

## 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 | Class | Type | Notes | Default Value
--- | --- | --- | --- | ---
ancestorSensitive | AncestorSensitive | Boolean | D | True
callback | Callback | Callback |  | NULL
destroyCallback | Callback | XtCallbackList |  | NULL
font | Font | FontStruct |  | XtDefaultFont
fontSet | FontSet | XFontSet |  | XtDefaultFontSet
foreground | Foreground | Pixel |  | XtDefaultForeground
height | Height | Dimension | A | Font height + `vertSpace`
international | International | Boolean | C | False
justify | Justify | Justify |  | XtjustifyLeft
label | Label | String |  | NULL
leftBitmap | LeftBitmap | Pixmap |  | XtUnspecifiedPixmap
leftMargin | leftMargin | Dimension |  | 4
rightBitmap | RightBitmap | Pixmap |  | XtUnspecifiedPixmap
rightMargin | rightMargin | Dimension |  | 4
sensitive | Sensitive | Boolean |  | True
vertSpace | VertSpace | int |  | 25
width | Width | Dimension | A | TextWidth + margins

callback

  All callback functions on this list are called when the SimpleMenu notifies this entry that the user has selected it.

font

  The text font to use when displaying the `label`, when the `international` resource is `false`.

fontSet

  The text font set to use when displaying the `label`, when the `international` resource is `true`.

foreground

  A pixel value which indexes the SimpleMenu's colormap to derive the foreground color of the menu entry's window. This color is also used to render all 1's in the left and right `bitmaps`. Keep in mind that the SimpleMenu widget will force the width of all menu entries to be the width of the longest entry.

justify

  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.

label

  This is a the string that will be displayed in the menu entry. The exact location of this string within the bounds of the menu entry is controlled by the `leftMargin`, `rightMargin`, `vertSpace`, and `justify` resources.

leftBitmap

rightBitmap

  This is a name of a bitmap to display in the left or right margin of the menu entry. All 1's in the bitmap will be rendered in the foreground color, and all 0's will be drawn in the background color of the SimpleMenu widget. It is the programmers' responsibility to make sure that the menu entry is tall enough, and the appropriate margin wide enough to accept the bitmap. If care is not taken the bitmap may extend into another menu entry, or into this entry's label.

leftMargin

rightMargin

  This is the amount of space (in pixels) that will be left between the edge of the menu entry and the label string.

vertSpace

  This is the amount of vertical padding, expressed as a percentage of the height of the font, that is to be placed around the label of a menu entry.. The label and bitmaps are always centered vertically within the menu. The default value for this resource (25) causes the default height to be 125% of the height of the font.