Provided by: libmotif-dev_2.3.8-2build1_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)