ttk_checkbutton
(1t)
Name
ttk_checkbutton - On/off widget
Synopsis
ttk::checkbutton pathName ?options?
Description
ttk::checkbutton(1t) Tk Themed Widget ttk::checkbutton(1t)
______________________________________________________________________________
NAME
ttk::checkbutton - On/off widget
SYNOPSIS
ttk::checkbutton pathName ?options?
______________________________________________________________________________
DESCRIPTION
A ttk::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
-class -compound -cursor
-image -state -style
-takefocus -text -textvariable
-underline -width
See the ttk_widget manual entry for details on the standard options.
WIDGET-SPECIFIC OPTIONS
Command-Line Name:-command
Database Name: command
Database Class: Command
A Tcl script to execute whenever the widget is invoked.
Command-Line Name:-offvalue
Database Name: offValue
Database Class: OffValue
The value to store in the associated -variable when the widget
is deselected. Defaults to 0.
Command-Line Name:-onvalue
Database Name: onValue
Database Class: OnValue
The value to store in the associated -variable when the widget
is selected. Defaults to 1.
Command-Line Name:-variable
Database Name: variable
Database Class: Variable
The name of a global variable whose value is linked to the wid-
get. Defaults to the widget pathname if not specified.
WIDGET COMMAND
In addition to the standard cget, configure, identify, instate, and
state commands, checkbuttons support the following additional widget
commands:
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.
WIDGET STATES
The widget does not respond to user input if the disabled state is set.
The widget sets the selected state whenever the linked -variable is set
to the widget's -onvalue, and clears it otherwise. The widget sets the
alternate state whenever the linked -variable is unset. (The alternate
state may be used to indicate a "tri-state" or "indeterminate" selec-
tion.)
STANDARD STYLES
Ttk::checkbutton widgets support the Toolbutton style in all standard
themes, which is useful for creating widgets for toolbars.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/tk-8 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
ttk::widget(n), ttk::radiobutton(n), checkbutton(n)
KEYWORDS
widget, button, toggle, check, option
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://source-
forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.
Further information about this software can be found on the open source
community website at https://www.tcl.tk/.
Tk 8.5 ttk::checkbutton(1t)