NAME

FooterPanel − footer panel widget

SYNOPSIS

#include <Xol/OpenLook.h>
#include <Xol/FooterPane.h>
 . . .

ANCESTRY

Core-Composite-Constraint-Manager-FooterPanel

DESCRIPTION

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. 

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. 

Limitations

The FooterPanel widget works with all OLIT widgets except those that are sub-classed from the Shell widget class. 

Coloration

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

RESOURCES

  Table 1 FooterPanel Resource Set

Name                      Type           Default      Access
XtNancestorSensitive-   Boolean          TRUE           GO
XtNdepth-               int              (parent’s)     GI
XtNdestroyCallback-     XtCallbackList   NULL           SI
XtNheight-              Dimension        (calculated)   SGI
XtNmappedWhenManaged-   Boolean          TRUE           SGI
XtNsensitive-           Boolean          TRUE           GIO
XtNtraversalManager     Boolean          FALSE          SGI
XtNuserData-            XtPointer        NULL           SGI
XtNwidth-               Dimension        (calculated)   SGI
XtNx-                   Position         0              SGI
XtNy-                   Position         0              SGI

Access:   S = XtSetValues   G = XtGetValues
            I = init time   O = other access
† see resources(3W)

XtNtraversalManager

class:XtCTraversalManager type:Boolean default:FALSEaccess:SGI

Action: controls whether this widget manages traversal for its descendants. 
 

Version 3.0.1  —  Last change: June 92