NAME

RubberTile − a composite widget allowing sophisticated management of other widgets in its boundaries

SYNOPSIS

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

my_rubbertile =  XtCreate( my_name, rubberTileWidgetClass,

my_parent, args, num_args);

DESCRIPTION

The RubberTile differs from other composite widgets in that, when it is resized, it resizes its children according to a weight assigned to each child.  If there are three children with weights of 1, 2, and 3, they resize to get 1/6th, 1/3rd, and 1/2 of the available space respectively. 

RubberTiles do not enforce any weighting on their children whin the widget is created, only when resized.  Also note that an individual RubberTile only supports a single dimensional array, vertical or horizontal.  However, an application can produce a two dimensional effect with a matrix of RubberTile widgets.  For example, to create the effect of a 2 × 4 matrix, you could have two top level RubberTiles managing four RubberTiles each. 

RESOURCES

  Table 1 RubberTile Resource Set

RubberTile     Resource Set
Name           Type     Default  Access
 
XtNorientation OlDefine vertical SGI

Access:S = XtSetValues G = XtGetValues
        I = init timeO = other access
† see resources(3w)

Child Constraints

Each child widget attached to the RubberTile composite widget is constrained by the resources detailed in the following table.  In essence, these resources become resources for each child widget and can be set and read just like any other resources defined for the child. 

  Table 2 RubberTile Child Constraining Resources

RubberTile   Constraint Resource Set
Name         Type       Default  Access
 
XtNrefName   String     NULL     SGI
XtNrefWidget XtPointer  NULL     SGI
XtNspace     Dimension  0        SGI
XtNweight    Dimension  1        SGI

Access:S = XtSetValues G = XtGetValues
        I = init timeO = other access

XtNorientation

 class:XtNorientation type:XtCOrientation default:OlDefineaccess:SGI
 class:XtNorientationtype:XtCOrientationdefault:OlDefineaccess:SGI

XtNrefName

 class:XtNrefName type:XtCRefName default:Stringaccess:SGI

XtNrefWidget

 class:XtNrefWidget type:XtCRefWidget default:XtPointeraccess:SGI

XtNspace

 class:XtNspace type:XtSCpace default:0access:SGI

XtNweight

 class:XtNweight type:XtCWeight default:1access:SGI

Version 3.0  —  19 July 91