Tk Built-In Commands                            tksetPalette(1T)





NAME
     tksetPalette, tkbisque - Modify the Tk color palette

SYNOPSIS
     tksetPalette background

     tksetPalette name value ?name value ...?

     tkbisque



DESCRIPTION
     The tksetPalette 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 tksetPalette is invoked with
     a single argument, the argument is the name of  a  color  to
     use as the normal background color;  tksetPalette will com-
     pute a complete color palette from  this  background  color.
     Alternatively, the arguments to tksetPalette 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

     tksetPalette 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,  tksetPalette 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,  tksetPalette
     will  not  change  it.  The default for an option is the one
     provided by the widget ([lindex [$w configure  $option]  3])
     unless  tksetPalette has been run previously, in which case
     it is the value specified  in  the  previous  invocation  of
     tksetPalette.



Tk                      Last change: 4.0                        1






Tk Built-In Commands                            tksetPalette(1T)



     After  modifying  all  the  widgets  in   the   application,
     tksetPalette  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 tkbisque 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

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTk         
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for Tk is available on http:/opensolaris.org.

























Tk                      Last change: 4.0                        2