XmBulletinBoard(3)

NAME
XmBulletinBoard - Motif-compatible widget for geometry management

SYNOPSIS
#include <Xm/BulletinB.h>

XmBulletinBoard

XmCreateBulletinBoard(3x)

DESCRIPTION
XmBulletinBoard is a widget that serves two main purposes. It is the basic widget for geometry management, of which many other manager widgets are subclassed. XmBulletinBoard is also designed to be the widget to build dialogs with.

Both the layout (geometry) management and the dialog features are excellent reasons to subclass from XmBulletinBoard.

Finally, XmBulletinBoard and its subclasses are recognised and treated especially by XmDialogShell. In normal circumstances, managing (with XtManageChild(3x) ) a XmBulletinBoard which is a direct child of a XmDialogShell will pop up a dialog window.

X RESOURCES
Name | Class | Type | Default | Access
XmNshadowType | XmCShadowType | ShadowType | NULL | CSG
XmNshadowThickness | XmCShadowThickness | HorizontalDimension | NULL | CSG
XmNmarginWidth | XmCMarginWidth | HorizontalDimension | NULL | CSG
XmNmarginHeight | XmCMarginHeight | VerticalDimension | NULL | CSG
XmNdefaultButton | XmCWidget | Widget | NULL | CSG
XmNcancelButton | XmCWidget | Widget | NULL | CSG
XmNfocusCallback | XmCCallback | Callback | NULL | CSG
XmNmapCallback | XmCCallback | Callback | NULL | CSG
XmNunmapCallback | XmCCallback | Callback | NULL | CSG
XmNbuttonFontList | XmCButtonFontList | FontList | NULL | CSG
XmNlabelFontList | XmCLabelFontList | FontList | NULL | CSG
XmNtextFontList | XmCTextFontList | FontList | NULL | CSG
XmNtextTranslations | XmCTranslations | TranslationTable | NULL | CSG
XmNallowOverlap | XmCAllowOverlap | Boolean | NULL | CSG
XmNautoUnmanage | XmCAutoUnmanage | Boolean | NULL | CSG
XmNdefaultPosition | XmCDefaultPosition | Boolean | NULL | CSG
XmNresizePolicy | XmCResizePolicy | ResizePolicy | NULL | CSG
XmNnoResize | XmCNoResize | Boolean | NULL | CSG
XmNdialogStyle | XmCDialogStyle | DialogStyle | NULL | CSG
XmNdialogTitle | XmCDialogTitle | XmString | (null) | CSG

XmNshadowType

XmNshadowThickness

XmNmarginWidth

XmNmarginHeight

XmNdefaultButton

XmNcancelButton is a resource which contains the widget ID for the cancel button which is automatically created when you call some functions such as XmCreateMessageBox(3x). The cancel button can be removed by calling XtDestroyWidget(3x) or it can be hidden by calling XtUnmanageChild(3x).

XmNfocusCallback

XmNmapCallback is a callback list which is called prior to mapping the dialog.

XmNunmapCallback

XmNbuttonFontList specifies the fontList used for button children.

XmNlabelFontList specifies the fontList used for label children.

XmNtextFontList specifies the fontList for XmText(3x) or XmTextField(3x) widgets which are children of the bulletinboard.

XmNtextTranslations

XmNallowOverlap

XmNautoUnmanage specifies that the dialog will automatically pop down when the user activates a button in the dialog other than the Apply or Help buttons. If this resource is not set, the dialog must be popped down by an action in the application (most likely by calling XtUnmanageChild(3x) from inside some callback function).

XmNdefaultPosition will position the dialog centered above the window that calls it. If this resources is not set, the application should position the dialog e.g. by setting XmNx and XmNy from a function called from the XmNokCallback.

XmNresizePolicy

XmNnoResize

XmNdialogStyle This only works if the bulletinboard is a child of a XmDialogShell(3x) widget.

XmNdialogTitle specifies the dialog's title, which is passed to the window manager. This only works if the bulletinboard is a child of a XmDialogShell(3x) widget.

CLASS HIERARCHY
Object(3) Rect(3) UnNamedObj(3) Core(3) Composite(3) Constraint(3) XmManager(3) XmBulletinBoard(3)

CALLBACKS
There is no widget specific structure passed by the callback functions. The data passed is a pointer to a structure of type XmAnyCallbackStruct :
 typedef struct {
    int reason;
    XEvent *event;
 } XmAnyCallbackStruct;

CONVENIENCE FUNCTIONS
XmCreateBulletinBoardDialog(3x)

SEE ALSO
XmDialogShell(3x)