Blame doc/man/man3/XmBulletinBoard.3

Packit b099d7
'\" t
Packit b099d7
...\" BulletB.sgm /main/11 1996/09/08 20:25:26 rws $
Packit b099d7
.de P!
Packit b099d7
.fl
Packit b099d7
\!!1 setgray
Packit b099d7
.fl
Packit b099d7
\\&.\"
Packit b099d7
.fl
Packit b099d7
\!!0 setgray
Packit b099d7
.fl			\" force out current output buffer
Packit b099d7
\!!save /psv exch def currentpoint translate 0 0 moveto
Packit b099d7
\!!/showpage{}def
Packit b099d7
.fl			\" prolog
Packit b099d7
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
Packit b099d7
\!!psv restore
Packit b099d7
.
Packit b099d7
.de pF
Packit b099d7
.ie     ?\\*(f1?? .ds f1 \\n(.f
Packit b099d7
.el .ie ?\\*(f2?? .ds f2 \\n(.f
Packit b099d7
.el .ie ?\\*(f3?? .ds f3 \\n(.f
Packit b099d7
.el .ie ?\\*(f4?? .ds f4 \\n(.f
Packit b099d7
.el .tm ? font overflow
Packit b099d7
.ft \\$1
Packit b099d7
..
Packit b099d7
.de fP
Packit b099d7
.ie     !?\\*(f4?? \{\
Packit b099d7
.	ft \\*(f4
Packit b099d7
.	ds f4\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f3?? \{\
Packit b099d7
.	ft \\*(f3
Packit b099d7
.	ds f3\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f2?? \{\
Packit b099d7
.	ft \\*(f2
Packit b099d7
.	ds f2\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f1?? \{\
Packit b099d7
.	ft \\*(f1
Packit b099d7
.	ds f1\"
Packit b099d7
'	br \}
Packit b099d7
.el .tm ? font underflow
Packit b099d7
..
Packit b099d7
.ds f1\"
Packit b099d7
.ds f2\"
Packit b099d7
.ds f3\"
Packit b099d7
.ds f4\"
Packit b099d7
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
Packit b099d7
.TH "XmBulletinBoard" "library call"
Packit b099d7
.SH "NAME"
Packit b099d7
\fBXmBulletinBoard\fP \(em The BulletinBoard widget class
Packit b099d7
.iX "XmBulletinBoard"
Packit b099d7
.iX "widget class" "BulletinBoard"
Packit b099d7
.SH "SYNOPSIS"
Packit b099d7
.PP
Packit b099d7
.nf
Packit b099d7
#include <Xm/BulletinB\&.h>
Packit b099d7
.fi
Packit b099d7
.SH "DESCRIPTION"
Packit b099d7
.PP
Packit b099d7
BulletinBoard is a composite widget that provides simple geometry
Packit b099d7
management for child widgets\&.
Packit b099d7
It does not force positioning on its children, but can be set to reject
Packit b099d7
geometry requests that result in overlapping children\&.
Packit b099d7
BulletinBoard is the base widget for most dialog widgets and is also used
Packit b099d7
as a general container widget\&.
Packit b099d7
.PP
Packit b099d7
Modal and modeless dialogs are implemented as collections of widgets that
Packit b099d7
include a DialogShell, a BulletinBoard (or subclass) child of the shell,
Packit b099d7
and various dialog components (buttons, labels, and so on) that are children
Packit b099d7
of BulletinBoard\&.
Packit b099d7
BulletinBoard defines callbacks useful for dialogs (focus, map, unmap),
Packit b099d7
which are available for application use\&.
Packit b099d7
If its parent is a DialogShell, BulletinBoard passes title and input mode
Packit b099d7
(based on dialog style)
Packit b099d7
information to the parent, which is responsible for appropriate communication
Packit b099d7
with the window manager\&.
Packit b099d7
.PP
Packit b099d7
The default value for \fBXmNinitialFocus\fP is the value of
Packit b099d7
\fBXmNdefaultButton\fP\&.
Packit b099d7
.PP
Packit b099d7
BulletinBoard uses the \fBXmQTtakesDefault\fP trait, and
Packit b099d7
holds the \fBXmQTdialogShellSavvy\fP and \fBXmQTspecifyRenderTable\fP
Packit b099d7
traits\&.
Packit b099d7
.SS "Classes"
Packit b099d7
.PP
Packit b099d7
BulletinBoard inherits behavior, resources, and traits
Packit b099d7
from the \fBCore\fP, \fBComposite\fP, \fBConstraint\fP,
Packit b099d7
and \fBXmManager\fP classes\&.
Packit b099d7
.PP
Packit b099d7
The class pointer is \fBxmBulletinBoardWidgetClass\fP\&.
Packit b099d7
.PP
Packit b099d7
The class name is \fBXmBulletinBoard\fP\&.
Packit b099d7
.SS "New Resources"
Packit b099d7
.PP
Packit b099d7
The following table defines a set of widget resources used by the programmer
Packit b099d7
to specify data\&. The programmer can also set the resource values for the
Packit b099d7
inherited classes to set attributes for this widget\&. To reference a
Packit b099d7
resource by name or by class in a \fB\&.Xdefaults\fP file, remove the \fBXmN\fP or
Packit b099d7
\fBXmC\fP prefix and use the remaining letters\&. To specify one of the defined
Packit b099d7
values for a resource in a \fB\&.Xdefaults\fP file, remove the \fBXm\fP prefix and use
Packit b099d7
the remaining letters (in either lowercase or uppercase, but include any
Packit b099d7
underscores between words)\&.
Packit b099d7
The codes in the access column indicate if the given resource can be
Packit b099d7
set at creation time (C),
Packit b099d7
set by using \fBXtSetValues\fP (S),
Packit b099d7
retrieved by using \fBXtGetValues\fP (G), or is not applicable (N/A)\&.
Packit b099d7
.PP
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBXmBulletinBoard Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNallowOverlap?XmCAllowOverlap?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNautoUnmanage?XmCAutoUnmanage?Boolean?True?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbuttonFontList?XmCButtonFontList?XmFontList?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbuttonRenderTable?XmCButtonRenderTable?XmRenderTable?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNcancelButton?XmCWidget?Widget?NULL?SG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdefaultButton?XmCWidget?Widget?NULL?SG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdefaultPosition?XmCDefaultPosition?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdialogStyle?XmCDialogStyle?unsigned char?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdialogTitle?XmCDialogTitle?XmString?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNfocusCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNlabelFontList?XmCLabelFontList?XmFontList?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNlabelRenderTable?XmCLabelRenderTable?XmRenderTable?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmapCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmarginHeight?XmCMarginHeight?Dimension?10?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmarginWidth?XmCMarginWidth?Dimension?10?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNnoResize?XmCNoResize?Boolean?False?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNresizePolicy?XmCResizePolicy?unsigned char?XmRESIZE_ANY?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNshadowType?XmCShadowType?unsigned char?XmSHADOW_OUT?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtextFontList?XmCTextFontList?XmFontList?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtextRenderTable?XmCTextRenderTable?XmRenderTable?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtextTranslations?XmCTranslations?XtTranslations?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNunmapCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.IP "\fBXmNallowOverlap\fP" 10
Packit b099d7
Controls the policy for overlapping child widgets\&.
Packit b099d7
If this resource is True, BulletinBoard allows geometry requests that result
Packit b099d7
in overlapping children\&.
Packit b099d7
.IP "\fBXmNautoUnmanage\fP" 10
Packit b099d7
Controls whether or not BulletinBoard is automatically unmanaged after a
Packit b099d7
button is activated\&.
Packit b099d7
If this resource is True on initialization and if the BulletinBoard\&'s
Packit b099d7
parent is a DialogShell, BulletinBoard adds a callback to button
Packit b099d7
children (PushButtons, PushButtonGadgets, and DrawnButtons) that
Packit b099d7
unmanages the BulletinBoard when a button is activated\&.
Packit b099d7
If this resource is False on initialization or if the BulletinBoard\&'s
Packit b099d7
parent is not a DialogShell, the
Packit b099d7
BulletinBoard is not automatically unmanaged\&.
Packit b099d7
For BulletinBoard subclasses with Apply or Help buttons, activating
Packit b099d7
those buttons does not automatically unmanage the BulletinBoard\&.
Packit b099d7
.IP "\fBXmNbuttonFontList\fP" 10
Packit b099d7
Specifies the font list used for button descendants\&. See the
Packit b099d7
\fBXmNbuttonRenderTable\fP resource\&.
Packit b099d7
.IP "\fBXmNbuttonRenderTable\fP" 10
Packit b099d7
Specifies the render table used for BulletinBoard\&'s button descendants\&.
Packit b099d7
If this value is NULL at initialization, the parent hierarchy of the widget
Packit b099d7
is searched for an ancestor that
Packit b099d7
holds the \fBXmQTspecifyRenderTable\fP trait\&.
Packit b099d7
If such an ancestor is found, the render table is initialized to the
Packit b099d7
\fBXmBUTTON_RENDER_TABLE\fP value of the ancestor widget\&. If no such
Packit b099d7
ancestor is
Packit b099d7
found, the default is implementation dependent\&. Refer to
Packit b099d7
\fBXmRenderTable\fP(3) for more information on the creation and structure
Packit b099d7
of a render table\&.
Packit b099d7
.IP "\fBXmNcancelButton\fP" 10
Packit b099d7
Specifies the widget ID of the \fBCancel\fP button\&. BulletinBoard\&'s
Packit b099d7
subclasses, which define a \fBCancel\fP button,
Packit b099d7
set this resource\&. BulletinBoard does not directly provide any behavior for
Packit b099d7
that button\&.
Packit b099d7
.IP "\fBXmNdefaultButton\fP" 10
Packit b099d7
Specifies the widget ID of the default button\&.
Packit b099d7
Some BulletinBoard subclasses, which define a default button,
Packit b099d7
set this resource\&. BulletinBoard defines translations and installs
Packit b099d7
accelerators that activate that button when \fBKActivate\fP is pressed
Packit b099d7
and the keyboard focus is not in another button\&.
Packit b099d7
.IP "\fBXmNdefaultPosition\fP" 10
Packit b099d7
Controls the positioning of a DialogShell managing a BulletinBoard\&.
Packit b099d7
If the BulletinBoard is not being managed by a DialogShell, then
Packit b099d7
this resource has no effect\&. If \fBXmNdefaultPosition\fP is True,
Packit b099d7
the DialogShell will center itself at the center of its own parent\&.
Packit b099d7
For example, if the parent of the DialogShell is an ApplicationShell,
Packit b099d7
then the center of the DialogShell will be at the same coordinates
Packit b099d7
as the center of the ApplicationShell\&.
Packit b099d7
If the DialogShell becomes unmapped (but stays managed) and then remapped,
Packit b099d7
this resource has no influence on the DialogShell\&'s position\&.
Packit b099d7
If this resource is False, the DialogShell does not automatically
Packit b099d7
center itself\&.
Packit b099d7
.IP "\fBXmNdialogStyle\fP" 10
Packit b099d7
Indicates the dialog style associated with the BulletinBoard\&.
Packit b099d7
If the parent of the BulletinBoard is a DialogShell, the parent\&'s
Packit b099d7
\fBXmNmwmInputMode\fP is set according to the value of this resource\&.
Packit b099d7
This resource can be set only if the BulletinBoard is unmanaged\&.
Packit b099d7
Possible values for this resource include the following:
Packit b099d7
.RS
Packit b099d7
.IP "\fBXmDIALOG_SYSTEM_MODAL\fP" 10
Packit b099d7
Used for dialogs that
Packit b099d7
must be responded to before
Packit b099d7
any other interaction in any application\&.
Packit b099d7
.IP "\fBXmDIALOG_PRIMARY_APPLICATION_MODAL\fP" 10
Packit b099d7
Used for dialogs that must
Packit b099d7
be responded to before some other interactions in
Packit b099d7
ancestors of the widget\&.
Packit b099d7
.IP "\fBXmDIALOG_APPLICATION_MODAL\fP" 10
Packit b099d7
Used for dialogs that must be
Packit b099d7
responded to before some other interactions in
Packit b099d7
ancestors of the widget\&. This value is the same as
Packit b099d7
\fBXmDIALOG_PRIMARY_APPLICATION_MODAL\fP, and remains for compatibility\&.
Packit b099d7
.IP "\fBXmDIALOG_FULL_APPLICATION_MODAL\fP" 10
Packit b099d7
Used for dialogs that must be
Packit b099d7
responded to before some other interactions in
Packit b099d7
the same application\&.
Packit b099d7
.IP "\fBXmDIALOG_MODELESS\fP" 10
Packit b099d7
Used for dialogs that do not interrupt interaction
Packit b099d7
of any application\&.
Packit b099d7
This is the default when the parent of the BulletinBoard is a DialogShell\&.
Packit b099d7
.IP "\fBXmDIALOG_WORK_AREA\fP" 10
Packit b099d7
Used for BulletinBoard widgets whose
Packit b099d7
parents are not DialogShells\&.
Packit b099d7
\fBXmNdialogStyle\fP is forced to have this value when the parent of the
Packit b099d7
BulletinBoard is not a DialogShell\&.
Packit b099d7
.RE
Packit b099d7
.IP "" 10
Packit b099d7
Posting a modal dialog in response to a button down or key down event
Packit b099d7
(via translation actions or callbacks) can cause the corresponding
Packit b099d7
button up or key up event to be lost\&. For example, posting a modal
Packit b099d7
dialog from an \fBXmNincrementCallback\fP of \fBXmScrollBar\fP will cause
Packit b099d7
the loss of the button up event, causing the \fBXmScrollBar\fP to
Packit b099d7
auto-increment indefinitely\&.
Packit b099d7
.IP "\fBXmNdialogTitle\fP" 10
Packit b099d7
Specifies the dialog title\&. If this resource is not NULL, and the parent
Packit b099d7
of the BulletinBoard is a subclass of WMShell, BulletinBoard sets the
Packit b099d7
\fBXmNtitle\fP and \fBXmNtitleEncoding\fP of its parent\&.
Packit b099d7
If the only character set in \fBXmNdialogTitle\fP is ISO8859-1,
Packit b099d7
\fBXmNtitle\fP is set to the string of the title, and
Packit b099d7
\fBXmNtitleEncoding\fP is set to \fBSTRING\fP\&.
Packit b099d7
If \fBXmNdialogTitle\fP contains character sets other than ISO8859-1,
Packit b099d7
\fBXmNtitle\fP is set to the string of the title converted to a compound
Packit b099d7
text string, and \fBXmNtitleEncoding\fP is set to \fBCOMPOUND_TEXT\fP\&.
Packit b099d7
The direction of the title is based on the \fBXmNlayoutDirection\fP resource
Packit b099d7
of the widget\&.
Packit b099d7
.IP "\fBXmNfocusCallback\fP" 10
Packit b099d7
Specifies the list of callbacks that is called
Packit b099d7
when the BulletinBoard widget or one of its
Packit b099d7
descendants accepts the input focus\&.
Packit b099d7
The callback reason is \fBXmCR_FOCUS\fP\&.
Packit b099d7
.IP "\fBXmNlabelFontList\fP" 10
Packit b099d7
Specifies the font list used for label descendants\&. See the
Packit b099d7
\fBXmNlabelRenderTable\fP resource\&.
Packit b099d7
.IP "\fBXmNlabelRenderTable\fP" 10
Packit b099d7
Specifies the render table used for BulletinBoard\&'s label descendants\&.
Packit b099d7
If this value is NULL at initialization, the parent hierarchy of the widget
Packit b099d7
is searched for an ancestor that
Packit b099d7
holds the \fBXmQTspecifyRenderTable\fP trait\&.
Packit b099d7
If such an ancestor is found, the render table is initialized to the
Packit b099d7
\fBXmLABEL_RENDER_TABLE\fP value of the ancestor widget\&. If no such
Packit b099d7
ancestor is
Packit b099d7
found, the default is implementation dependent\&. Refer to
Packit b099d7
\fBXmRenderTable\fP(3) for more information on the creation and structure
Packit b099d7
of a render table\&.
Packit b099d7
.IP "\fBXmNmapCallback\fP" 10
Packit b099d7
Specifies the list of callbacks that is called
Packit b099d7
only when the parent of the BulletinBoard is a DialogShell\&. In this case,
Packit b099d7
this callback list is invoked when the BulletinBoard widget is mapped\&.
Packit b099d7
The callback reason is \fBXmCR_MAP\fP\&.
Packit b099d7
DialogShells are usually mapped when the DialogShell is managed\&.
Packit b099d7
.IP "\fBXmNmarginHeight\fP" 10
Packit b099d7
Specifies the minimum spacing in pixels between the top or bottom edge
Packit b099d7
of BulletinBoard and any child widget\&.
Packit b099d7
.IP "\fBXmNmarginWidth\fP" 10
Packit b099d7
Specifies the minimum spacing in pixels between the left or right edge
Packit b099d7
of BulletinBoard and any child widget\&.
Packit b099d7
.IP "\fBXmNnoResize\fP" 10
Packit b099d7
Controls whether or not resize controls are included in the window
Packit b099d7
manager frame around the BulletinBoard\&'s parent\&.
Packit b099d7
If this resource is
Packit b099d7
set to True, \fBmwm\fP does not include resize controls in the
Packit b099d7
window manager frame containing the parent of the BulletinBoard if the
Packit b099d7
parent is a subclass of VendorShell\&.
Packit b099d7
If this resource is set to False,
Packit b099d7
the window manager frame does include resize controls\&.
Packit b099d7
Other controls provided by \fBmwm\fP can be included or excluded through
Packit b099d7
the \fBmwm\fP resources provided by VendorShell\&.
Packit b099d7
.IP "\fBXmNresizePolicy\fP" 10
Packit b099d7
Controls the policy for resizing BulletinBoard widgets\&.
Packit b099d7
Possible values include
Packit b099d7
.RS
Packit b099d7
.IP "\fBXmRESIZE_NONE\fP" 10
Packit b099d7
Fixed size
Packit b099d7
.IP "\fBXmRESIZE_ANY\fP" 10
Packit b099d7
Shrink or grow as needed
Packit b099d7
.IP "\fBXmRESIZE_GROW\fP" 10
Packit b099d7
Grow only
Packit b099d7
.RE
Packit b099d7
.IP "\fBXmNshadowType\fP" 10
Packit b099d7
Describes the shadow
Packit b099d7
drawing style for BulletinBoard\&. This resource can have the
Packit b099d7
following values:
Packit b099d7
.RS
Packit b099d7
.IP "\fBXmSHADOW_IN\fP" 10
Packit b099d7
Draws the BulletinBoard shadow
Packit b099d7
so that it appears inset\&.
Packit b099d7
This means that the bottom shadow visuals and top shadow visuals
Packit b099d7
are reversed\&.
Packit b099d7
.IP "\fBXmSHADOW_OUT\fP" 10
Packit b099d7
Draws the BulletinBoard shadow
Packit b099d7
so that it appears outset\&.
Packit b099d7
.IP "\fBXmSHADOW_ETCHED_IN\fP" 10
Packit b099d7
Draws the BulletinBoard shadow
Packit b099d7
using a double line giving the
Packit b099d7
effect of a line etched into the window, similar to the Separator widget\&.
Packit b099d7
.IP "\fBXmSHADOW_ETCHED_OUT\fP" 10
Packit b099d7
Draws the BulletinBoard shadow using a double
Packit b099d7
line giving the
Packit b099d7
effect of a line coming out of the window, similar to the Separator widget\&.
Packit b099d7
.RE
Packit b099d7
.IP "\fBXmNtextFontList\fP" 10
Packit b099d7
Specifies the font list used for text descendants\&. See the
Packit b099d7
\fBXmNtextRenderTable\fP resource\&.
Packit b099d7
.IP "\fBXmNtextRenderTable\fP" 10
Packit b099d7
Specifies the render table used for BulletinBoard\&'s text descendants\&.
Packit b099d7
If this value is NULL at initialization, the parent hierarchy of the widget
Packit b099d7
is searched for an ancestor that
Packit b099d7
holds the \fBXmQTspecifyRenderTable\fP trait\&.
Packit b099d7
If such an ancestor is found, the render table is initialized to the
Packit b099d7
\fBXmTEXT_RENDER_TABLE\fP value of the ancestor widget\&. If no such
Packit b099d7
ancestor is
Packit b099d7
found, the default is implementation dependent\&. Refer to
Packit b099d7
\fBXmRenderTable\fP(3) for more information on the creation and structure
Packit b099d7
of a render table\&.
Packit b099d7
.IP "\fBXmNtextTranslations\fP" 10
Packit b099d7
It adds translations to any Text widget or Text widget subclass that
Packit b099d7
is added as a child of BulletinBoard\&.
Packit b099d7
.IP "\fBXmNunmapCallback\fP" 10
Packit b099d7
Specifies the list of callbacks that is called only when the parent of
Packit b099d7
the BulletinBoard is a DialogShell\&.
Packit b099d7
In this case, this callback list is invoked when the BulletinBoard
Packit b099d7
widget is unmapped\&.
Packit b099d7
The callback reason is \fBXmCR_UNMAP\fP\&.
Packit b099d7
DialogShells are usually unmapped when the DialogShell is unmanaged\&.
Packit b099d7
.SS "Inherited Resources"
Packit b099d7
.PP
Packit b099d7
BulletinBoard inherits behavior and resources from the
Packit b099d7
superclasses described in the following tables\&.
Packit b099d7
For a complete description of each resource, refer to the
Packit b099d7
reference page for that superclass\&.
Packit b099d7
.PP
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBXmManager Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbottomShadowColor?XmCBottomShadowColor?Pixel?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbottomShadowPixmap?XmCBottomShadowPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNforeground?XmCForeground?Pixel?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNhelpCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNhighlightColor?XmCHighlightColor?Pixel?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNhighlightPixmap?XmCHighlightPixmap?Pixmap?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinitialFocus?XmCInitialFocus?Widget?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNlayoutDirection?XmCLayoutDirection?XmDirection?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNnavigationType?XmCNavigationType?XmNavigationType?XmTAB_GROUP?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNpopupHandlerCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNshadowThickness?XmCShadowThickness?Dimension?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNstringDirection?XmCStringDirection?XmStringDirection?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtopShadowColor?XmCTopShadowColor?Pixel?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtopShadowPixmap?XmCTopShadowPixmap?Pixmap?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtraversalOn?XmCTraversalOn?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNunitType?XmCUnitType?unsigned char?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNuserData?XmCUserData?XtPointer?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.PP
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBComposite Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNchildren?XmCReadOnly?WidgetList?NULL?G
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinsertPosition?XmCInsertPosition?XtOrderProc?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNnumChildren?XmCReadOnly?Cardinal?0?G
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.PP
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBCore Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNaccelerators?XmCAccelerators?XtAccelerators?dynamic?N/A
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNancestorSensitive?XmCSensitive?Boolean?dynamic?G
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbackground?XmCBackground?Pixel?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbackgroundPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNborderColor?XmCBorderColor?Pixel?XtDefaultForeground?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNborderPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNborderWidth?XmCBorderWidth?Dimension?0?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNcolormap?XmCColormap?Colormap?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdepth?XmCDepth?int?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdestroyCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNheight?XmCHeight?Dimension?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinitialResourcesPersistent?XmCInitialResourcesPersistent?Boolean?True?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmappedWhenManaged?XmCMappedWhenManaged?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNscreen?XmCScreen?Screen *?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNsensitive?XmCSensitive?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtranslations?XmCTranslations?XtTranslations?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNwidth?XmCWidth?Dimension?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNx?XmCPosition?Position?0?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNy?XmCPosition?Position?0?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.SS "Callback Information"
Packit b099d7
.PP
Packit b099d7
A pointer to the following structure is passed to each callback:
Packit b099d7
.PP
Packit b099d7
.nf
Packit b099d7
typedef struct
Packit b099d7
{
Packit b099d7
        int \fIreason\fP;
Packit b099d7
        XEvent \fI* event\fP;
Packit b099d7
} XmAnyCallbackStruct;
Packit b099d7
.fi
Packit b099d7
.IP "\fIreason\fP" 10
Packit b099d7
Indicates why the callback was invoked
Packit b099d7
.IP "\fIevent\fP" 10
Packit b099d7
Points to the \fBXEvent\fP that triggered the callback
Packit b099d7
.SS "Translations"
Packit b099d7
.PP
Packit b099d7
\fBXmBulletinBoard\fP includes the translations from \fBXmManager\fP\&.
Packit b099d7
.SS "Additional Behavior"
Packit b099d7
.PP
Packit b099d7
The \fBXmBulletinBoard\fP widget has the following additional behavior:
Packit b099d7
.IP "\fB<Key>\fP\fB<osfCancel>\fP:" 10
Packit b099d7
Calls the activate callbacks for the cancel button if it is sensitive\&.
Packit b099d7
If no cancel button exists and if the parent of the BulletinBoard is
Packit b099d7
a manager, passes the event to the parent\&.
Packit b099d7
.IP "\fB<Key>\fP\fB<osfActivate>\fP:" 10
Packit b099d7
Calls the activate callbacks for the button with the keyboard focus\&.
Packit b099d7
If no button has the keyboard focus, calls the activate callbacks
Packit b099d7
for the default button if it is sensitive\&.
Packit b099d7
In a List widget or single-line Text widget,
Packit b099d7
the List or Text action associated with \fB<Key>\fP\fB<osfActivate>\fP
Packit b099d7
is called before the BulletinBoard actions associated with
Packit b099d7
\fB<Key>\fP\fB<osfActivate>\fP\&.
Packit b099d7
.IP "" 10
Packit b099d7
In a multiline Text widget, any \fB<Key>\fP\fB<osfActivate>\fP
Packit b099d7
event except \fB<Key>\fP\fB<Enter>\fP calls
Packit b099d7
the Text action associated with \fB<Key>\fP\fB<osfActivate>\fP,
Packit b099d7
then the BulletinBoard actions associated with \fB<Key>\fP\fB<osfActivate>\fP\&.
Packit b099d7
If no button has the focus, no default button exists, and the parent of the
Packit b099d7
BulletinBoard is a manager, passes the event to the parent\&.
Packit b099d7
.IP "\fB<FocusIn>\fP:" 10
Packit b099d7
Calls the callbacks for \fBXmNfocusCallback\fP\&.
Packit b099d7
When the focus policy is \fBXmPOINTER\fP, the callbacks are
Packit b099d7
called when the pointer
Packit b099d7
enters the window\&.
Packit b099d7
When the focus policy is \fBXmEXPLICIT\fP, the callbacks are called
Packit b099d7
when the user traverses to the widget\&.
Packit b099d7
.IP "\fB<Map>\fP:" 10
Packit b099d7
Calls the callbacks for \fBXmNmapCallback\fP\&.
Packit b099d7
.IP "\fB<Unmap>\fP:" 10
Packit b099d7
Calls the callbacks for \fBXmNunmapCallback\fP\&.
Packit b099d7
.SS "Virtual Bindings"
Packit b099d7
.PP
Packit b099d7
The bindings for virtual keys are vendor specific\&.
Packit b099d7
For information about bindings for virtual buttons and keys, see \fBVirtualBindings\fP(3)\&.
Packit b099d7
.SH "RELATED"
Packit b099d7
.PP
Packit b099d7
\fBComposite\fP(3),
Packit b099d7
\fBConstraint\fP(3),
Packit b099d7
\fBCore\fP(3),
Packit b099d7
\fBXmCreateBulletinBoard\fP(3),
Packit b099d7
\fBXmCreateBulletinBoardDialog\fP(3),
Packit b099d7
\fBXmDialogShell\fP(3), 
Packit b099d7
\fBXmManager\fP(3),
Packit b099d7
\fBXmVaCreateBulletinBoard\fP(3), and
Packit b099d7
\fBXmVaCreateManagedBulletinBoard\fP(3)\&.