VtToggleButton(VTCL)

VtToggleButton -- create toggle button, return widget name

Synopsis

VtToggleButton widgetName [options]

Creates a ToggleButton. The button may be labelled using the standard Label class options. Returns the widget name.

-noCallback (CS): Suppresses the -callback when -value is set.
-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 ToggleButton as if setting -value on the widget.
-value boolean (CSG): Sets whether the state of the toggle is on or off. To use this option, also set -noCallback.

If VtToggleButton fails, it returns one of the following error messages:

NO_VALUE_SET: specified -noCallback without setting -value
Standard errors: See ``Tcl widget creation errors'' in Developing Visual Tcl applications.