home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _9515d1581a7b426ee13fafd2e6dca01c < prev    next >
Text File  |  2000-03-23  |  5KB  |  142 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Tk::ProgressBar - A graphical progress bar</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> Tk::ProgressBar - A graphical progress bar</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="#standard options">STANDARD OPTIONS</A></LI>
  26.     <LI><A HREF="#widgetspecific options">WIDGET-SPECIFIC OPTIONS</A></LI>
  27.     <LI><A HREF="#widget methods">WIDGET METHODS</A></LI>
  28.     <LI><A HREF="#author">AUTHOR</A></LI>
  29.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  30. </UL>
  31. <!-- INDEX END -->
  32.  
  33. <HR>
  34. <P>
  35. <H1><A NAME="name">NAME</A></H1>
  36. <P>Tk::ProgressBar - A graphical progress bar</P>
  37. <P>
  38. <HR>
  39. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  40. <UL>
  41. <LI>Linux</LI>
  42. <LI>Solaris</LI>
  43. <LI>Windows</LI>
  44. </UL>
  45. <HR>
  46. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  47. <PRE>
  48.     use Tk::ProgressBar;
  49. </PRE>
  50. <PRE>
  51.  
  52.     $progress = $parent->ProgressBar(
  53.         -width => 200,
  54.         -height => 20,
  55.         -from => 0,
  56.         -to => 100,
  57.         -blocks => 10,
  58.         -colors => [0, 'green', 50, 'yellow' , 80, 'red'],
  59.         -variable => \$percent_done
  60.     );</PRE>
  61. <P>
  62. <HR>
  63. <H1><A NAME="description">DESCRIPTION</A></H1>
  64. <P><STRONG>Tk::ProgressBar</STRONG> provides a widget which will show a graphical representation
  65. of a value, given maximum and minimum reference values.</P>
  66. <P>
  67. <HR>
  68. <H1><A NAME="standard options">STANDARD OPTIONS</A></H1>
  69. <P><STRONG>-padx -pady -troughcolor -highlightthickness -borderwidth -relief</STRONG></P>
  70. <P>
  71. <HR>
  72. <H1><A NAME="widgetspecific options">WIDGET-SPECIFIC OPTIONS</A></H1>
  73. <DL>
  74. <DT><STRONG><A NAME="item_%2Dwidth">-width</A></STRONG><BR>
  75. <DD>
  76. Specifies the desired narrow dimension of the ProgressBar in screen units (i.e.
  77. any of the forms acceptable to Tk_GetPixels). For vertical ProgressBars this is
  78. the ProgressBars width; for horizontal bars this is the ProgressBars height.
  79. <P></P>
  80. <DT><STRONG><A NAME="item_%2Dlength">-length</A></STRONG><BR>
  81. <DD>
  82. Specifies the desired long dimension of the ProgressBar in screen units (i.e. any
  83. of the forms acceptable to Tk_GetPixels). For vertical ProgressBars this is the
  84. ProgressBars height; for horizontal scales it is the ProgressBars width.
  85. <P></P>
  86. <DT><STRONG><A NAME="item_%2Dcolors">-colors</A></STRONG><BR>
  87. <DD>
  88. <DT><STRONG><A NAME="item_%2Dblocks">-blocks</A></STRONG><BR>
  89. <DD>
  90. <DT><STRONG><A NAME="item_%2Dresolution">-resolution</A></STRONG><BR>
  91. <DD>
  92. A real value specifying the resolution for the scale. If this value is greater
  93. than zero then the scale's value will always be rounded to an even multiple of
  94. this value, as will tick marks and the endpoints of the scale. If the value is
  95. less than zero then no rounding occurs. Defaults to 1 (i.e., the value will be
  96. integral).
  97. <P></P>
  98. <DT><STRONG><A NAME="item_%2Danchor">-anchor</A></STRONG><BR>
  99. <DD>
  100. <DT><STRONG><A NAME="item_%2Dvariable">-variable</A></STRONG><BR>
  101. <DD>
  102. Specifies the reference to a scalar variable to link to the ProgressBar.
  103. Whenever the value of the variable changes, the ProgressBar will upate
  104. to reflect this value. (See also the <STRONG>value</STRONG> method below.)
  105. <P></P>
  106. <DT><STRONG><A NAME="item_%2Dfrom">-from</A></STRONG><BR>
  107. <DD>
  108. <DT><STRONG><A NAME="item_%2Dto">-to</A></STRONG><BR>
  109. <DD>
  110. <DT><STRONG><A NAME="item_%2Dgap">-gap</A></STRONG><BR>
  111. <DD>
  112. </DL>
  113. <P>
  114. <HR>
  115. <H1><A NAME="widget methods">WIDGET METHODS</A></H1>
  116. <DL>
  117. <DT><STRONG><A NAME="item_value"><EM>$ProgressBar</EM>-><STRONG>value</STRONG>(?<EM>value</EM>?)</A></STRONG><BR>
  118. <DD>
  119. If <EM>value</EM> is omitted, returns the current value of the ProgressBar.  If
  120. <EM>value</EM> is given, the value of the ProgressBar is set. If <EM>$value</EM> is
  121. given but undefined the value of the option <STRONG>-from</STRONG> is used.
  122. <P></P></DL>
  123. <P>
  124. <HR>
  125. <H1><A NAME="author">AUTHOR</A></H1>
  126. <P>Graham Barr <<EM><A HREF="mailto:gbarr@pobox.com">gbarr@pobox.com</A></EM>></P>
  127. <P>
  128. <HR>
  129. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  130. <P>Copyright (c) 1997-1998 Graham Barr. All rights reserved.
  131. This program is free software; you can redistribute it and/or modify it
  132. under the same terms as Perl itself.</P>
  133. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  134. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  135. <STRONG><P CLASS=block> Tk::ProgressBar - A graphical progress bar</P></STRONG>
  136. </TD></TR>
  137. </TABLE>
  138.  
  139. </BODY>
  140.  
  141. </HTML>
  142.