Checkbutton Entries
- Preface
- Introduction
- Tutorial
- Implementation
- Commands
- bitmap
- eval-wish
- get-tk-var
- photo
- set-tk-var!
- tk
- tk-id->widget
- tk-var
- tk/after
- tk/appname
- tk/bind
- tk/bindtags
- tk/caret
- tk/choosecolor
- tk/choosedirectory
- tk/clipboard
- tk/console
- tk/destroy
- tk/dialog
- tk/event
- tk/focus
- tk/getopenfile
- tk/getsavefile
- tk/grab
- tk/grid
- tk/image
- tk/lower
- tk/messagebox
- tk/option
- tk/pack
- tk/place
- tk/popup
- tk/raise
- tk/scaling
- tk/update
- tk/useinputmethods
- tk/wait
- tk/windowingsystem
- tk/winfo
- tk/wm
- Options
- Extensions
- Changes
A checkbutton menu entry behaves much like a checkbutton widget.
When it is invoked it toggles back and forth between the selected and deselected states.
When the entry is selected, a particular value is stored in a particular global variable (as determined by the #:onvalue and #:variable options for the entry); when the entry is deselected another value (determined by the #:offvalue option) is stored in the global variable. An indicator box is displayed to the left of the label in a checkbutton entry.
If the entry is selected then the indicator's center is displayed in the color given by the #:selectcolor option for the entry; otherwise the indicator's center is displayed in the background color for the menu.
If a #:command option is specified for a checkbutton entry, then its value is evaluated as a Tcl command each time the entry is invoked; this happens after toggling the entry's selected state.