


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               foregroundse-
       lectColor activeForeground               highlightBackgroundselectBack-
       ground                  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 widgetDe-
       fault, 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                              1


