Provided by: libmotif-dev_2.3.8-3.1build1_amd64 
NAME
XmPanedWindow — The PanedWindow widget class "XmPanedWindow" "widget class" "PanedWindow"
SYNOPSIS
#include <Xm/PanedW.h>
DESCRIPTION
PanedWindow is a composite widget that lays out children in a vertically tiled format. Children appear in
top-to-bottom fashion, with the first child inserted appearing at the top of the PanedWindow and the last
child inserted appearing at the bottom. The PanedWindow grows to match the width of its widest child and
all other children are forced to this width. The height of the PanedWindow is equal to the sum of the
heights of all its children, the spacing between them, and the size of the top and bottom margins.
The user can also adjust the size of the panes. To facilitate this adjustment, a pane control sash is
created for most children. The sash appears as a square box positioned on the bottom of the pane that it
controls. The user can adjust the size of a pane by using the mouse or keyboard.
The PanedWindow is also a constraint widget, which means that it creates and manages a set of constraints
for each child. You can specify a minimum and maximum size for each pane. The PanedWindow does not allow
a pane to be resized below its minimum size or beyond its maximum size. Also, when the minimum size of a
pane is equal to its maximum size, no control sash is presented for that pane or for the lowest pane.
The default XmNinsertPosition procedure for PanedWindow causes all panes to appear first in the
XmNchildren list and all sashes to appear after the panes. For a pane child, it returns the value of
XmNpositionIndex if one has been specified for the child. Otherwise, it returns the number of panes in
the PanedWindow's XmNchildren list. Other than the fact that all sashes appear after all panes, the
insertion order of sashes is unspecified. This procedure also causes nonsash widgets to be inserted
after other nonsash children but before any sashes. The behavior of PanedWindow is undefined if
XmNinsertPosition is set to a procedure other than the default.
All panes and sashes in a PanedWindow must be tab groups. When a pane is inserted as a child of the
PanedWindow, if the pane's XmNnavigationType is not XmEXCLUSIVE_TAB_GROUP, PanedWindow sets it to
XmSTICKY_TAB_GROUP.
Descendants
PanedWindow automatically creates for each paned window the descendants shown in the following table. An
application can use XtName and the child list information to gain access to the named descendant. In
addition, a user or an application can use the named descendant when specifying resource values.
┌──────────────────┬─────────────────────────┬────────────────────────────────────┐
│ Named Descendant │ Class │ Identity │
├──────────────────┼─────────────────────────┼────────────────────────────────────┤
├──────────────────┼─────────────────────────┼────────────────────────────────────┤
├──────────────────┼─────────────────────────┼────────────────────────────────────┤
│ Sash │ subclass of XmPrimitive │ sash │
├──────────────────┼─────────────────────────┼────────────────────────────────────┤
│ Separator │ XmSeparatorGadget │ dividing line between window panes │
├──────────────────┼─────────────────────────┼────────────────────────────────────┤
└──────────────────┴─────────────────────────┴────────────────────────────────────┘
Classes
PanedWindow inherits behavior and resources from the Core, Composite, Constraint, and XmManager classes.
The class pointer is xmPanedWindowWidgetClass.
The class name is XmPanedWindow.
New Resources
The following table defines a set of widget resources used by the programmer to specify data. The
programmer can also set the resource values for the inherited classes to set attributes for this widget.
To reference a resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use
the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove
the Xm prefix and use the remaining letters (in either lowercase or uppercase, but include any
underscores between words). The codes in the access column indicate if the given resource can be set at
creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable
(N/A).
┌───────────────────────────────────────────────────────────────────────────────────┐
--
RELATED
Composite(3), Constraint(3), Core(3), XmCreatePanedWindow(3), XmManager(3), XmVaCreatePanedWindow(3), and
XmVaCreateManagedPanedWindow(3).
XmPanedWindow(3)