home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _4dba99194cf6cc1884553796131f1329 < prev    next >
Text File  |  2000-03-23  |  5KB  |  119 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>bisque - Modify the Tk color palette</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> bisque - Modify the Tk color palette</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#bugs">BUGS</A></LI>
  26.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  27.     <LI><A HREF="#keywords">KEYWORDS</A></LI>
  28. </UL>
  29. <!-- INDEX END -->
  30.  
  31. <HR>
  32. <P>
  33. <H1><A NAME="name">NAME</A></H1>
  34. <P>setPalette, bisque - Modify the Tk color palette</P>
  35. <P>
  36. <HR>
  37. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  38. <UL>
  39. <LI>Linux</LI>
  40. <LI>Solaris</LI>
  41. <LI>Windows</LI>
  42. </UL>
  43. <HR>
  44. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  45. <P><EM>$widget</EM>-><STRONG>setPalette</STRONG>(<EM>background</EM>)</P>
  46. <P><EM>$widget</EM>-><STRONG>setPalette(</STRONG><EM>name</EM>=><EM>value</EM>?,<EM>name</EM>=><EM>value ...</EM>?)</P>
  47. <P><EM>$widget</EM>-><STRONG>bisque</STRONG></P>
  48. <P>
  49. <HR>
  50. <H1><A NAME="description">DESCRIPTION</A></H1>
  51. <P>The <STRONG>setPalette</STRONG> method changes the color scheme for Tk.
  52. It does this by modifying the colors of existing widgets and by changing
  53. the option database so that future widgets will use the new color scheme.
  54. If <STRONG>setPalette</STRONG> is invoked with a single argument, the
  55. argument is the name of a color to use as the normal background
  56. color;  <STRONG>setPalette</STRONG> will compute a complete color palette
  57. from this background color.
  58. Alternatively, the arguments to <STRONG>setPalette</STRONG> may consist of any number
  59. of <EM>name</EM>-<EM>value</EM> pairs, where the first argument of the pair
  60. is the name of an option in the Tk option database and the second
  61. argument is the new value to use for that option.  The following
  62. database names are currently supported:</P>
  63. <PRE>
  64.  activeBackground       foreground      selectColor
  65.  activeForeground       highlightBackground     selectBackground
  66.  background     highlightColor  selectForeground
  67.  disabledForeground     insertBackground        troughColor</PRE>
  68. <P><STRONG>setPalette</STRONG> tries to compute reasonable defaults for any
  69. options that you don't specify.  You can specify options other
  70. than the above ones and Tk will change those options on widgets as
  71. well.  This feature may be useful if you are using custom widgets with
  72. additional color options.</P>
  73. <P>Once it has computed the new value to use for each of the color options,
  74. <STRONG>setPalette</STRONG> scans the widget hierarchy to modify the options
  75. of all existing widgets.  For each widget, it checks to see if any
  76. of the above options is defined for the widget.  If so, and if the
  77. option's current value is the default, then the value is changed;  if
  78. the option has a value other than the default, <STRONG>setPalette</STRONG>
  79. will not change it.  The default for an option is the one provided by
  80. the widget (<STRONG>($w->configure('option'))[3]</STRONG>) unless
  81. <STRONG>setPalette</STRONG> has been run previously, in which case it is the
  82. value specified in the previous invocation of <STRONG>setPalette</STRONG>.</P>
  83. <P>After modifying all the widgets in the application, <STRONG>setPalette</STRONG>
  84. adds options to the option database to change the defaults for
  85. widgets created in the future.  The new options are added at
  86. priority <STRONG>widgetDefault</STRONG>, so they will be overridden by options
  87. from the .Xdefaults file or options specified on the command-line
  88. that creates a widget.</P>
  89. <P>The method <STRONG>bisque</STRONG> is provided for backward compatibility:
  90. it restores the application's colors to the light brown (``bisque'')
  91. color scheme used in Tk 3.6 and earlier versions.</P>
  92. <P>
  93. <HR>
  94. <H1><A NAME="bugs">BUGS</A></H1>
  95. <P>The use of option database names rather than the configure names is
  96. understandable given the mechanism (copied from Tcl/Tk), but
  97. is potentially confusing.</P>
  98. <P>The interpolation of different 'shades' of color used for 3D effects
  99. in 'RGB' space can lead to undesirable changes in 'hue'.
  100. Interpolation in 'HSV' (as used in <STRONG>Tk::ColorEditor</STRONG>) would be more
  101. robust and X11R5's color support probably even more so.</P>
  102. <P>
  103. <HR>
  104. <H1><A NAME="see also">SEE ALSO</A></H1>
  105. <P><A HREF="../../../site/lib/Tk/options.html">Tk::options</A></P>
  106. <P>
  107. <HR>
  108. <H1><A NAME="keywords">KEYWORDS</A></H1>
  109. <P>bisque, color, palette</P>
  110. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  111. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  112. <STRONG><P CLASS=block> bisque - Modify the Tk color palette</P></STRONG>
  113. </TD></TR>
  114. </TABLE>
  115.  
  116. </BODY>
  117.  
  118. </HTML>
  119.