head	1.10;
access;
symbols
	core-8-5-9:1.8
	core-8-5-8:1.8
	macosx-cocoa-merge:1.10
	macosx-cocoa-premerge:1.10
	macosx-carbon-freeze:1.10
	core-8-5-7:1.8
	core-8-5-6:1.8
	core-8-6-b1:1.10
	core-8-6-a3:1.10
	core-8-5-5:1.8
	core-8-6-a2:1.9
	core-8-5-4:1.8
	core-8-5-3:1.8
	core-8-6-a1:1.8
	core-8-4-19:1.2
	core-8-5-branch:1.8.0.2
	core-8-5-2:1.8
	core-8-4-18:1.2
	core-8-5-1:1.8
	core-8-4-17:1.2
	core-8-5-0:1.8
	core-8-5-b3:1.6
	core-8-5-b2:1.4
	core-8-4-16:1.2
	core-8-5-b1:1.2
	core-stablilizer-merge:1.2
	core-stabilizer-branch:1.2.0.32
	core-stabilizer-merge:1.8
	core-8-4-15:1.2
	core-8-5-a6:1.2
	core-8-5-a5:1.2
	core-8-4-14:1.2
	core-8-5-a4:1.2
	core-8-4-13:1.2
	core-8-4-12:1.2
	core-8-4-11:1.2
	core-8-5-a3:1.2
	core-8-4-10:1.2
	core-8-4-9-branch:1.2.0.30
	core-8-5-a2:1.2
	core-8-4-9:1.2
	core-8-4-8:1.2
	core-8-4-7:1.2
	core-8-5-a1:1.2
	core-8-4-6:1.2
	core-8-4-5:1.2
	mistachkin-dev-branch:1.2.0.28
	core-8-4-4:1.2
	core-8-4-3:1.2
	core-8-4-branch:1.2.0.26
	core-8-4-2:1.2
	core-8-4-1:1.2
	core-8-3-5:1.2
	core-8-4-0:1.2
	macosx-8-4-merge-2002-08-31-trunk:1.2
	macosx-8-4-premerge-2002-08-31-branch:1.2
	macosx-8-4-premerge-2002-08-31-trunk:1.2
	macosx-8-4-merge-2002-08-30-branch:1.2
	macosx-8-4-merge-2002-08-30-trunk:1.2
	macosx-8-4-merge-2002-08-20-branch:1.2
	macosx-8-4-merge-2002-08-20-trunk:1.2
	core-8-4-b2:1.2
	core-8-4-b1:1.2
	macosx-premerge-6-9-02:1.2
	core-8-4-a4:1.2
	core-8-3-4:1.2
	macosx-8-4-branch:1.2.0.24
	macosx-8-4-branchpoint:1.2
	core-8-4-a3:1.2
	core-8-3-3:1.2
	dgp-privates-into-namespace:1.2.0.22
	tclpro-1-5-0:1.2
	core-8-4-win-speedup:1.2.0.20
	core-8-4-a2:1.2
	tclpro-1-4-1:1.2
	tclpro-1-4-0:1.2
	core-8-3-2:1.2
	ajuba-ajuba2-2-1-base:1.2
	ajuba-ajuba2-2-0:1.2
	core-8-4-a1:1.2
	core-8-3-1-branch:1.2.0.18
	core-8-3-1:1.2
	scriptics-sc-2-0-b5:1.2
	scriptics-sc-2-0-fixed:1.2
	scriptics-sc-2-0-b2:1.2
	scriptics-sc-2-0-b1:1.2
	core-8-3-0:1.2
	core-8-3-b2:1.2
	core-8-3-b1:1.2
	scriptics-sc-1-1:1.2
	scriptics-sc-1-1-b1:1.2
	core-8-2-3:1.2
	scriptics-sc-1-1-branch:1.2.0.16
	scriptics-sc-1-1-base:1.2
	scriptics-sc-1-0:1.2
	scriptics-sc-1-0-branch:1.2.0.14
	scriptics-sc-1-0-base:1.2
	core-8-2-2:1.2
	core-8-2-1:1.2
	scriptics-bc-1-0-b1:1.2
	core-8-2-1-branch:1.2.0.12
	scriptics-tclpro-1-3-0:1.2
	core-8-2-0:1.2
	core-8-2-b3-branch:1.2.0.10
	core-8-2-b3-base:1.2
	scriptics-tclpro-1-3-b4:1.2
	core-8-2-b2:1.2
	scriptics-tclpro-1-3-b3:1.2
	core-8-2-b1:1.2
	scriptics-tclpro-1-3-b2:1.2
	merge-to-mainline-5/21/99:1.2
	scriptics-tclpro-1-3-b2-branch:1.2.0.8
	core-8-1-1:1.2
	scriptics-tclpro-1-3-b1:1.2
	core-8-1-1-base:1.2
	core-8-1-0:1.2
	merge-to-mainline-4-29-99:1.2
	merge-to-mainline-4-23-99:1.2
	core-8-1-branch-old:1.1.0.4
	core-8-0-6-branch:1.2.0.6
	core-8-0-6-base:1.2
	core-8-0-5:1.2
	core-8-1-b3:1.1.4.1
	core-8-1-b2:1.1.4.1
	dev-8-1-stubs-branch:1.1.4.1.0.2
	dev-stubs-branch:1.2.0.4
	scriptics-tclpro-1-2:1.2
	scriptics-tclpro-1-2-b2:1.2
	core-8-1-merge-2/10/99:1.2
	core-8-0-5-branch:1.2.0.2
	core-8-0-5-base:1.2
	scriptics-tclpro-1-2-b1:1.2
	scriptics-tclpro-1-2-a1:1.2
	core-8-1-b1:1.1.4.1
	core-8-0-4:1.2
	core-8-1-a2:1.1
	core-8-0-2:1.1
	core-8-0-3:1.2;
