xmbulletinboard(3)
NAME
XmBulletinBoard
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)