hwtk::checkbutton
On/off widget
Format
hwtk::checkbutton - pathName ?option value? …
Description
A hwtk::checkbutton widget is used to show or change a setting. It has two states, selected and deselected. The state of the checkbutton may be linked to a Tcl variable.
Standard Options
- -clientdata
- Database name: clientData
- -compound
- Database name: compound
- -cursor
- Database name: cursor
- -help
- Database name: help
- -helpcommand
- Database name: helpcommand
- -image
- Database name: image
- -state
- Database name: state
- -takefocus
- Database name: takeFocus
- -text
- Database name: text
- -textvariable
- Database name: textVariable
- -underline
- Database name: underline
- -width
- Database name: width
Widget-Specific Options
- -command
- Database name: command
- -offvalue
- Database name: offValue
- -onvalue
- Database name: onValue
- -variable
- Database name: variable
Widget Command
- pathName configure ?option? ?value option value …?
- Query or modify the configuration options of the widget. If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. If option is specified with no value, then the command returns a list describing the named option: the elements of the list are the option name, database name, database class, default value, and current value. If no option is specified, returns a list describing all of the available options for pathName.
- pathName cget option
- Returns the current value of the configuration option given by option.
- pathName identify element x y
- Returns the name of the element under the point given by x and y, or an empty string if the point does not lie within any element. x and y are pixel coordinates relative to the widget. Some widgets accept other identify subcommands.
- pathName instate statespec ?script?
- Test the widget’s state. If script is not specified, returns 1 if the
widget state matches statespec and 0 otherwise. If script is specified,
equivalent to
if{[pathNameinstatestateSpec]}script
- pathName state ?stateSpec?
- Modify or inquire widget state. If stateSpec is
present, sets the widget state: for each flag in
stateSpec, sets the corresponding flag or clears it
if prefixed by an exclamation point. Returns a new state spec indicating
which flags were changed:
will restore pathName to the original state. If stateSpec is not specified, returns a list of the currently-enabled state flags.setchanges[pathNamestatespec]
pathNamestate$changes
- 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.
Example
::hwtk::dialog .d -title "::hwtk::checkbutton"
set f [.d recess]
array set state {wipers 1 brakes 0 driver 1 }
hwtk::checkbutton $f.ck1 -text "Wipers OK" -help "Select safety item - wipers" -variable state(wipers)
hwtk::checkbutton $f.ck2 -text "Brakes OK" -help "Select safety item - brakes" -variable state(brakes)
hwtk::checkbutton $f.ck3 -text "Drive sober" -help "Select safety item - driver state" -variable state(driver)
grid $f.ck1 -sticky w
grid $f.ck2 -sticky w
grid $f.ck3 -sticky w
.d post