summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorfvogel <fvogelnew1@free.fr>2017-01-23 20:09:59 (GMT)
committerfvogel <fvogelnew1@free.fr>2017-01-23 20:09:59 (GMT)
commit68822a4513193a63ff4b05a712018d5726104368 (patch)
treecea9f795e36eb988774e590494ba2f4c9c0975ab
parentd95efc31eb0a189199e0ccc20af3adc0c9f0582f (diff)
parent3fb089ed701dcab661c4b34a2ea70bef7d5d9516 (diff)
downloadtk-68822a4513193a63ff4b05a712018d5726104368.zip
tk-68822a4513193a63ff4b05a712018d5726104368.tar.gz
tk-68822a4513193a63ff4b05a712018d5726104368.tar.bz2
Fix [ed22529c92]: Spinbox validation is turned off when validate function returns false
-rw-r--r--doc/spinbox.n14
1 files changed, 9 insertions, 5 deletions
diff --git a/doc/spinbox.n b/doc/spinbox.n
index 330bb17..acf06d6 100644
--- a/doc/spinbox.n
+++ b/doc/spinbox.n
@@ -217,15 +217,19 @@ were editing the spinbox widget from). It is also recommended to not set an
associated \fB\-textvariable\fR during validation, as that can cause the
spinbox widget to become out of sync with the \fB\-textvariable\fR.
.PP
-Also, the \fBvalidate\fR option will set itself to \fBnone\fR when the
-spinbox value gets changed because of adjustment of \fBfrom\fR or \fBto\fR
-and the \fBvalidateCommand\fR returns false. For instance
+Also, the \fB-validate\fR option will set itself to \fBnone\fR when the
+spinbox value gets changed because of adjustment of \fB-from\fR or \fB-to\fR
+and the \fB-validatecommand\fR returns false. For instance
.CS
\fIspinbox pathName \-from 1 \-to 10 \-validate all \-vcmd {return 0}\fR
.CE
-will in fact set the \fBvalidate\fR option to \fBnone\fR because the default
-value for the spinbox gets changed (due to the \fBfrom\fR and \fBto\fR
+will in fact set the \fB-validate\fR option to \fBnone\fR because the default
+value for the spinbox gets changed (due to the \fB-from\fR and \fB-to\fR
options) to a value not accepted by the validation script.
+.PP
+Moreover, forced validation is performed when invoking any spinbutton of
+the spinbox. If the validation script returns false in this situation,
+then the \fB-validate\fR option will be automatically set to \fBnone\fR.
.SH "WIDGET COMMAND"
.PP
The \fBspinbox\fR command creates a new Tcl command whose