VtScale(VTCL)

VtScale -- create graphical Scale based on current value of field, return widget name

Syntax

VtScale widgetName [options]

Description

Creates a Scale which consists of a bar with a graphical representation that shows the current numerical value of the field. Returns the widget name.

For example:

VtScale $form.scale -min 0 -max 100 -value 50

Options

-callback cmd (C)

Called when the value of Scale is changed. The value of the Scale at the time of the callback will be passed as part of the callback data. The key to reference is ``value''.

Additional callback keys:

value: value of the Scale

-horizontal (CS)

Sets the orientation to horizontal.

-length integer (CS)

Sets the length of the Scale (specified in number of characters) to integer characters (in the character environment). In the graphical environment, sets the length of the Scale to integer multiplied by the maximum font width.

-max integer (CSG)

Sets the maximum value that a Scale can have.

-min integer (CSG)

Sets the minimum value that a Scale can have.

-readOnly (C)

Flag: if set, the slider is disabled.

-showValue boolean (CSG)

When TRUE, the VtScale's value is shown above the Scale. The default is TRUE.

-textVariable string (CS)

Updates the interpreter variable string with the widget value. The update happens under the same conditions that would invoke -callback, but before -callback is called. Setting a value into the interpreter variable updates the Scale as if setting -value on the widget.

-title string (CSG)

Sets the title string displayed at the bottom of the Scale.

-value integer (CSG)

Sets the current value (restricted in range from min to max.)

-vertical (CS)

Sets the orientation to vertical.