manpagez: man pages & more
man palette(n)
Home | html | info | man
palette(n)             Tk Built-In Commands             palette(n)




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 compute 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  supported:  activeBackground               foregroundselect-
       Color     activeForeground               highlightBackgroundselectBack-
       ground   background      highlightColor selectForeground  disabledFore-
       ground             insertBackgroundtroughColor tk_setPalette  tries  to
       compute  reasonable  defaults  for any options that you do not 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  cre-
       ated  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 color scheme  used
       in Tk 3.6 and earlier versions.


KEYWORDS

       bisque, color, palette



Tk                                    4.0                     palette(n)

tk 8.6.0 - Generated Mon Jan 21 08:24:22 CST 2013
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.