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)