Geometry class options

Geometry class options govern the positioning of widgets. They are available for all widgets that are children of forms created with VtForm(1vtcl), VtFormDialog(1vtcl), and VtFrame(1vtcl) (when the -asForm options is specified).

Each side of a widget can specify something that it attaches to. This can be:

• the side of another widget

• the edge of the form

• a line some distance down or across the form

• nothing

The following geometry class options are available:

-above widgetName (CS)

Puts the object above widgetName. For example, to create two PushButtons, with button b above button a:

set a [VtPushButton $fn.a -label "button a" \
	-topSide NONE -bottom FORM]
set b [VtPushButton $fn.b -label "button b" -above $a]

Be careful not to put widgets into negative space. In the above example, button a is explicitly attached to the bottom of the form. If it were not, button b would exist outside the viewing form area.

-alignBottom widgetName (CS)

Aligns the bottom of the source object with the bottom side of the target object.

-alignLeft widgetName (CS)

Aligns the left side of the source object with the left side of the target object.

-alignRight widgetName (CS)

Aligns the right side of the source object with the right side of the target object.

-alignTop widgetName (CS)

Aligns the top of the source object with the top side of the target object.

-below widgetName (CS)

Puts the source object below the target object.

-bottomSide widgetName |FORM | distance | NONE (CS)

Attaches the bottom side of the source object to one of:

• the top of the target object

• the bottom of the FORM

• a distance (percent of the height of the form from the bottom)

Alternatively, if NONE is specified, any attachment is removed.

-bottomOffset integer (CS)

Specifies the amount to offset the bottomSide attachment by (in character widths under character mode, or in pixels under graphical mode). The default is 0.

-leftSide widgetName | FORM | distance | NONE (CS)

Attaches the left side of the source object to one of:

• the right side of the target object

• the left side of the FORM

• a distance (percent of the width of the form from the left side of the form)

Alternatively, if NONE is specified, any attachment is removed.

-leftOffset integer (CS)

Specifies the amount to offset the leftOffset attachment by (in character widths under character mode, or in pixels under graphical mode). The default is 0.

-rightSide widgetName | FORM | distance | NONE (CS)

Attaches the right side of the source object to one of:

• the left side of the target object

• the right side of the FORM

• a distance (percent of the width of the form from the right side of the form)

Alternatively, if NONE is specified, any attachment is removed.

-rightOffset integer (CS)

Specifies the amount to offset the rightOffset attachment by (in character widths under character mode, or in pixels under graphical mode). The default is 0.

-topSide widgetName | FORM | distance | NONE (CS)

Attaches the top of the source object to one of:

• the bottom of the target object

• the top of the FORM

• a distance (percent of the height of the form from the top)

Alternatively, if NONE is specified, any attachment is removed.

-topOffset integer (CS)

Specifies the amount to offset the topOffset attachment by (in character widths under character mode, or in pixels under graphical mode). The default is 0.

Note that fractional distances in the options bottomSide, leftSide, rightSide, and topSide are defined in terms of the defined fractionBase value of the form; see ``Form class options'' for details.