tk_setPalette (n)
Modify the Tk color palette
SYNOPSIS
tk_setPalette background
tk_setPalette name value ?name value ...?
tk_bisque
DESCRIPTION
The tk_setPalette 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 tk_setPalette is invoked with a single argument, the
argument is the name of a color to use as the normal background
color; tk_setPalette will compute a complete color palette
from this background color.
Alternatively, the arguments to tk_setPalette may consist of any number
of name-value 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:
L
4c 8c
activeBackground foreground selectColor
activeForeground highlightBackground selectBackground
background highlightColor selectForeground
disabledForeground insertBackground troughColor
tk_setPalette 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.
Once it has computed the new value to use for each of the color options,
tk_setPalette 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, tk_setPalette
will not change it. The default for an option is the one provided by
the widget ([lindex [$w configure $option] 3]) unless
tk_setPalette has been run previously, in which case it is the
value specified in the previous invocation of tk_setPalette.
After modifying all the widgets in the application, tk_setPalette
adds options to the option database to change the defaults for
widgets created in the future. The new options are added at
priority widgetDefault, so they will be overridden by options
from the .Xdefaults file or options specified on the command-line
that creates a widget.
The procedure tk_bisque 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.
KEYWORDS
bisque, color, palette
'\"
'\" Copyright (c) 1996, Expert Interface Technologies
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
'\" The definitions below are for supplemental macros used in Tix
'\" manual entries.
'\"
'\" .HS name section [date [version]]
'\" Replacement for .TH in other man pages. See below for valid
'\" section names.
'\"
'\" .AP type name in/out [indent]
'\" Start paragraph describing an argument to a library procedure.
'\" type is type of argument (int, etc.), in/out is either "in", "out",
'\" or "in/out" to describe whether procedure reads or modifies arg,
'\" and indent is equivalent to second arg of .IP (shouldn't ever be
'\" needed; use .AS below instead)
'\"
'\" .AS [type [name]]
'\" Give maximum sizes of arguments for setting tab stops. Type and
'\" name are examples of largest possible arguments that will be passed
'\" to .AP later. If args are omitted, default tab stops are used.
'\"
'\" .BS
'\" Start box enclosure. From here until next .BE, everything will be
'\" enclosed in one large box.
'\"
'\" .BE
'\" End of box enclosure.
'\"
'\" .VS
'\" Begin vertical sidebar, for use in marking newly-changed parts
'\" of man pages.
'\"
'\" .VE
'\" End of vertical sidebar.
'\"
'\" .DS
'\" Begin an indented unfilled display.
'\"
'\" .DE
'\" End of indented unfilled display.
'\"
|
|