|
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)\&.
|