home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _db6856877f70383c12fc3770e57e1ba7 < prev    next >
Text File  |  2000-03-23  |  4KB  |  96 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>chooseColor - pops up a dialog box for the user to select a color.</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> chooseColor - pops up a dialog box for the user to select a color.</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="#example">EXAMPLE</A></LI>
  26.     <LI><A HREF="#keywords">KEYWORDS</A></LI>
  27. </UL>
  28. <!-- INDEX END -->
  29.  
  30. <HR>
  31. <P>
  32. <H1><A NAME="name">NAME</A></H1>
  33. <P>chooseColor - pops up a dialog box for the user to select a color.</P>
  34. <P>
  35. <HR>
  36. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  37. <UL>
  38. <LI>Linux</LI>
  39. <LI>Solaris</LI>
  40. <LI>Windows</LI>
  41. </UL>
  42. <HR>
  43. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  44. <P>    <EM>$color</EM> = <EM>$widget</EM>-><STRONG>chooseColor</STRONG>?(<EM>-option</EM>=><EM>value</EM>, ...)?;</P>
  45. <P>
  46. <HR>
  47. <H1><A NAME="description">DESCRIPTION</A></H1>
  48. <P>The method <STRONG>chooseColor</STRONG> is implemented as a perl wrapper
  49. on the core tk ``command'' <STRONG>tk_chooseColor</STRONG>. The <EM>$widget</EM>
  50. is passed as the argument to <STRONG>-parent</STRONG> described below.
  51. The implementation of internal <STRONG>tk_chooseColor</STRONG> is platform
  52. specific, on Win32 it is a native dialog, and on UNIX/X it is implemented
  53. in terms of <A HREF="../../../site/lib/Tk/ColorEditor.html">Tk::ColorEditor</A>.</P>
  54. <P>The core tk command <STRONG>tk_chooseColor</STRONG> pops up a dialog box for the
  55. user to select a color. The following <EM>option-value</EM> pairs are
  56. possible as command line arguments:</P>
  57. <DL>
  58. <DT><STRONG><A NAME="item_%2Dinitialcolor%3D%3Ecolor"><STRONG>-initialcolor</STRONG>=><EM>color</EM></A></STRONG><BR>
  59. <DD>
  60. Specifies the color to display in the color dialog when it pops
  61. up. <EM>color</EM> must be in a form acceptable to the <STRONG>Tk_GetColor</STRONG>
  62. function.
  63. <P></P>
  64. <DT><STRONG><A NAME="item_%2Dparent%3D%3E%24widget"><STRONG>-parent</STRONG>=>$widget</A></STRONG><BR>
  65. <DD>
  66. Makes $widget the logical parent of the color dialog. The color
  67. dialog is displayed on top of its parent window.
  68. <P></P>
  69. <DT><STRONG><A NAME="item_%2Dtitle%3D%3EtitleString"><STRONG>-title</STRONG>=><EM>titleString</EM></A></STRONG><BR>
  70. <DD>
  71. Specifies a string to display as the title of the dialog box. If this
  72. option is not specified, then a default title will be displayed.
  73. <P></P></DL>
  74. <P>If the user selects a color, <STRONG>tk_chooseColor</STRONG> will return the
  75. name of the color in a form acceptable to <STRONG>Tk_GetColor</STRONG>.  If the
  76. user cancels the operation, the command will return <STRONG>undef</STRONG>.</P>
  77. <P>
  78. <HR>
  79. <H1><A NAME="example">EXAMPLE</A></H1>
  80. <PRE>
  81.  $widget->configure(-fg => $parent->chooseColor(-initialcolor => 'gray',
  82.                  -title => "Choose color"));</PRE>
  83. <P>
  84. <HR>
  85. <H1><A NAME="keywords">KEYWORDS</A></H1>
  86. <P>color selection dialog</P>
  87. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  88. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  89. <STRONG><P CLASS=block> chooseColor - pops up a dialog box for the user to select a color.</P></STRONG>
  90. </TD></TR>
  91. </TABLE>
  92.  
  93. </BODY>
  94.  
  95. </HTML>
  96.