tk4.2 User Commands - palette






NAME

     tk_setPalette, tk_bisque - 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 com-
     pute 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 sup-
     ported:

          activeBackground               foregroundselectColor
          activeForeground               highlightBackgroundselectBackground
          background      highlightColor selectForeground
          disabledForeground             insertBackgroundtroughColor

     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 compatibil-
     ity:   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