Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

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)