WIDGET CLASS NAME

FooterPanel

SYNOPSIS

#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
#include <FooterPane.h>

widget = XtCreateWidget(name, footerPanelWidgetClass, ...);

DESCRIPTION

Consistent Interface for Attaching Footer

The FooterPanel widget is a simple composite that provides a consistent interface for attaching a footer message to the bottom of a base window.  The FooterPanel composite accepts two children: a Top Child and a Footer Child.  (These are attached to the top and bottom of the FooterPanel widget, respectively.)  The children are identified in the order they are added: the Top Child is the first child added; the Footer Child is the second.  Initial Size

The initial height of the FooterPanel widget is the sum of the initial heights of its children.  The initial width is the widest of the initial widths of its children.  Sizing

The FooterPanel widget attempts to allow its children to grow or shrink to any size, by asking its parent to allow it to grow to the width of the widest child and the height of the sum of its children’s height.  When it is not allowed to grow to this desired size, or when it is resized smaller by its parent, the FooterPanel imposes the size restriction as follows: It resizes both children to its width, but forces the Top Child to absorb all the height restriction; it does not resize the height of the Footer Child.  Conversely, when it is resized larger by its parent, the FooterPanel widget gives all the height increase to the Top Child and resizes both children to the new width. 

The FooterPanel widget never overlaps its children.  If necessary, it will resize the Top Child to zero height.  If its height becomes too small to accommodate the Footer Child’s height, it clips the Footer Child. 

If queried by its parent about its preferred size, it in turn queries its children.  The width in this query is the same for each child: the width in the parent’s query.  The height in the query of the Footer Child is the child’s existing height, and the height in the query of the Top Child is the height in the parent’s query minus the existing height of the Footer Child.  The FooterPanel widget’s response, then, to its parent’s query is a width equal to the wider preference of its children and a height equal to the sum of their preferred heights. 
Works with All Children

The FooterPanel composite widget works with all the widgets defined in this document, except those that are sub-classed from the Shell widget class.  FooterPanel Coloration

The FooterPanel widget is "invisible" in that it imposes no coloration of its own. 

RESOURCES

  Table 1 FooterPanel Resource Set FooterPanel Resource Set\\∗(cO
                Name            Type       Default  Access XtNancestorSensitive         Boolean          TRUE      G∗
            XtNdepth             int    (parent’s)      GI
  XtNdestroyCallback  XtCallbackList          NULL      SI
           XtNheight       Dimension  (calculated)     SGI XtNmappedWhenManaged         Boolean          TRUE     SGI
        XtNsensitive         Boolean          TRUE     GI∗
 XtNtraversalManager         Boolean         FALSE     SGI
         XtNuserData       XtPointer          NULL     SGI
            XtNwidth       Dimension  (calculated)     SGI
                XtNx        Position             0     SGI
                XtNy        Position             0     SGI XtNtraversalManager

This resource controls whether this widget manages traversal for its descendants. 

Sun Release 4.1  —  Last change: 1/8/90