Tk:set-palette!(n)           Tk Built-In Commands           Tk:set-palette!(n)



NAME
       Tk:set-palette!, Tk:bisque - Modify the Tk color palette

SYNOPSIS
       (Tk:set-palette! background)

       (Tk:set-palette! name value ?name value ...?)

       (Tk:bisque)


DESCRIPTION
       The Tk:set-palette! 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:set-palette! is invoked with a single argument, the argument is
       the name of a color to use as the normal background color;  Tk:set-
       palette! will compute a complete color palette from this background
       color.  Alternatively, the arguments to Tk:set-palette! 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:
       activeBackground               foregroundselectColor
       activeForeground               highlightBackgroundselectBackground
       background      highlightColor selectForeground
       disabledForeground             insertBackgroundtroughColor Tk:set-
       palette! 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:set-palette! 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:set-palette!  will
       not change it.  The default for an option is the one provided by the
       widget (list-ref (w 'configure option) 3) unless Tk:set-palette! has
       been run previously, in which case it is the value specified in the
       previous invocation of Tk:set-palette!.

       After modifying all the widgets in the application, Tk:set-palette!
       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.




STk                                   3.1                   Tk:set-palette!(n)
