Geometry class options

The following options govern the positioning of widgets once they are placed in a form.

-above widgetName (CS)

Used for widget placement. 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.

-alignHorizontal widgetName (CS)

Aligns the horizontal axis of the source object with the horizontal axis 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.

-alignVertical widgetName (CS)

Aligns the vertical axis of the source object with the vertical axis 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 % of the height of the form from the bottom

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

-bottomOffset integer

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

-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 % 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)

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

-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 % 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)

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

-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 % of the height of the form from the top

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

-topOffset integer (CS)

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

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.