FooterPanel(3W) UNIX System V FooterPanel(3W)
NAME
FooterPanel - provides a convenient way to put a footer at the bottom of
a window
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.
10/89 Page 1
FooterPanel(3W) UNIX System V FooterPanel(3W)
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
_______________________________________________________________________________________
| FooterPanel Resource Set |
|_____________________|______________________|_________________|______________|________|
| Name | Class | Type | Default | Access|
|_____________________|______________________|_________________|______________|________|
|_____________________|______________________|_________________|______________|________|
| XtNancestorSensitive| XtCSenstitive | Boolean | TRUE | G* |
|_____________________|______________________|_________________|______________|________|
| XtNconsumeEvent | XtCConsumeEvent | XtCallbackList | NULL | SG |
|_____________________|______________________|_________________|______________|________|
| XtNdepth | XtCDepth | int | (parent's) | GI |
|_____________________|______________________|_________________|______________|________|
| XtNdestroyCallback | XtCCallback | XtCallbackList | NULL | SI |
|_____________________|______________________|_________________|______________|________|
| XtNheight | XtCHeight | Dimension | (calculated)| SGI |
|_____________________|______________________|_________________|______________|________|
| XtNmappedWhenManaged| XtCMappedWhenManaged| Boolean | TRUE | SGI |
|_____________________|______________________|_________________|______________|________|
| XtNsensitive | XtCSensitive | Boolean | TRUE | GI* |
|_____________________|______________________|_________________|______________|________|
| XtNuserData | XtCUserData | XtPointer | NULL | SGI |
|_____________________|______________________|_________________|______________|________|
| XtNwidth | XtCWidth | Dimension | (calculated)| SGI |
|_____________________|______________________|_________________|______________|________|
| XtNx | XtCPosition | Position | 0 | SGI |
|_____________________|______________________|_________________|______________|________|
| XtNy | XtCPosition | Position | 0 | SGI |
|_____________________|______________________|_________________|______________|________|
See Section 2, "General Resources," for a description of the other
FooterPanel resources.
Page 2 10/89