NAME

FooterPanel − footer panel widget

SYNOPSIS

#include <X11/Intrinsic.h>
#include <X11/StringDefs.h>
#include <Xol/OpenLook.h>
#include <Xol/FooterPane.h>
 . . .
Widget my_footerpanel, my_parent;
String my_name;
ArgList args;
Cardinal num_args;

my_footerpanel =  XtCreate( my_name, footerPanelWidgetClass,

my_parent, args, num_args);

DESCRIPTION

FooterPanel

Interface

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 topcChild 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 topcChild 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. 

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

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 timeO = 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  —  19 July 91