summaryrefslogtreecommitdiffstats
path: root/doc/ttk_checkbutton.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ttk_checkbutton.n')
-rw-r--r--doc/ttk_checkbutton.n39
1 files changed, 20 insertions, 19 deletions
diff --git a/doc/ttk_checkbutton.n b/doc/ttk_checkbutton.n
index 3f59cb7..eb5fd6c 100644
--- a/doc/ttk_checkbutton.n
+++ b/doc/ttk_checkbutton.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: ttk_checkbutton.n,v 1.6 2007/10/24 14:32:59 dkf Exp $
+'\" RCS: @(#) $Id: ttk_checkbutton.n,v 1.7 2007/10/26 20:13:23 dgp Exp $
'\"
.so man.macros
.TH ttk_checkbutton n 8.5 Tk "Tk Themed Widget"
@@ -21,23 +21,24 @@ A \fBttk::checkbutton\fR 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.
.SO
-\-class \-compound \-cursor
-\-image \-state \-style
-\-takefocus \-text \-textvariable
-\-underline \-width
+\-class \-compound \-cursor \-image
+\-state \-style \-takefocus \-text
+\-textvariable \-underline \-width
.SE
+
.SH "WIDGET-SPECIFIC OPTIONS"
.OP \-command command Command
A Tcl script to execute whenever the widget is invoked.
.OP \-offvalue offValue OffValue
-The value to store in the associated \fB\-variable\fR
+The value to store in the associated \fI-variable\fR
when the widget is deselected. Defaults to \fB0\fR.
.OP \-onvalue onValue OnValue
-The value to store in the associated \fB\-variable\fR
+The value to store in the associated \fI-variable\fR
when the widget is selected. Defaults to \fB1\fR.
.OP \-variable variable Variable
The name of a global variable whose value is linked to the widget.
Defaults to the widget pathname if not specified.
+
.SH "WIDGET COMMAND"
In addition to the standard
\fBcget\fR, \fBconfigure\fR, \fBinstate\fR, and \fBstate\fR
@@ -46,27 +47,27 @@ widget commands:
.TP
\fIpathname\fR invoke
Toggles between the selected and deselected states
-and evaluates the associated \fB\-command\fR.
-If the widget is currently selected, sets the \fB\-variable\fR
-to the \fB\-offvalue\fR and deselects the widget;
-otherwise, sets the \fB\-variable\fR to the \fB\-onvalue\fR
-Returns the result of the \fB\-command\fR.
+and evaluates the associated \fI-command\fR.
+If the widget is currently selected, sets the \fI-variable\fR
+to the \fI-offvalue\fR and deselects the widget;
+otherwise, sets the \fI-variable\fR to the \fI-onvalue\fR
+Returns the result of the \fI-command\fR.
.\" Missing: select, deselect, toggle
.\" Are these useful? They don't invoke the -command
.\" Missing: flash. This is definitely not useful.
+
.SH "WIDGET STATES"
The widget does not respond to user input if the \fBdisabled\fR state is set.
The widget sets the \fBselected\fR state whenever
-the linked \fB\-variable\fR is set to the widget's \fB\-onvalue\fR,
+the linked \fB-variable\fR is set to the widget's \fB-onvalue\fR,
and clears it otherwise.
The widget sets the \fBalternate\fR state whenever the
-linked \fB\-variable\fR is unset.
-(The \fBalternate\fR state may be used to indicate a
-.QW tri-state
-or
-.QW indeterminate
-selection.)
+linked \fB-variable\fR is unset.
+(The \fBalternate\fR state may be used to indicate a ``tri-state''
+or ``indeterminate'' selection.)
+
.SH "SEE ALSO"
ttk_widget(n), ttk_radiobutton(n), checkbutton(n)
+
.SH "KEYWORDS"
widget, button, toggle, check, option