1mNAME0m
       tk_setPalette, tk_bisque - Modify the Tk color palette

1mSYNOPSIS0m
       1mtk_setPalette 4m22mbackground0m

       1mtk_setPalette 4m22mname24m 4mvalue24m ?4mname24m 4mvalue24m 4m...24m?

       1mtk_bisque0m


1mDESCRIPTION0m
       The  1mtk_setPalette  22mprocedure 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 1mtk_setPalette 22mis invoked with a single argument, the argument is the
       name  of  a color to use as the normal background color;  1mtk_setPalette0m
       will compute a complete  color  palette  from  this  background  color.
       Alternatively, the arguments to 1mtk_setPalette 22mmay consist of any number
       of 4mname24m-4mvalue24m 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:

              1mactiveBackground               foregroundselectColor0m
              1mactiveForeground               highlightBackgroundselectBackground0m
              1mbackground      highlightColor selectForeground0m
              1mdisabledForeground             insertBackgroundtroughColor0m

       1mtk_setPalette 22mtries 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, 1mtk_setPalette 22mscans 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, 1mtk_setPalette  22mwill  not
       change it.  The default for an option is the one provided by the widget
       (1m[lindex [$w configure $option] 3]22m) unless 1mtk_setPalette 22mhas  been  run
       previously,  in  which  case  it is the value specified in the previous
       invocation of 1mtk_setPalette22m.

       After modifying all the widgets in the application, 1mtk_setPalette  22madds
       options  to the option database to change the defaults for widgets cre-
       ated in the future.  The new options are added  at  priority  1mwidgetDe-0m
       1mfault22m,  so  they will be overridden by options from the .Xdefaults file
       or options specified on the command-line that creates a widget.

       The procedure 1mtk_bisque 22mis  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.


1mKEYWORDS0m