locks; strict;
comment	@# @;


1.10
date	2008.09.23.13.36.45;	author dkf;	state Exp;
branches;
next	1.9;

1.9
date	2008.06.30.22.57.03;	author dkf;	state Exp;
branches;
next	1.8;

1.8
date	2007.12.13.15.23.43;	author dgp;	state Exp;
branches;
next	1.7;

1.7
date	2007.12.10.16.21.48;	author jenglish;	state Exp;
branches;
next	1.6;

1.6
date	2007.11.01.23.03.54;	author dkf;	state Exp;
branches;
next	1.5;

1.5
date	2007.10.29.16.04.14;	author dkf;	state Exp;
branches;
next	1.4;

1.4
date	2007.10.26.20.13.23;	author dgp;	state Exp;
branches;
next	1.3;

1.3
date	2007.10.24.14.32.58;	author dkf;	state Exp;
branches;
next	1.2;

1.2
date	98.09.14.18.22.58;	author stanton;	state Exp;
branches
	1.2.32.1;
next	1.1;

1.1
date	98.04.01.09.39.55;	author rjohnson;	state Exp;
branches
	1.1.4.1;
next	;

1.1.4.1
date	98.09.30.02.16.25;	author stanton;	state Exp;
branches;
next	;

1.2.32.1
date	2007.11.01.16.37.15;	author dgp;	state Exp;
branches;
next	1.2.32.2;

1.2.32.2
date	2007.11.02.14.51.39;	author dgp;	state Exp;
branches;
next	1.2.32.3;

1.2.32.3
date	2007.12.10.18.39.28;	author dgp;	state Exp;
branches;
next	;


desc
@@


