summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorbll <brad.lanam.comp@gmail.com>2018-04-07 21:41:23 (GMT)
committerbll <brad.lanam.comp@gmail.com>2018-04-07 21:41:23 (GMT)
commit9f347dbb2d063634cf64fa8ba9148f9a9d94d1ff (patch)
tree72284348f9e428240c383b9abf9e820d1c36e111 /doc
parentb8e8b04cbc139156ee15356180185446b08d1cbb (diff)
downloadtk-9f347dbb2d063634cf64fa8ba9148f9a9d94d1ff.zip
tk-9f347dbb2d063634cf64fa8ba9148f9a9d94d1ff.tar.gz
tk-9f347dbb2d063634cf64fa8ba9148f9a9d94d1ff.tar.bz2
draft 4
Diffstat (limited to 'doc')
-rw-r--r--doc/ttk_button.n40
-rw-r--r--doc/ttk_checkbutton.n26
-rw-r--r--doc/ttk_combobox.n35
-rw-r--r--doc/ttk_entry.n45
-rw-r--r--doc/ttk_frame.n13
-rw-r--r--doc/ttk_separator.n13
-rw-r--r--doc/ttk_sizegrip.n15
-rw-r--r--doc/ttk_spinbox.n43
8 files changed, 181 insertions, 49 deletions
diff --git a/doc/ttk_button.n b/doc/ttk_button.n
index 7e7db11..2aaad18 100644
--- a/doc/ttk_button.n
+++ b/doc/ttk_button.n
@@ -61,28 +61,44 @@ themes, which is useful for creating widgets for toolbars.
.PP
The class name for a \fBttk::button\fP is \fBTButton\fP.
.PP
+Dynamic states: active, disabled, pressed, readonly.
+.PP
\fBTButton\fP styling options configurable with \fBttk::style\fP
are:
.PP
--background
-.RS
+\fB-anchor\fP
.br
-maps: active, disabled, readonly
-.RE
+\fB-background\fP
.br
--foreground
+\fB-bordercolor\fP
.br
-.RS
-maps: active, disabled, readonly
-.RE
+\fB-darkcolor\fP
+.br
+\fB-foreground\fP
+.br
+\fB-font\fP
.br
--font
+\fB-highlightcolor\fP
.br
--bordercolor
+\fB-highlightthickness\fP
.br
--lightcolor
+\fB-lightcolor\fP
.br
--darkcolor
+\fB-padding\fP
+.br
+\fB-relief\fP
+.br
+\fB-shiftrelief\fP
+.br
+.RS
+-shiftrelief specifies how far the button contents are
+shifted down and right in the \fIpressed\fP state.
+This action provides additional skeumorphic feedback.
+.RE
+.br
+\fB-width\fP
+.PP
+Some options are only available for specific themes.
.PP
See the \fBttk::style\fP manual page for information on how to configure
ttk styles.
diff --git a/doc/ttk_checkbutton.n b/doc/ttk_checkbutton.n
index 6e5149f..c62bf3f 100644
--- a/doc/ttk_checkbutton.n
+++ b/doc/ttk_checkbutton.n
@@ -72,29 +72,31 @@ standard themes, which is useful for creating widgets for toolbars.
.PP
The class name for a \fBttk::checkbutton\fP is \fBTCheckbutton\fP.
.PP
+Dynamic states: active, alternate, disabled, pressed, selected, readonly.
+.PP
\fBTCheckbutton\fP styling options configurable with \fBttk::style\fP
are:
.PP
--background
-.RS
.br
-maps: active, disabled, readonly
-.RE
+\fB-background\fP
.br
--foreground
+\fB-foreground\fP
.br
-.RS
-maps: active, disabled, readonly
-.RE
+\fB-indicatorbackground\fP
.br
--font
+\fB-indicatorcolor\fP
+.br
+\fB-indicatormargin\fP
.br
--indicatorcolor
.RS
+This is a padding value.
+.RE
.br
-maps: selected, pressed
+\fB-indicatorrelief\fP
.br
-.RE
+\fB-padding\fP
+.PP
+Some options are only available for specific themes.
.PP
See the \fBttk::style\fP manual page for information on how to configure
ttk styles.
diff --git a/doc/ttk_combobox.n b/doc/ttk_combobox.n
index f2a0cad..06eee0f 100644
--- a/doc/ttk_combobox.n
+++ b/doc/ttk_combobox.n
@@ -113,51 +113,37 @@ this event is delivered after the listbox is unposted.
.SH "STYLING OPTIONS"
.PP
The class name for a \fBttk::combobox\fP is \fBTCombobox\fP.
-The \fBttk::combobox\fP uses the pre-ttk \fBentry\fP and
+The \fBttk::combobox\fP uses the \fBentry\fP and
\fBlistbox\fP widgets internally.
.PP
+Dynamic states: disabled, readonly.
+.PP
\fBTCombobox\fP styling options configurable with \fBttk::style\fP
are:
.PP
--background
-.RS
-.br
-maps: disabled, readonly
-.RE
+\fB-background\fP
.br
--foreground
-.br
-.RS
-maps: disabled, readonly
-.RE
+\fB-foreground\fP
.br
--fieldbackground
+\fB-fieldbackground\fP
.br
.RS
Can only be changed when using non-native and non-graphical themes.
-.br
-maps: disabled, readonly
.RE
.br
--selectbackground
+\fB-selectbackground\fP
.br
.RS
Text entry select background.
.RE
.br
--selectforeground
+\fB-selectforeground\fP
.br
.RS
Text entry select foreground.
.RE
.br
--bordercolor
-.br
-.RS
-Used by the Clam theme and derivatives.
-.RE
-.br
-.mycombobox configure -font \fIfont\fP
+\fB-bordercolor\fP
.br
option add *TCombobox*Listbox.background \fIcolor\fP
.br
@@ -174,7 +160,8 @@ To set the font size for a specific listbox (subject to future change):
set popdown [ttk::combobox::PopdownWindow .mycombobox]
.br
$popdown.f.l configure -font namedfont
-.br
+.PP
+Some options are only available for specific themes.
.PP
See the \fBttk::style\fP manual page for information on how to configure
ttk styles.
diff --git a/doc/ttk_entry.n b/doc/ttk_entry.n
index 984e957..d60f0d2 100644
--- a/doc/ttk_entry.n
+++ b/doc/ttk_entry.n
@@ -461,6 +461,51 @@ and a different background is used in the \fBreadonly\fR state.
.PP
The entry widget sets the \fBinvalid\fR state if revalidation fails,
and clears it whenever validation succeeds.
+.SH "STYLING OPTIONS"
+.PP
+The class name for a \fBttk::entry\fP is \fBTEntry\fP.
+.PP
+Dynamic states: disabled, focus, readonly.
+.PP
+\fBTEntry\fP styling options configurable with \fBttk::style\fP
+are:
+.PP
+\fB-background\fP
+.br
+.RS
+When using the aqua theme (Mac OS X), changes the -fieldbackground.
+.RE
+.br
+\fB-bordercolor\fP
+.br
+\fB-darkcolor\fP
+.br
+\fB-fieldbackground\fP
+.br
+.RS
+Does not work with the aqua theme (Mac OS X).
+.br
+Some themes use a graphical background and their field background colors cannot be changed.
+.RE
+.br
+\fB-foreground\fP
+.br
+\fB-lightcolor\fP
+.br
+\fB-insertwidth\fP
+.br
+\fB-padding\fP
+.br
+\fB-relief\fP
+.br
+\fB-selectbackground\fP
+.br
+\fB-selectborderwidth\fP
+.br
+\fB-selectforeground\fP
+.PP
+See the \fBttk::style\fP manual page for information on how to configure
+ttk styles.
.SH "SEE ALSO"
ttk::widget(n), entry(n)
.SH KEYWORDS
diff --git a/doc/ttk_frame.n b/doc/ttk_frame.n
index d2bd745..b292bf6 100644
--- a/doc/ttk_frame.n
+++ b/doc/ttk_frame.n
@@ -45,6 +45,19 @@ by the GM's requested size will normally take precedence
over the \fBframe\fR widget's \fB\-width\fR and \fB\-height\fR options.
\fBpack propagate\fR and \fBgrid propagate\fR can be used
to change this.
+.SH "STYLING OPTIONS"
+.PP
+The class name for a \fBttk::frame\fP is \fBTFrame\fP.
+.PP
+\fBTFrame\fP styling options configurable with \fBttk::style\fP
+are:
+.PP
+\fB-background\fP
+.PP
+Some options are only available for specific themes.
+.PP
+See the \fBttk::style\fP manual page for information on how to configure
+ttk styles.
.SH "SEE ALSO"
ttk::widget(n), ttk::labelframe(n), frame(n)
.SH "KEYWORDS"
diff --git a/doc/ttk_separator.n b/doc/ttk_separator.n
index e1821b6..d35c390 100644
--- a/doc/ttk_separator.n
+++ b/doc/ttk_separator.n
@@ -30,6 +30,19 @@ Separator widgets support the standard
\fBcget\fR, \fBconfigure\fR, \fBidentify\fR, \fBinstate\fR, and \fBstate\fR
methods. No other widget methods are used.
.PP
+.SH "STYLING OPTIONS"
+.PP
+The class name for a \fBttk::frame\fP is \fBTSeparator\fP.
+.PP
+\fBTSeparator\fP styling options configurable with \fBttk::style\fP
+are:
+.PP
+\fB-background\fP
+.PP
+Some options are only available for specific themes.
+.PP
+See the \fBttk::style\fP manual page for information on how to configure
+ttk styles.
.SH "SEE ALSO"
ttk::widget(n)
.SH "KEYWORDS"
diff --git a/doc/ttk_sizegrip.n b/doc/ttk_sizegrip.n
index 1c75eb8..0a5e46b 100644
--- a/doc/ttk_sizegrip.n
+++ b/doc/ttk_sizegrip.n
@@ -3,7 +3,7 @@
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\"
+'\"
.TH ttk::sizegrip n 8.5 Tk "Tk Themed Widget"
.so man.macros
.BS
@@ -60,6 +60,19 @@ the sizegrip widget will not resize the window.
\fBttk::sizegrip\fR widgets only support
.QW southeast
resizing.
+.SH "STYLING OPTIONS"
+.PP
+The class name for a \fBttk::frame\fP is \fBTSizegrip\fP.
+.PP
+\fBTSizegrip\fP styling options configurable with \fBttk::style\fP
+are:
+.PP
+\fB-background\fP
+.PP
+Some options are only available for specific themes.
+.PP
+See the \fBttk::style\fP manual page for information on how to configure
+ttk styles.
.SH "SEE ALSO"
ttk::widget(n)
.SH "KEYWORDS"
diff --git a/doc/ttk_spinbox.n b/doc/ttk_spinbox.n
index b55d12e..ec23f1b 100644
--- a/doc/ttk_spinbox.n
+++ b/doc/ttk_spinbox.n
@@ -80,6 +80,49 @@ is set directly.
The spinbox widget generates a \fB<<Increment>>\fR virtual event when
the user presses <Up>, and a \fB<<Decrement>>\fR virtual event when the
user presses <Down>.
+.SH "STYLING OPTIONS"
+.PP
+The class name for a \fBttk::button\fP is \fBTSpinbox\fP.
+.PP
+Dynamic states: active, focus, disabled, readonly
+.PP
+\fBTSpinbox\fP styling options configurable with \fBttk::style\fP
+are:
+.PP
+\fB-arrowcolor\fP
+.br
+\fB-arrowsize\fP
+.br
+\fB-background\fP
+.br
+.RS
+When using the aqua theme (Mac OS X), changes the -fieldbackground.
+.RE
+.br
+\fB-bordercolor\fP
+.br
+\fB-darkcolor\fP
+.br
+\fB-fieldbackground\fP
+.br
+.RS
+Does not work with the aqua theme (Mac OS X).
+.RE
+.br
+\fB-foreground\fP
+.br
+\fB-lightcolor\fP
+.br
+\fB-padding\fP
+.br
+\fB-selectbackground\fP
+.br
+\fB-selectforeground\fP
+.PP
+Some options are only available for specific themes.
+.PP
+See the \fBttk::style\fP manual page for information on how to configure
+ttk styles.
.SH "SEE ALSO"
ttk::widget(n), ttk::entry(n), spinbox(n)
.SH KEYWORDS