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;