1.10
log
@Fix [Bug 2118116]
@
text
@'\"
'\" Copyright (c) 1995-1996 Sun Microsystems, Inc.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\" 
'\" RCS: @@(#) $Id: palette.n,v 1.9 2008/06/30 22:57:03 dkf Exp $
'\" 
.so man.macros
.TH tk_setPalette n 4.0 Tk "Tk Built-In Commands"
.BS
'\" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
tk_setPalette, tk_bisque \- Modify the Tk color palette
.SH SYNOPSIS
\fBtk_setPalette \fIbackground\fR
.sp
\fBtk_setPalette \fIname value \fR?\fIname value ...\fR?
.sp
\fBtk_bisque\fR
.BE
.SH DESCRIPTION
.PP
The \fBtk_setPalette\fR 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 \fBtk_setPalette\fR is invoked with a single argument, the
argument is the name of a color to use as the normal background
color;  \fBtk_setPalette\fR will compute a complete color palette
from this background color.
Alternatively, the arguments to \fBtk_setPalette\fR may consist of any number
of \fIname\fR\-\fIvalue\fR 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:
.DS
.ta 4c 8c
\fBactiveBackground\fR	\fBforeground\fR	\fBselectColor\fR
\fBactiveForeground\fR	\fBhighlightBackground\fR	\fBselectBackground\fR
\fBbackground\fR	\fBhighlightColor\fR	\fBselectForeground\fR
\fBdisabledForeground\fR	\fBinsertBackground\fR	\fBtroughColor\fR
.DE
\fBtk_setPalette\fR 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.
.PP
Once it has computed the new value to use for each of the color options,
\fBtk_setPalette\fR 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, \fBtk_setPalette\fR
will not change it.  The default for an option is the one provided by
the widget (\fB[lindex [$w configure $option] 3]\fR) unless
\fBtk_setPalette\fR has been run previously, in which case it is the
value specified in the previous invocation of \fBtk_setPalette\fR.
.PP
After modifying all the widgets in the application, \fBtk_setPalette\fR
adds options to the option database to change the defaults for
widgets created in the future.  The new options are added at
priority \fBwidgetDefault\fR, so they will be overridden by options
from the .Xdefaults file or options specified on the command-line
that creates a widget.
.PP
The procedure \fBtk_bisque\fR is provided for backward compatibility:
it restores the application's colors to the light brown
.PQ bisque
color scheme used in Tk 3.6 and earlier versions.
.SH KEYWORDS
bisque, color, palette
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.9
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.8 2007/12/13 15:23:43 dgp Exp $
d73 3
@


1.8
log
@merge stable branch onto HEAD
@
text
@d1 1
d8 1
a8 1
'\" RCS: @@(#) $Id: palette.n,v 1.2.32.3 2007/12/10 18:39:28 dgp Exp $
a22 1

a71 1

@


1.7
log
@Various markup fixes
(mostly: missing quotes on .SH arguments, extraneous .PPs)
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.6 2007/11/01 23:03:54 dkf Exp $
@


1.6
log
@Fix .DS/.DE to work better when transformed to a table
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.5 2007/10/29 16:04:14 dkf Exp $
d37 1
a37 1
.DS L
@


1.5
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.4 2007/10/26 20:13:23 dgp Exp $
d39 4
a42 4
\fBactiveBackground	foreground	selectColor
activeForeground	highlightBackground	selectBackground
background	highlightColor	selectForeground
disabledForeground	insertBackground	troughColor\fR
@


1.4
log
@        * doc/*.1:              Revert doc changes that broke
        * doc/*.3:              `make html` so we can get the release
        * doc/*.n:              out the door.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.2 1998/09/14 18:22:58 stanton Exp $
d45 1
a45 1
options that you don't specify.  You can specify options other
d69 2
a70 1
it restores the application's colors to the light brown (``bisque'')
@


1.3
log
@Lots of improvements to look and feel of manual pages
@
text
@d69 1
a69 2
it restores the application's colors to the light brown
.PQ bisque
@


1.2
log
@Replaced SCCS strings, fixed binary files
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id$
d69 2
a70 1
it restores the application's colors to the light brown (``bisque'')
@


1.2.32.1
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.2 1998/09/14 18:22:58 stanton Exp $
d45 1
a45 1
options that you do not specify.  You can specify options other
d69 1
a69 2
it restores the application's colors to the light brown
.PQ bisque
@


1.2.32.2
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.2.32.1 2007/11/01 16:37:15 dgp Exp $
d39 4
a42 4
\fBactiveBackground\fR	\fBforeground\fR	\fBselectColor\fR
\fBactiveForeground\fR	\fBhighlightBackground\fR	\fBselectBackground\fR
\fBbackground\fR	\fBhighlightColor\fR	\fBselectForeground\fR
\fBdisabledForeground\fR	\fBinsertBackground\fR	\fBtroughColor\fR
@


1.2.32.3
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.2.32.2 2007/11/02 14:51:39 dgp Exp $
d37 1
a37 1
.DS
@


1.1
log
@Initial revision
@
text
@d7 1
a7 1
'\" SCCS: @@(#) palette.n 1.5 96/03/26 18:26:11
@


1.1.4.1
log
@Merged 8.0.3 changes into 8.1
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: palette.n,v 1.2 1998/09/14 18:22:58 stanton Exp $
@


