58 lines
3.1 KiB
HTML
58 lines
3.1 KiB
HTML
<HTML><HEAD><TITLE>Tk Built-In Commands - Tk:set-palette! manual page</TITLE></HEAD>
|
|
<BR>
|
|
<BODY bgcolor = #c3ffc3>
|
|
<H2><IMG ALIGN=BOTTOM SRC="./Img/ManPageGreen.gif"> Tk:set-palette!, Tk:bisque</H2>
|
|
<I>Modify the Tk color palette</I><P><IMG ALIGN=TOP SRC="./Img/line-red.gif">
|
|
<H3><A NAME="M2">SYNOPSIS</A></H3>
|
|
(<B>Tk:set-palette! </B><I>background</I>)<BR>
|
|
(<B>Tk:set-palette! </B><I>name value </I>?<I>name value ...</I>?)<BR>
|
|
(<B>Tk:bisque</B>)<BR>
|
|
<H3><A NAME="M3">DESCRIPTION</A></H3>
|
|
The <B>Tk:set-palette!</B> procedure changes the color scheme for Tk.
|
|
It does this by modifying the colors of existing widgets and by changing
|
|
the option database so that future widgets will use the new color scheme.
|
|
If <B>Tk:set-palette!</B> is invoked with a single argument, the
|
|
argument is the name of a color to use as the normal background
|
|
color; <B>Tk:set-palette!</B> will compute a complete color palette
|
|
from this background color.
|
|
Alternatively, the arguments to <B>Tk:set-palette!</B> may consist of any number
|
|
of <I>name</I>-<I>value</I> pairs, where the first argument of the pair
|
|
is the name of an option in the Tk option database and the second
|
|
argument is the new value to use for that option. The following
|
|
database names are currently supported:
|
|
<PRE><B>activeBackground foreground selectColor
|
|
activeForeground highlightBackground selectBackground
|
|
background highlightColor selectForeground
|
|
disabledForeground insertBackground troughColor</B></PRE>
|
|
<B>Tk:set-palette!</B> tries to compute reasonable defaults for any
|
|
options that you don't specify. You can specify options other
|
|
than the above ones and Tk will change those options on widgets as
|
|
well. This feature may be useful if you are using custom widgets with
|
|
additional color options.
|
|
<P>
|
|
Once it has computed the new value to use for each of the color options,
|
|
<B>Tk:set-palette!</B> scans the widget hierarchy to modify the options
|
|
of all existing widgets. For each widget, it checks to see if any
|
|
of the above options is defined for the widget. If so, and if the
|
|
option's current value is the default, then the value is changed; if
|
|
the option has a value other than the default, <B>Tk:set-palette!</B>
|
|
will not change it. The default for an option is the one provided by
|
|
the widget <B>(list-ref (w 'configure option) 3)</B> unless
|
|
<B>Tk:set-palette!</B> has been run previously, in which case it is the
|
|
value specified in the previous invocation of <B>Tk:set-palette!</B>.
|
|
<P>
|
|
After modifying all the widgets in the application, <B>Tk:set-palette!</B>
|
|
adds options to the option database to change the defaults for
|
|
widgets created in the future. The new options are added at
|
|
priority <B>widgetDefault</B>, so they will be overridden by options
|
|
from the .Xdefaults file or options specified on the command-line
|
|
that creates a widget.
|
|
<P>
|
|
The procedure <B>Tk:bisque</B> is provided for backward compatibility:
|
|
it restores the application's colors to the light brown (``bisque'')
|
|
color scheme used in Tk 3.6 and earlier versions.
|
|
|
|
<P><IMG ALIGN=TOP SRC="./Img/line-red.gif"><P>
|
|
<A HREF=./STk-hlp.html><IMG ALIGN=BOTTOM SRC="./Img/RefBookGreen.gif"> Back to the <B>STk</B> main page</A>
|
|
</BODY></HTML>
|