Specifications

Athena Widget Set libXaw 1.0.7
gravity Specifies the side of the widget from which the tree should grow. Valid
values include WestGravity, NorthGravity, EastGravity,and South-
Gravity.Aconverter is registered for this resource that will convert the
following strings: the legalvalues.
height
width The height and width of this widget in pixels.
hSpace
vSpace The amount of space, in pixels, to leave between the children. This
resource specifies the amount of space left between the outermost chil-
dren and the edge of the box.
lineWidth The width of the lines from nodes that do not have a treeGC constraint
resource to their children.
mappedWhenManaged If this resource is True,then the widget’swindowwill automatically be
mapped by the Toolkit when it is realized and managed.
numChildren The number of children in this composite widget.
screen The screen on which this widget is displayed. This is not a settable
resource.
sensitive Whether or not the toolkit should pass user events to this widget. The
widget will not get input events if either ancestorSensitive or sensitive is
False.
translations The ev e nt bindings associated with this widget.
x
yThe location of the upper left outside corner of this widget in its parent.
6.6.2. Constraint Resources
Each child of the Tree widget must specify its superior node in the tree. In addition, it may spec-
ify a GC to use when drawing a line between it and its inferior nodes.
Name Class Type Notes Default Value
treeGC TreeGC GC NULL
treeParent TreeParent Widget NULL
treeGC This specifies the GC to use when drawing lines between this widget and
its inferiors in the tree. If this resource is not specified, the Tree’s fore-
ground and lineWidth will be used.
treeParent This specifies the superior node in the tree for this widget. The default is
for the node to have nosuperior (and to therefore be at the top of the
tree).
6.6.3. Layout Semantics
Each time a child is managed or unmanaged, the Tree widget will attempt to reposition the
remaining children to fix the shape of the tree if the autoReconfigure resource is set. Children at
the top (most superior) of the tree are drawn at the side specified by the gravity resource.
After positioning all children, the Tree widget attempts to shrink its own size to the minimum
dimensions required for the layout.
6.6.4. Convenience Routines
The most efficient way to layout a tree is to set autoReconfigure to False and then use the
XawTreeForceLayout routine to arrange the children.
128