home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _99df6dac24925762e52acefcc40baa4d < prev    next >
Encoding:
Text File  |  2000-03-23  |  4.1 KB  |  125 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Tk::ObjScanner - Tk composite widget object scanner</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::ObjScanner - Tk composite widget object scanner</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="#constructor parameters">Constructor parameters</A></LI>
  26.     <LI><A HREF="#widgetspecific methods">WIDGET-SPECIFIC METHODS</A></LI>
  27.     <UL>
  28.  
  29.         <LI><A HREF="#updatelistbox">updateListBox</A></LI>
  30.     </UL>
  31.  
  32.     <LI><A HREF="#caveats">CAVEATS</A></LI>
  33.     <LI><A HREF="#author">AUTHOR</A></LI>
  34.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  35. </UL>
  36. <!-- INDEX END -->
  37.  
  38. <HR>
  39. <P>
  40. <H1><A NAME="name">NAME</A></H1>
  41. <P>Tk::ObjScanner - Tk composite widget object scanner</P>
  42. <P>
  43. <HR>
  44. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  45. <UL>
  46. <LI>Linux</LI>
  47. <LI>Solaris</LI>
  48. <LI>Windows</LI>
  49. </UL>
  50. <HR>
  51. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  52. <PRE>
  53.   use Tk::ObjScanner;
  54. </PRE>
  55. <PRE>
  56.  
  57.   my $scanner = $mw->ObjScanner( caller => $object, 
  58.                                  [title=>"windows"]) -> pack ;</PRE>
  59. <P>
  60. <HR>
  61. <H1><A NAME="description">DESCRIPTION</A></H1>
  62. <P>The scanner provide a GUI to scan the attributes of an object. It can
  63. also be used to scan the elements of a hash or an array.</P>
  64. <P>The scanner is a composite widget made of a <A HREF="../../../site/lib/Tk/HList.html">the Tk::HList manpage</A> and a text
  65. window (actually a <A HREF="../../../TK/ROText.html">the TK::ROText manpage</A>). This widget acts as a scanner to
  66. the object (or hash ref) passed with the 'caller' parameter. The
  67. scanner will retrieve all keys of the hash/object and insert them in
  68. the HList.</P>
  69. <P>When the user double clicks on a key, the corresponding value will be added
  70. in the HList.</P>
  71. <P>If the value is a scalar, the scalar will be displayed in the text window.
  72. (Which is handy if the value is a multi-line string)</P>
  73. <P>
  74. <HR>
  75. <H1><A NAME="constructor parameters">Constructor parameters</A></H1>
  76. <UL>
  77. <LI>
  78. caller: The ref of the object or hash or array to scan (mandatory).
  79. <P></P>
  80. <LI>
  81. title: the title of the menu created by the scanner (optionnal)
  82. <P></P>
  83. <LI>
  84. destroyable: If set, a menu entry will allow the user to deatroy the scanner
  85. widget. (optional, default 1) . You may want to set this parameter to 0 if
  86. the destroy can be managed by a higher level object.
  87. <P></P></UL>
  88. <P>
  89. <HR>
  90. <H1><A NAME="widgetspecific methods">WIDGET-SPECIFIC METHODS</A></H1>
  91. <P>
  92. <H2><A NAME="updatelistbox">updateListBox</A></H2>
  93. <P>Update the keys of the listbox. This method may be handy if the
  94. scanned object wants to update the listbox of the scanner 
  95. when the scanned object gets new attributes.</P>
  96. <P>
  97. <HR>
  98. <H1><A NAME="caveats">CAVEATS</A></H1>
  99. <P>ObjScanner may fail if an object involves a lot of internal perl
  100. magic.  In this case, I'd be glad to hear about and I'll try to fix
  101. the problem.</P>
  102. <P>ObjScanner does not detect recursive data structures. It will just
  103. keep on displaying the tree until the user gets tired of clicking on
  104. the HList items.</P>
  105. <P>
  106. <HR>
  107. <H1><A NAME="author">AUTHOR</A></H1>
  108. <P>Dominique Dumont, <A HREF="mailto:Dominique_Dumont@grenoble.hp.com">Dominique_Dumont@grenoble.hp.com</A></P>
  109. <P>Copyright (c) 1997-1999 Dominique Dumont. All rights reserved.
  110. This program is free software; you can redistribute it and/or
  111. modify it under the same terms as Perl itself.</P>
  112. <P>
  113. <HR>
  114. <H1><A NAME="see also">SEE ALSO</A></H1>
  115. <P>perl(1), Tk(3), Tk::HList(3)</P>
  116. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  117. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  118. <STRONG><P CLASS=block> Tk::ObjScanner - Tk composite widget object scanner</P></STRONG>
  119. </TD></TR>
  120. </TABLE>
  121.  
  122. </BODY>
  123.  
  124. </HTML>
  125.