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.

Amiga Unix                Last change:                          1

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\*(cO_____________________________
      Name                   Class                  Type             Default        Access
     ______________________________________________________________________________________

Amiga Unix                Last change:                          2
()                MISC. REFERENCE MANUAL PAGES                 ()

     ______________________________________________________________________________________
     _XtNancestorSensitive___XtCSenstitive__________Boolean__________TRUE___________G*_____
      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*
     ______________________________________________________________________________________
    |_XtNtraversalManager____XtCTraversalManager____Boolean__________FALSE__________SGI___|
    | XtNuserData         |  XtCUserData         |  XtPointer     |  NULL        |  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNwidth____________|__XtCWidth____________|__Dimension_____|__(calculated)|__SGI___|
    | XtNx                |  XtCPosition         |  Position      |  0           |  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNy________________|__XtCPosition_________|__Position______|__0___________|__SGI___|

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

Amiga Unix                Last change:                          1