NAME

checkbutton -
On/off widget

SYNOPSIS

ttk::checkbutton pathName ?options?

DESCRIPTION

A checkbutton widget is used to show or change a setting. It has two states, selected and deselected. The state of the checkbuton may be linked to a Tcl variable.

STANDARD OPTIONS

OPTIONS

NameDatabase nameDatabase class
-commandcommandCommand
 A Tcl script to execute whenever the widget is invoked.
-offvalueoffValueOffValue
 The value to store in the associated -variable when the widget is deselected. Defaults to 0.
-onvalueonValueOnValue
 The value to store in the associated -variable when the widget is selected. Defaults to 1.
-variablevariableVariable
 The name of a global variable whose value is linked to the widget. Defaults to the empty string.

WIDGET COMMAND

In addition to the standard cget, configure, instate, and state commands, checkbuttons support the following additional widget commands:

NameDatabase nameDatabase class
  pathname invoke Toggles between the selected and deselected states and evaluates the associated -command. If the widget is currently selected, sets the -variable to the -offvalue and deselects the widget; otherwise, sets the -variable to the -onvalue Returns the result of the -command.

SEE ALSO

widget(n), keynav(n), radiobutton(n)

KEYWORDS

widget, button, toggle, check, option