|
Packit |
b099d7 |
'\" t
|
|
Packit |
b099d7 |
...\" Manager.sgm /main/12 1996/09/08 20:53:42 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 "XmManager" "library call"
|
|
Packit |
b099d7 |
.SH "NAME"
|
|
Packit |
b099d7 |
\fBXmManager\fP \(em The Manager widget class
|
|
Packit |
b099d7 |
.iX "XmManager"
|
|
Packit |
b099d7 |
.iX "widget class" "Manager"
|
|
Packit |
b099d7 |
.SH "SYNOPSIS"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Xm/Xm\&.h>
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.SH "DESCRIPTION"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Manager is a widget class used as a supporting superclass for other
|
|
Packit |
b099d7 |
widget classes\&. It supports the
|
|
Packit |
b099d7 |
visual resources, graphics contexts, and traversal resources necessary for the
|
|
Packit |
b099d7 |
graphics and traversal mechanisms\&.
|
|
Packit |
b099d7 |
.SS "Classes"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Manager inherits behavior and resources from \fBCore\fP,
|
|
Packit |
b099d7 |
\fBComposite\fP, and \fBConstraint\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class pointer is \fBxmManagerWidgetClass\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class name is \fBXmManager\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 |
\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?NULL?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?0?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 |
.IP "\fBXmNbottomShadowColor\fP" 10
|
|
Packit |
b099d7 |
Specifies the color to use to draw the bottom
|
|
Packit |
b099d7 |
and right sides of the border shadow\&.
|
|
Packit |
b099d7 |
This color is used if the \fBXmNbottomShadowPixmap\fP resource is NULL\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNbottomShadowPixmap\fP" 10
|
|
Packit |
b099d7 |
Specifies the pixmap to use to draw the bottom and right sides of the border
|
|
Packit |
b099d7 |
shadow\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNforeground\fP" 10
|
|
Packit |
b099d7 |
Specifies the foreground drawing color used by manager widgets\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNhelpCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks that are called when the help key
|
|
Packit |
b099d7 |
sequence is pressed\&. The reason sent by this callback is \fBXmCR_HELP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNhighlightColor\fP" 10
|
|
Packit |
b099d7 |
Specifies the color of the highlighting rectangle\&.
|
|
Packit |
b099d7 |
This color is used if the highlight pixmap resource is
|
|
Packit |
b099d7 |
\fBXmUNSPECIFIED_PIXMAP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNhighlightPixmap\fP" 10
|
|
Packit |
b099d7 |
Specifies the pixmap used to draw the highlighting rectangle\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNinitialFocus\fP" 10
|
|
Packit |
b099d7 |
Specifies the ID of a widget descendant of the manager\&.
|
|
Packit |
b099d7 |
The widget must meet these conditions:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
The widget must be either a tab group or a non-tab-group widget that can
|
|
Packit |
b099d7 |
receive keyboard focus\&.
|
|
Packit |
b099d7 |
For the definition of a tab group, see the description of the Manager,
|
|
Packit |
b099d7 |
Primitive, and Gadget \fBXmNnavigationType\fP resources\&.
|
|
Packit |
b099d7 |
In general a widget can receive keyboard focus when it is a primitive, a
|
|
Packit |
b099d7 |
gadget, or a manager (such as a DrawingArea with no traversable
|
|
Packit |
b099d7 |
children) that acts as a primitive\&.
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
The widget must not be a descendant of a tab group that is itself a
|
|
Packit |
b099d7 |
descendant of the manager\&.
|
|
Packit |
b099d7 |
That is, the widget cannot be contained within a tab group that is
|
|
Packit |
b099d7 |
nested inside the manager\&.
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
The widget and its ancestors must have a value of True for their
|
|
Packit |
b099d7 |
\fBXmNtraversalOn\fP resources\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If the widget does not meet these conditions, \fBXmNinitialFocus\fP is
|
|
Packit |
b099d7 |
treated as if the value were NULL\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
This resource is meaningful only when the nearest shell ancestor\&'s
|
|
Packit |
b099d7 |
\fBXmNkeyboardFocusPolicy\fP is \fBXmEXPLICIT\fP\&.
|
|
Packit |
b099d7 |
It is used to determine which widget receives focus in these situations:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
When the manager is the child of a shell and the shell hierarchy
|
|
Packit |
b099d7 |
receives focus for the first time
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
When focus is inside the shell hierarchy, the manager is a composite tab
|
|
Packit |
b099d7 |
group, and the user traverses to the manager via the keyboard
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
Focus is then determined as follows:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
If \fBXmNinitialFocus\fP is a traversable non-tab-group widget, that
|
|
Packit |
b099d7 |
widget receives focus\&.
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
If \fBXmNinitialFocus\fP is a traversable tab group, that tab group
|
|
Packit |
b099d7 |
receives focus\&.
|
|
Packit |
b099d7 |
If that tab group is a composite with descendant tab groups or
|
|
Packit |
b099d7 |
traversable non-tab-group widgets, these procedures are used recursively
|
|
Packit |
b099d7 |
to assign focus to a descendant of that tab group\&.
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
If \fBXmNinitialFocus\fP is NULL, the first traversable non-tab-group
|
|
Packit |
b099d7 |
widget that is not contained within a nested tab group receives focus\&.
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
If \fBXmNinitialFocus\fP is NULL and no traversable non-tab-group widget
|
|
Packit |
b099d7 |
exists, the first traversable tab group that is not contained within a
|
|
Packit |
b099d7 |
nested tab group receives focus\&.
|
|
Packit |
b099d7 |
If that tab group is a composite with descendant tab groups or
|
|
Packit |
b099d7 |
traversable non-tab-group widgets, these procedures are used recursively
|
|
Packit |
b099d7 |
to assign focus to a descendant of that tab group\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If a shell hierarchy regains focus after losing it, focus returns to the
|
|
Packit |
b099d7 |
widget that had the focus at the time it left the hierarchy\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
The use of \fBXmNinitialFocus\fP is undefined if the manager is a
|
|
Packit |
b099d7 |
MenuBar, PulldownMenu, PopupMenu, or OptionMenu\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNlayoutDirection\fP" 10
|
|
Packit |
b099d7 |
Specifies the direction in which components of the manager (including
|
|
Packit |
b099d7 |
strings) are laid out\&. The values are of type \fBXmDirection\fR\&. If
|
|
Packit |
b099d7 |
the widget\&'s parent is a manager or shell, the value is inherited from
|
|
Packit |
b099d7 |
the widget\&'s parent\&. Otherwise, it is inherited from the closest
|
|
Packit |
b099d7 |
ancestor vendor or menu shell\&. Refer to the \fBXmDirection\fP(3)
|
|
Packit |
b099d7 |
reference page for the possible direction values\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNnavigationType\fP" 10
|
|
Packit |
b099d7 |
Determines whether the widget is a tab group\&.
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmNONE\fP" 10
|
|
Packit |
b099d7 |
Indicates that the widget is not a tab group\&.
|
|
Packit |
b099d7 |
.IP "\fBXmTAB_GROUP\fP" 10
|
|
Packit |
b099d7 |
Indicates that the widget is a tab group, unless
|
|
Packit |
b099d7 |
the \fBXmNnavigationType\fP of another widget in the hierarchy is
|
|
Packit |
b099d7 |
\fBXmEXCLUSIVE_TAB_GROUP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmSTICKY_TAB_GROUP\fP" 10
|
|
Packit |
b099d7 |
Indicates that the widget is a tab group, even if
|
|
Packit |
b099d7 |
the \fBXmNnavigationType\fP of another widget in the hierarchy is
|
|
Packit |
b099d7 |
\fBXmEXCLUSIVE_TAB_GROUP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmEXCLUSIVE_TAB_GROUP\fP" 10
|
|
Packit |
b099d7 |
Indicates that the widget is a tab group and
|
|
Packit |
b099d7 |
that widgets in the hierarchy whose \fBXmNnavigationType\fP is
|
|
Packit |
b099d7 |
\fBXmTAB_GROUP\fP are not tab groups\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
When a parent widget has an \fBXmNnavigationType\fP of
|
|
Packit |
b099d7 |
\fBXmEXCLUSIVE_TAB_GROUP\fP, traversal of non-tab-group widgets within
|
|
Packit |
b099d7 |
the group is based on the order of those widgets in their parent\&'s
|
|
Packit |
b099d7 |
\fBXmNchildren\fP list\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
When the \fBXmNnavigationType\fP of any widget in a hierarchy is
|
|
Packit |
b099d7 |
\fBXmEXCLUSIVE_TAB_GROUP\fP, traversal of tab groups in the hierarchy
|
|
Packit |
b099d7 |
proceeds to widgets in the order in which their \fBXmNnavigationType\fP
|
|
Packit |
b099d7 |
resources were specified as \fBXmEXCLUSIVE_TAB_GROUP\fP or
|
|
Packit |
b099d7 |
\fBXmSTICKY_TAB_GROUP\fP, whether by creating the widgets with that value,
|
|
Packit |
b099d7 |
by calling \fBXtSetValues\fP, or by calling \fBXmAddTabGroup\fP\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNpopupHandlerCallback\fP" 10
|
|
Packit |
b099d7 |
Allows the application to control which popup menu will be
|
|
Packit |
b099d7 |
automatically posted\&. The reason can either be \fBXmCR_POST\fP or
|
|
Packit |
b099d7 |
\fBXmCR_REPOST:\fP
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmCR_POST\fP" 10
|
|
Packit |
b099d7 |
Indicates that this is a regular posting request\&.
|
|
Packit |
b099d7 |
.IP "\fBXmCR_REPOST\fP" 10
|
|
Packit |
b099d7 |
Indicates that the menu was just unposted and that this callback was
|
|
Packit |
b099d7 |
invoked on a replay\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
This callback
|
|
Packit |
b099d7 |
uses the \fBXmPopupHandlerCallbackStruct\fR
|
|
Packit |
b099d7 |
structure to pass information\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNshadowThickness\fP" 10
|
|
Packit |
b099d7 |
Specifies the thickness of the drawn border shadow\&.
|
|
Packit |
b099d7 |
\fBXmBulletinBoard\fP and its descendants set this value dynamically\&.
|
|
Packit |
b099d7 |
If the widget is a top-level window, this value is set to 1\&.
|
|
Packit |
b099d7 |
If it is not a top-level window, this value is set to 0 (zero)\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNstringDirection\fP" 10
|
|
Packit |
b099d7 |
Is a synthetic resource for setting \fBXmNlayoutDirection\fP\&.
|
|
Packit |
b099d7 |
The values for this resource are \fBXmSTRING_DIRECTION_L_TO_R\fP and
|
|
Packit |
b099d7 |
\fBXmSTRING_DIRECTION_R_TO_L\fP\&. Refer to the
|
|
Packit |
b099d7 |
\fBXmNlayoutDirection\fP resource description\&. The
|
|
Packit |
b099d7 |
\fBXmNstringDirection\fP resource is obsoleted by
|
|
Packit |
b099d7 |
\fBXmNlayoutDirection\fP, but is kept here for backward compatibility\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNtopShadowColor\fP" 10
|
|
Packit |
b099d7 |
Specifies the color to use to draw the top and
|
|
Packit |
b099d7 |
left sides of the border shadow\&.
|
|
Packit |
b099d7 |
This color is used if the \fBXmNtopShadowPixmap\fP resource is NULL\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNtopShadowPixmap\fP" 10
|
|
Packit |
b099d7 |
Specifies the pixmap to use to draw the top and left sides of
|
|
Packit |
b099d7 |
the border shadow\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNtraversalOn\fP" 10
|
|
Packit |
b099d7 |
Specifies whether traversal is activated for this widget\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNunitType\fP" 10
|
|
Packit |
b099d7 |
Provides the basic support for resolution independence\&.
|
|
Packit |
b099d7 |
It defines the type of units a widget uses with sizing and
|
|
Packit |
b099d7 |
positioning resources\&.
|
|
Packit |
b099d7 |
If the widget\&'s parent is a subclass of \fBXmManager\fP and if the
|
|
Packit |
b099d7 |
\fBXmNunitType\fP resource is not explicitly set, it defaults to the
|
|
Packit |
b099d7 |
unit type of the parent widget\&.
|
|
Packit |
b099d7 |
If the widget\&'s parent is not a subclass of \fBXmManager\fP, the
|
|
Packit |
b099d7 |
resource has a default unit type of \fBXmPIXELS\fP\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
The unit type can also be specified in resource files, with the
|
|
Packit |
b099d7 |
following format:
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
\f(CW\fI<floating value><unit>\fP\fR
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
where:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fIunit\fP" 10
|
|
Packit |
b099d7 |
is <" ", pixels, inches, centimeters, millimeters, points, font units>
|
|
Packit |
b099d7 |
.IP "\fIpixels\fP" 10
|
|
Packit |
b099d7 |
is <\fIpix\fP, \fIpixel\fP, \fIpixels\fP>
|
|
Packit |
b099d7 |
.IP "\fIinches\fP" 10
|
|
Packit |
b099d7 |
is <\fIin\fP, \fIinch\fP, \fIinches\fP>
|
|
Packit |
b099d7 |
.IP "\fIcentimeter\fP" 10
|
|
Packit |
b099d7 |
is <\fIcm\fP, \fIcentimeter\fP, \fIcentimeters\fP>
|
|
Packit |
b099d7 |
.IP "\fImillimeters\fP" 10
|
|
Packit |
b099d7 |
is <\fImm\fP, \fImillimeter\fP, \fImillimeters\fP>
|
|
Packit |
b099d7 |
.IP "\fBpoints\fP" 10
|
|
Packit |
b099d7 |
is <\fIpt\fP, \fIpoint\fP, \fIpoints\fP>
|
|
Packit |
b099d7 |
.IP "\fBfont units\fP" 10
|
|
Packit |
b099d7 |
is <\fIfu\fP, \fBfont_unit\fP, \fBfont_units\fP>
|
|
Packit |
b099d7 |
.IP "\fIfloat\fP" 10
|
|
Packit |
b099d7 |
is {"+"|"-"}{{<"0"-"9">*}\&.}<"0"-"9">*
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
Note that the type Dimension must always be positive\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
For example,
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
\f(CWxmfonts*XmMainWindow\&.height: 10\&.4cm
|
|
Packit |
b099d7 |
*PostIn\&.width: 3inches\fR
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
\fBXmNunitType\fP can have the following values:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmPIXELS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as normal
|
|
Packit |
b099d7 |
pixel values\&.
|
|
Packit |
b099d7 |
.IP "\fBXmMILLIMETERS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as normal millimeter
|
|
Packit |
b099d7 |
values\&.
|
|
Packit |
b099d7 |
.IP "\fBXm100TH_MILLIMETERS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated
|
|
Packit |
b099d7 |
as 1/100 of a millimeter\&.
|
|
Packit |
b099d7 |
.IP "\fBXmCENTIMETERS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as normal centimeter
|
|
Packit |
b099d7 |
values\&.
|
|
Packit |
b099d7 |
.IP "\fBXmINCHES\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as normal inch
|
|
Packit |
b099d7 |
values\&.
|
|
Packit |
b099d7 |
.IP "\fBXm1000TH_INCHES\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as
|
|
Packit |
b099d7 |
1/1000 of an inch\&.
|
|
Packit |
b099d7 |
.IP "\fBXmPOINTS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as normal point
|
|
Packit |
b099d7 |
values\&. A point is a unit used in text processing
|
|
Packit |
b099d7 |
applications and is defined as 1/72 of an inch\&.
|
|
Packit |
b099d7 |
.IP "\fBXm100TH_POINTS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as
|
|
Packit |
b099d7 |
1/100 of a point\&. A point is a unit used in text processing
|
|
Packit |
b099d7 |
applications and is defined as 1/72 of an inch\&.
|
|
Packit |
b099d7 |
.IP "\fBXmFONT_UNITS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are treated as normal font
|
|
Packit |
b099d7 |
units\&. A font unit has horizontal and vertical components\&.
|
|
Packit |
b099d7 |
These are the values of the XmScreen resources \fBXmNhorizontalFontUnit\fP
|
|
Packit |
b099d7 |
and \fBXmNverticalFontUnit\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXm100TH_FONT_UNITS\fP" 10
|
|
Packit |
b099d7 |
All values provided to the widget are
|
|
Packit |
b099d7 |
treated as 1/100 of a font unit\&.
|
|
Packit |
b099d7 |
A font unit has horizontal and vertical components\&.
|
|
Packit |
b099d7 |
These are the values of the XmScreen resources \fBXmNhorizontalFontUnit\fP
|
|
Packit |
b099d7 |
and \fBXmNverticalFontUnit\fP\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNuserData\fP" 10
|
|
Packit |
b099d7 |
Allows the application to attach
|
|
Packit |
b099d7 |
any necessary specific data to the widget\&. This is an internally
|
|
Packit |
b099d7 |
unused resource\&.
|
|
Packit |
b099d7 |
.SS "Dynamic Color Defaults"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The foreground, background, top shadow, bottom shadow, and
|
|
Packit |
b099d7 |
highlight color resources are dynamically defaulted\&.
|
|
Packit |
b099d7 |
If no color data is specified, the colors are
|
|
Packit |
b099d7 |
automatically generated\&. On a single-plane system, a black and white color
|
|
Packit |
b099d7 |
scheme is generated\&. Otherwise, four colors are
|
|
Packit |
b099d7 |
generated, which display the correct shading for the 3-D visuals\&.
|
|
Packit |
b099d7 |
If the background is the only color specified for a widget, the top
|
|
Packit |
b099d7 |
shadow and bottom shadow colors are generated to give the 3-D appearance\&.
|
|
Packit |
b099d7 |
Foreground and highlight colors are generated to provide sufficient
|
|
Packit |
b099d7 |
contrast with the background color\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Colors are generated only at creation\&. Resetting the background through
|
|
Packit |
b099d7 |
\fBXtSetValues\fP does not regenerate the other colors\&.
|
|
Packit |
b099d7 |
\fBXmChangeColor\fP can be used to recalculate all associated colors
|
|
Packit |
b099d7 |
based on a new background color\&.
|
|
Packit |
b099d7 |
.SS "Inherited Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Manager inherits 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 |
\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?CSG
|
|
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 for
|
|
Packit |
b099d7 |
\fBXmNhelpCallback\fP:
|
|
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 |
For this callback, \fIreason\fP is set to \fBXmCR_HELP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fIevent\fP" 10
|
|
Packit |
b099d7 |
Points to the \fBXEvent\fP that triggered the callback\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
A pointer to the following structure is passed to each callback for
|
|
Packit |
b099d7 |
\fBXmNpopupHandlerCallback\fP:
|
|
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 |
Widget \fImenuToPost\fP;
|
|
Packit |
b099d7 |
Boolean \fIpostIt\fP;
|
|
Packit |
b099d7 |
Widget \fItarget\fP;
|
|
Packit |
b099d7 |
} XmPopupHandlerCallbackStruct;
|
|
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 handler\&.
|
|
Packit |
b099d7 |
.IP "\fImenuToPost\fP" 10
|
|
Packit |
b099d7 |
Specifies the popup menu that the menu system believes should be
|
|
Packit |
b099d7 |
posted\&. The application may modify this field\&.
|
|
Packit |
b099d7 |
.IP "\fIpostIt\fP" 10
|
|
Packit |
b099d7 |
Indicates whether the posting process should continue\&. The
|
|
Packit |
b099d7 |
application may modify this field\&.
|
|
Packit |
b099d7 |
.IP "\fItarget\fP" 10
|
|
Packit |
b099d7 |
Specifies the most specific widget or gadget that the menu sytem found
|
|
Packit |
b099d7 |
from the event that matches the event\&.
|
|
Packit |
b099d7 |
.SS "Translations"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following set of translations are used by Manager widgets that
|
|
Packit |
b099d7 |
have Gadget children\&. Because Gadgets cannot have translations associated
|
|
Packit |
b099d7 |
with them, it is the responsibility of the Manager widget to intercept the
|
|
Packit |
b099d7 |
events of interest and pass them to any Gadget child with focus\&.
|
|
Packit |
b099d7 |
These events are ignored if no Gadget child has the focus\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following key names are listed in the
|
|
Packit |
b099d7 |
X standard key event translation table syntax\&.
|
|
Packit |
b099d7 |
This format is the one used by Motif to
|
|
Packit |
b099d7 |
specify the widget actions corresponding to a given key\&.
|
|
Packit |
b099d7 |
A brief overview of the format is provided under
|
|
Packit |
b099d7 |
\fBVirtualBindings\fP(3)\&.
|
|
Packit |
b099d7 |
For a complete description of the format, please refer to the
|
|
Packit |
b099d7 |
X Toolkit Instrinsics Documentation\&.
|
|
Packit |
b099d7 |
.IP "\fB<BtnMotion>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetButtonMotion()
|
|
Packit |
b099d7 |
.IP "\fBc<Btn1Down>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetTraverseCurrent()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Down>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetArm()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Down>\fP\fB,\(apc\fP\fB<Btn1Up>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetActivate()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Up>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetActivate()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Down>\fP\fB(2+)\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetMultiArm()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Up>\fP\fB(2+)\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetMultiActivate()
|
|
Packit |
b099d7 |
.IP "\fB<Btn2Down>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetDrag()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfActivate>\fP:" 10
|
|
Packit |
b099d7 |
ManagerParentActivate()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfCancel>\fP:" 10
|
|
Packit |
b099d7 |
ManagerParentCancel()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfSelect>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetSelect()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfHelp>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetHelp()
|
|
Packit |
b099d7 |
.IP "\fB\(aps \(apm \(apa\fP \fB<Key>\fP\fBReturn\fP:" 10
|
|
Packit |
b099d7 |
ManagerParentActivate()
|
|
Packit |
b099d7 |
.IP "\fB\(aps \(apm \(apa\fP \fB<Key>\fP\fBspace\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetSelect()
|
|
Packit |
b099d7 |
.IP "\fB<Key>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetKeyInput()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfBeginLine>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetTraverseHome()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfUp>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetTraverseUp()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfDown>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetTraverseDown()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfLeft>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetTraverseLeft()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfRight>\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetTraverseRight()
|
|
Packit |
b099d7 |
.IP "\fBs \(apm \(apa\fP \fB<Key>\fP\fBTab\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetPrevTabGroup()
|
|
Packit |
b099d7 |
.IP "\fB\(apm \(apa\fP \fB<Key>\fP\fBTab\fP:" 10
|
|
Packit |
b099d7 |
ManagerGadgetNextTabGroup()
|
|
Packit |
b099d7 |
.SS "Action Routines"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The \fBXmManager\fP action routines are
|
|
Packit |
b099d7 |
.IP "GadgetTakeFocus():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to take keyboard focus when
|
|
Packit |
b099d7 |
\fBCtrl<Btn1Down>\fP is pressed\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetActivate():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to be activated\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetArm():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to be armed\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetButtonMotion():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to process a mouse motion event\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetDrag():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to begin a drag operation\&.
|
|
Packit |
b099d7 |
This action is undefined for gadgets used in a menu system\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetHelp():" 10
|
|
Packit |
b099d7 |
Calls the callbacks for the current gadget\&'s \fBXmNhelpCallback\fP if
|
|
Packit |
b099d7 |
any exist\&.
|
|
Packit |
b099d7 |
If there are no help
|
|
Packit |
b099d7 |
callbacks for this widget, this action calls the help callbacks
|
|
Packit |
b099d7 |
for the nearest ancestor that has them\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetKeyInput():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to process a keyboard event\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetMultiActivate():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to process a multiple mouse click\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetMultiArm():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to process a multiple mouse button press\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetNextTabGroup():" 10
|
|
Packit |
b099d7 |
This action depends on the value of the Display resource
|
|
Packit |
b099d7 |
\fBXmNenableButtonTab\fP\&. When \fBXmNenableButtonTab\fP is False
|
|
Packit |
b099d7 |
(default), this action traverses to the first item in the next tab
|
|
Packit |
b099d7 |
group\&. If the current tab group is the last entry in the tab group
|
|
Packit |
b099d7 |
list, it wraps to the beginning of the tab group list\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
When \fBXmNenableButtonTab\fP is True, this action moves to the next
|
|
Packit |
b099d7 |
item within the current tab group, unless it is the last item in the
|
|
Packit |
b099d7 |
tab group\&. When the item is the last in the group, the action
|
|
Packit |
b099d7 |
traverses to the first item in the next tab group\&. The
|
|
Packit |
b099d7 |
\fBXmNenableButtonTab\fP behavior applies only to PushButton, ArrowButton,
|
|
Packit |
b099d7 |
and DrawnArrow\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetPrevTabGroup():" 10
|
|
Packit |
b099d7 |
This action depends on the value of the Display resource
|
|
Packit |
b099d7 |
\fBXmNenableButtonTab\fP\&. When \fBXmNenableButtonTab\fP is False
|
|
Packit |
b099d7 |
(default), this action traverses to the first item in the previous tab
|
|
Packit |
b099d7 |
group\&. If the beginning of the tab group list is reached, it wraps to
|
|
Packit |
b099d7 |
the end of the tab group list\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
When \fBXmNenableButtonTab\fP is True, this action moves to the
|
|
Packit |
b099d7 |
previous item within the current tab group unless it is the first item
|
|
Packit |
b099d7 |
in the tab group\&. When the item is the first in the group, the action
|
|
Packit |
b099d7 |
traverses to the first item in the previous tab group\&. The
|
|
Packit |
b099d7 |
\fBXmNenableButtonTab\fP behavior applies only PushButton, ArrowButton, and
|
|
Packit |
b099d7 |
DrawnButton\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetSelect():" 10
|
|
Packit |
b099d7 |
Causes the current gadget to be armed and activated\&.
|
|
Packit |
b099d7 |
.IP "\fBManagerGadgetTraverseCurrent\fP" 10
|
|
Packit |
b099d7 |
Causes the current gadget to take keyboard focus
|
|
Packit |
b099d7 |
when \fBCtrl<Btn1Down>\fP is pressed\&. Gadget is not activated\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetTraverseDown():" 10
|
|
Packit |
b099d7 |
Traverses to the next item below the current gadget in the current tab
|
|
Packit |
b099d7 |
group, wrapping if necessary\&.
|
|
Packit |
b099d7 |
The wrapping direction depends on the layout direction of the
|
|
Packit |
b099d7 |
widget tab group\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetTraverseHome():" 10
|
|
Packit |
b099d7 |
Traverses to the first widget or gadget in the current tab group\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetTraverseLeft():" 10
|
|
Packit |
b099d7 |
Traverses to the next item to the left of the current gadget in the
|
|
Packit |
b099d7 |
current tab group, wrapping if necessary\&.
|
|
Packit |
b099d7 |
The wrapping direction depends on the layout direction of the
|
|
Packit |
b099d7 |
widget tab group\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetTraverseNext():" 10
|
|
Packit |
b099d7 |
Traverses to the next item in the current tab group, wrapping if
|
|
Packit |
b099d7 |
necessary\&.
|
|
Packit |
b099d7 |
The wrapping direction depends on the layout direction of the
|
|
Packit |
b099d7 |
widget tab group\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetTraversePrev():" 10
|
|
Packit |
b099d7 |
Traverses to the previous item in the current tab group, wrapping if
|
|
Packit |
b099d7 |
necessary\&.
|
|
Packit |
b099d7 |
The wrapping direction depends on the layout direction of the
|
|
Packit |
b099d7 |
widget tab group\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetTraverseRight()" 10
|
|
Packit |
b099d7 |
Traverses to the next item to the right of the current gadget in the
|
|
Packit |
b099d7 |
current tab, wrapping if necessary\&.
|
|
Packit |
b099d7 |
widget tab group\&.
|
|
Packit |
b099d7 |
The wrapping direction depends on the layout direction of the
|
|
Packit |
b099d7 |
widget tab group\&.
|
|
Packit |
b099d7 |
.IP "ManagerGadgetTraverseUp():" 10
|
|
Packit |
b099d7 |
Traverses to the next item above the current gadget in the current tab
|
|
Packit |
b099d7 |
group, wrapping if necessary\&.
|
|
Packit |
b099d7 |
The wrapping direction depends on the layout direction of the
|
|
Packit |
b099d7 |
widget tab group\&.
|
|
Packit |
b099d7 |
.IP "ManagerParentActivate():" 10
|
|
Packit |
b099d7 |
If the parent is a manager,
|
|
Packit |
b099d7 |
passes the \fB<osfActivate>\fP event received by the current widget/gadget
|
|
Packit |
b099d7 |
to its parent\&.
|
|
Packit |
b099d7 |
.IP "ManagerParentCancel():" 10
|
|
Packit |
b099d7 |
If the parent is a manager,
|
|
Packit |
b099d7 |
passes the \fB<osfCancel>\fP event received by the current widget/gadget
|
|
Packit |
b099d7 |
to its parent\&.
|
|
Packit |
b099d7 |
.SS "Additional Behavior"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
This widget has the additional behavior described below:
|
|
Packit |
b099d7 |
.IP "\fB<FocusIn>\fP:" 10
|
|
Packit |
b099d7 |
If the shell\&'s keyboard focus policy is \fBXmEXPLICIT\fP and the event
|
|
Packit |
b099d7 |
occurs in a gadget, causes the gadget to be highlighted and to take the
|
|
Packit |
b099d7 |
focus\&.
|
|
Packit |
b099d7 |
.IP "\fB<FocusOut>\fP:" 10
|
|
Packit |
b099d7 |
If the shell\&'s keyboard focus policy is \fBXmEXPLICIT\fP and the event
|
|
Packit |
b099d7 |
occurs in a gadget, causes the gadget to be unhighlighted and to lose
|
|
Packit |
b099d7 |
the focus\&.
|
|
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 |
\fBXmDirection\fP(3),
|
|
Packit |
b099d7 |
\fBXmChangeColor\fP(3),
|
|
Packit |
b099d7 |
\fBXmGadget\fP(3), and
|
|
Packit |
b099d7 |
\fBXmScreen\fP(3)\&.
|
|
Packit |
b099d7 |
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:27
|