summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2022-03-02 13:07:31 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2022-03-02 13:07:31 (GMT)
commit47f1a8a08fa32a319b564eca0c1570cbcb78a6dc (patch)
tree3dec82f55a6f01e0b464044f554fb3335394e1b3 /doc
parente119a87f5f576ce9c4469d5f0b2d648127c7531f (diff)
parente09be91bbab4de3be2f23c5ba57fbdd242942313 (diff)
downloadtk-47f1a8a08fa32a319b564eca0c1570cbcb78a6dc.zip
tk-47f1a8a08fa32a319b564eca0c1570cbcb78a6dc.tar.gz
tk-47f1a8a08fa32a319b564eca0c1570cbcb78a6dc.tar.bz2
Merge 8.7
Diffstat (limited to 'doc')
-rw-r--r--doc/SetOptions.321
-rw-r--r--doc/ttk_style.n2
2 files changed, 16 insertions, 7 deletions
diff --git a/doc/SetOptions.3 b/doc/SetOptions.3
index 0b58dc8..2bc10c8 100644
--- a/doc/SetOptions.3
+++ b/doc/SetOptions.3
@@ -333,7 +333,9 @@ nor \fIclientData\fR.
\fBTK_OPTION_ANCHOR\fR
The value must be a standard anchor position such as \fBne\fR or
\fBcenter\fR. The internal form is a Tk_Anchor value like the ones
-returned by \fBTk_GetAnchorFromObj\fR.
+returned by \fBTk_GetAnchorFromObj\fR. This option type supports the \fBTK_OPTION_NULL_OK\fR
+flag; if the empty string is specified as the value for the option,
+the integer relief value is set to \fBTK_ANCHOR_NULL\fR.
.TP
\fBTK_OPTION_BITMAP\fR
The value must be a standard Tk bitmap name. The internal form is a
@@ -343,7 +345,11 @@ such as \fBTk_SetOptions\fR, and it supports the \fBTK_OPTION_NULL_OK\fR flag.
.TP
\fBTK_OPTION_BOOLEAN\fR
The value must be a standard boolean value such as \fBtrue\fR or
-\fBno\fR. The internal form is an integer with value 0 or 1.
+\fBno\fR. The internal form is an integer with value 0 or 1. Note: if the
+\fIobjOffset\fR field is not used then information about the original value
+of this option will be lost. This option type supports the
+\fBTK_OPTION_NULL_OK\fR flag; if a NULL value is set, the internal
+representation is set to -1.
.TP
\fBTK_OPTION_BORDER\fR
The value must be a standard color name such as \fBred\fR or \fB#ff8080\fR.
@@ -377,7 +383,7 @@ option type. See the section \fBCUSTOM OPTION TYPES\fR below for details.
The string value must be a floating-point number in
the format accepted by \fBstrtol\fR. The internal form is a C
\fBdouble\fR value. This option type supports the \fBTK_OPTION_NULL_OK\fR
-flag; if a NULL value is set, the internal representation is set to zero.
+flag; if a NULL value is set, the internal representation is set to NaN.
.TP
\fBTK_OPTION_END\fR
Marks the end of the template. There must be a Tk_OptionSpec structure
@@ -399,12 +405,15 @@ such as \fBTk_SetOptions\fR, and it supports the \fBTK_OPTION_NULL_OK\fR flag.
The string value must be an integer in the format accepted by
\fBstrtol\fR (e.g. \fB0\fR and \fB0x\fR prefixes may be used to
specify octal or hexadecimal numbers, respectively). The internal
-form is a C \fBint\fR value.
+form is a C \fBint\fR value. This option type supports the \fBTK_OPTION_NULL_OK\fR
+flag; if a NULL value is set, the internal representation is set to INT_MIN.
.TP
\fBTK_OPTION_JUSTIFY\fR
The value must be a standard justification value such as \fBleft\fR.
The internal form is a Tk_Justify like the values returned by
-\fBTk_GetJustifyFromObj\fR.
+\fBTk_GetJustifyFromObj\fR. This option type supports the \fBTK_OPTION_NULL_OK\fR
+flag; if the empty string is specified as the value for the option,
+the integer relief value is set to \fBTK_JUSTIFY_NULL\fR.
.TP
\fBTK_OPTION_PIXELS\fR
The value must specify a screen distance such as \fB2i\fR or \fB6.4\fR.
@@ -414,7 +423,7 @@ distance in pixels, like the values returned by
used then information about the original value of this option will be lost.
See \fBOBJOFFSET VS. INTERNALOFFSET\fR below for details. This option
type supports the \fBTK_OPTION_NULL_OK\fR flag; if a NULL value is set, the
-internal representation is set to zero.
+internal representation is set to INT_MIN.
.TP
\fBTK_OPTION_RELIEF\fR
The value must be standard relief such as \fBraised\fR.
diff --git a/doc/ttk_style.n b/doc/ttk_style.n
index a8ecf06..057a1db 100644
--- a/doc/ttk_style.n
+++ b/doc/ttk_style.n
@@ -15,7 +15,7 @@ ttk::style \- Manipulate style database
.SH NOTES
.PP
See also the Tcl'2004 conference presentation,
-available at https://tktable.sourceforge.net/tile/tile-tcl2004.pdf
+available at http://tktable.sourceforge.net/tile/tile-tcl2004.pdf
.SH DEFINITIONS
.PP
Each widget is assigned a \fIstyle\fR,