XmBulletinBoard(3)

1XmBulletinBoard(3)              LessTif Manuals             XmBulletinBoard(3)
2
3
4

NAME

6       XmBulletinBoard - Motif-compatible widget for geometry management
7

SYNOPSIS

9       #include <Xm/BulletinB.h>
10
11       XmBulletinBoard
12
13       XmCreateBulletinBoard(3x)
14

DESCRIPTION

16       XmBulletinBoard  is  a widget that serves two main purposes.  It is the
17       basic widget for geometry management, of which many other manager  wid‐
18       gets are subclassed.  XmBulletinBoard is also designed to be the widget
19       to build dialogs with.
20
21       Both the layout (geometry)  management  and  the  dialog  features  are
22       excellent reasons to subclass from XmBulletinBoard.
23
24       Finally,  XmBulletinBoard and its subclasses are recognised and treated
25       especially by XmDialogShell.  In normal circumstances,  managing  (with
26       XtManageChild(3x)  )  a  XmBulletinBoard  which  is a direct child of a
27       XmDialogShell will pop up a dialog window.
28

X RESOURCES

30       Name                  Class                Type                  Default   Access
31       ──────────────────────────────────────────────────────────────────────────────────
32       XmNshadowType         XmCShadowType        ShadowType            NULL      CSG
33       XmNshadowThickness    XmCShadowThickness   HorizontalDimension   NULL      CSG
34       XmNmarginWidth        XmCMarginWidth       HorizontalDimension   NULL      CSG
35       XmNmarginHeight       XmCMarginHeight      VerticalDimension     NULL      CSG
36       XmNdefaultButton      XmCWidget            Widget                NULL      CSG
37       XmNcancelButton       XmCWidget            Widget                NULL      CSG
38       XmNfocusCallback      XmCCallback          Callback              NULL      CSG
39       XmNmapCallback        XmCCallback          Callback              NULL      CSG
40       XmNunmapCallback      XmCCallback          Callback              NULL      CSG
41       XmNbuttonFontList     XmCButtonFontList    FontList              NULL      CSG
42       XmNlabelFontList      XmCLabelFontList     FontList              NULL      CSG
43       XmNtextFontList       XmCTextFontList      FontList              NULL      CSG
44       XmNtextTranslations   XmCTranslations      TranslationTable      NULL      CSG
45       XmNallowOverlap       XmCAllowOverlap      Boolean               NULL      CSG
46       XmNautoUnmanage       XmCAutoUnmanage      Boolean               NULL      CSG
47       XmNdefaultPosition    XmCDefaultPosition   Boolean               NULL      CSG
48       XmNresizePolicy       XmCResizePolicy      ResizePolicy          NULL      CSG
49       XmNnoResize           XmCNoResize          Boolean               NULL      CSG
50       XmNdialogStyle        XmCDialogStyle       DialogStyle           NULL      CSG
51       XmNdialogTitle        XmCDialogTitle       XmString              (null)    CSG
52
53       XmNshadowType
54
55       XmNshadowThickness
56
57       XmNmarginWidth
58
59       XmNmarginHeight
60
61       XmNdefaultButton
62
63       XmNcancelButton is a resource which contains the widget ID for the can‐
64       cel  button which is automatically created when you call some functions
65       such as XmCreateMessageBox(3x).  The cancel button can  be  removed  by
66       calling  XtDestroyWidget(3x)  or  it  can be hidden by calling XtUnman‐
67       ageChild(3x).
68
69       XmNfocusCallback
70
71       XmNmapCallback is a callback list which is called prior to mapping  the
72       dialog.
73
74       XmNunmapCallback
75
76       XmNbuttonFontList specifies the fontList used for button children.
77
78       XmNlabelFontList specifies the fontList used for label children.
79
80       XmNtextFontList    specifies    the    fontList   for   XmText(3x)   or
81       XmTextField(3x) widgets which are children of the bulletinboard.
82
83       XmNtextTranslations
84
85       XmNallowOverlap
86
87       XmNautoUnmanage specifies that the dialog will automatically  pop  down
88       when  the user activates a button in the dialog other than the Apply or
89       Help buttons.  If this resource is not set, the dialog must  be  popped
90       down  by  an action in the application (most likely by calling XtUnman‐
91       ageChild(3x) from inside some callback function).
92
93       XmNdefaultPosition will position the dialog centered above  the  window
94       that  calls  it.   If this resources is not set, the application should
95       position the dialog e.g. by setting  XmNx  and  XmNy  from  a  function
96       called from the XmNokCallback.
97
98       XmNresizePolicy
99
100       XmNnoResize
101
102       XmNdialogStyle  This  only  works  if the bulletinboard is a child of a
103       XmDialogShell(3x) widget.
104
105       XmNdialogTitle specifies the dialog's title, which  is  passed  to  the
106       window  manager.   This only works if the bulletinboard is a child of a
107       XmDialogShell(3x) widget.
108

CLASS HIERARCHY

110       Object(3)  Rect(3)  UnNamedObj(3)  Core(3)  Composite(3)  Constraint(3)
111       XmManager(3) XmBulletinBoard(3)
112

CALLBACKS

114       There is no widget specific structure passed by the callback functions.
115       The data passed is a pointer to a structure of type XmAnyCallbackStruct
116       :
117        typedef struct {
118           int reason;
119           XEvent *event;
120        } XmAnyCallbackStruct;
121

CONVENIENCE FUNCTIONS

123       XmCreateBulletinBoardDialog(3x)
124