summaryrefslogtreecommitdiffstats
path: root/doc/ttk_widget.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ttk_widget.n')
-rw-r--r--doc/ttk_widget.n19
1 files changed, 10 insertions, 9 deletions
diff --git a/doc/ttk_widget.n b/doc/ttk_widget.n
index d2979b8..26f7db0 100644
--- a/doc/ttk_widget.n
+++ b/doc/ttk_widget.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_widget.n,v 1.11 2007/11/01 10:59:44 dkf Exp $
+'\" RCS: @(#) $Id: ttk_widget.n,v 1.12 2007/12/12 15:51:22 jenglish Exp $
'\"
.so man.macros
.TH ttk::widget n 8.5 Tk "Tk Themed Widget"
@@ -40,14 +40,12 @@ See \fIoptions(n)\fR in the Tk reference manual for the full description.
.OP \-style style Style
May be used to specify a custom widget style.
.SH "SCROLLABLE WIDGET OPTIONS"
-.PP
The following options are supported by widgets that
are controllable by a scrollbar.
See \fIscrollbar(n)\fR for more information
.OP \-xscrollcommand xScrollCommand ScrollCommand
A command prefix, used to communicate with horizontal scrollbars.
.RS
-.PP
When the view in the widget's window changes, the widget will
generate a Tcl command by concatenating the scroll command and
two numbers.
@@ -67,7 +65,7 @@ This will cause the scrollbar to be updated whenever the view in the
window changes.
.PP
If this option is set to the empty string (the default),
-then no command is be executed.
+then no command will be executed.
.RE
.OP \-yscrollcommand yScrollCommand ScrollCommand
A command prefix, used to communicate with vertical scrollbars.
@@ -121,10 +119,11 @@ If zero or unspecified, the natural width of the text label is used.
.OP \-state state State
May be set to \fBnormal\fR or \fBdisabled\fR
to control the \fBdisabled\fR state bit.
-This is a
-.QW write-only
-option: setting it changes the widget state, but the \fBstate\fR
-widget command does not affect the state option.
+This is a write-only option:
+setting it changes the widget state,
+but the \fBstate\fR widget command
+does not affect the \fB\-state\fR option.
+
.SH COMMANDS
.TP
\fIpathName \fBcget\fR \fIoption\fR
@@ -155,11 +154,12 @@ If \fIscript\fR is specified, equivalent to
if {[\fIpathName\fR instate \fIstateSpec\fR]} \fIscript\fR
.CE
.TP
-\fIpathName \fBstate\fR ?\fIstateSpec\fR
+\fIpathName \fBstate\fR ?\fIstateSpec\fR?
Modify or inquire widget state.
If \fIstateSpec\fR is present, sets the widget state:
for each flag in \fIstateSpec\fR, sets the corresponding flag
or clears it if prefixed by an exclamation point.
+.RS
Returns a new state spec indicating which flags were changed:
.CS
set changes [\fIpathName \fRstate \fIspec\fR]
@@ -168,6 +168,7 @@ set changes [\fIpathName \fRstate \fIspec\fR]
will restore \fIpathName\fR to the original state.
If \fIstateSpec\fR is not specified,
returns a list of the currently-enabled state flags.
+.RE
.SH "WIDGET STATES"
The widget state is a bitmap of independent state flags.
Widget state flags include: