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)