iwidgets::checkbox - Create and manipulate a checkbox widget

       John A. Tucker

       The  iwidgets::checkbox command creates a check button box widget capable of adding, inserting, deleting,
       selecting, and configuring checkbuttons as well as obtaining the currently selected button.

        package require Iwidgets 4.0
        iwidgets::checkbox .cb -labeltext Styles
        .cb add bold -text Bold
        .cb add italic -text Italic
        .cb add underline -text Underline
        .cb select underline

        pack .cb -padx 10 -pady 10 -fill both -expand yes

       itk::Widget <- iwidgets::Labeledframe <- iwidgets::Checkbox

labelBitmaplabelFontlabelImagelabelMarginlabelPoslabelTextlabelVariable

       See the "labeledframe" class manual entry for details on the inherited options.

       checkbox, widget

Tk                                                                                         iwidgets::checkbox(1)

       The iwidgets::checkbox command creates a new Tcl command whose name is pathName.   This  command  may  be
       used to invoke various operations on the widget.  It has the following general form: pathNameoption ?argarg...?  Option and the args determine the exact behavior of the command.

       Many  of  the  widget commands for the checkbox take as one argument an indicator of which checkbutton of
       the checkbox to operate on.  These indicators are called indexes and allow reference and manipulation  of
       checkbuttons.  Checkbox indexes may be specified in any of the following forms:

       number      Specifies  the  checkbutton  numerically,  where  0 corresponds to the top checkbutton of the
                   checkbox.

       end         Indicates the last checkbutton of the checkbox.

       pattern     If the index doesn't satisfy one of the above forms then  this  form  is  used.   Pattern  is
                   pattern-matched  against  the  tag  of each checkbutton in the checkbox, in order from top to
                   bottom, until a matching entry is found.  The rules of Tcl_StringMatch are used.

       iwidgets::checkbox - Create and manipulate a checkbox widget

backgroundborderWidthcursordisabledForegroundforegroundreliefselectColor

       See the "options" manual entry for details on the standard options.

iwidgets::checkboxpathName ?options?

pathNameaddtag ?optionvalueoptionvalue?
              Adds a new checkbutton to the checkbuttond window on the bottom.   The  command  takes  additional
              options  which  are  passed  on  to  the checkbutton as construction arguments.  These include the
              standard Tk checkbutton options.  The tag is returned.

       pathNamebuttonconfigureindex ?options?
              This command is similar to the configure command, except that it applies to  the  options  for  an
              individual  checkbutton,  whereas  configureapplies  to  the  options for the checkbox as a whole.
              Options may have any of the values accepted by the add widget command.  If options are  specified,
              options  are  modified as indicated in the command and the command returns an empty string.  If no
              options are specified, returns a  list  describing  the  current  options  for  entry  index  (see
              Tk_ConfigureInfo for information on the format of this list).

       pathNamecgetoption
              Returns the current value of the configuration option given by option.  Option may have any of the
              values accepted by the iwidgets::checkbox command.

       pathNameconfigure ?option? ?valueoptionvalue...?
              Query  or  modify  the  configuration options of the widget.  If no option is specified, returns a
              list describing all of the available options for pathName (see Tk_ConfigureInfo for information on
              the format of this list).  If option is specified with no value, then the command returns  a  list
              describing  the  one named option (this list will be identical to the corresponding sublist of the
              value returned if no option is specified).  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.   Option  may  have  any  of  the  values  accepted  by   the
              iwidgets::checkbox command.

       pathNamedeleteindex
              Deletes a specified checkbutton given an index.

       pathNamedeselectindex
              Deselects a specified checkbutton given an index.

       pathNameflashindex
              Flashes a specified checkbutton given an index.

       pathNameget ?index?
              Returns  the  tags  of  the  currently  selected  checkbuttons or the selection status of specific
              checkbutton when given an index.

       pathNameindexindex
              Returns the numerical index corresponding to index.

       pathNameinsertindextag ?optionvalueoptionvalue...?
              Same as the add command except that it inserts the new checkbutton just before the  one  given  by
              index,  instead of appending to the end of the checkbox.  The option, and value arguments have the
              same interpretation as for the add widget command.

       pathNameselectindex
              Selects a specified checkbutton given an index.

       Name:   command
       Class:  Command
       Command-Line Switch:    -command

              Specifies  a  Tcl  command  procedure to be evaluated following a  change in the current check box
              selection.

       Name:   orient
       Class:  Orient
       Command-Line Switch:    -orient
       Default Value:  vertical

              Specifies the orientation of the checkbuttons  within  the  checkbox.   Valid  values  are  either
              "horizontal" or "vertical".

________________________________________________________________________________________________________________