home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _ab378bf335e5620205f08e99306009cc < prev    next >
Text File  |  2000-03-23  |  4KB  |  116 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Tk::MainWindow - Root widget of a widget tree</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::MainWindow - Root widget of a widget tree</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="#methods">METHODS</A></LI>
  26.     <LI><A HREF="#missing">MISSING</A></LI>
  27.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  28. </UL>
  29. <!-- INDEX END -->
  30.  
  31. <HR>
  32. <P>
  33. <H1><A NAME="name">NAME</A></H1>
  34. <P>Tk::MainWindow - Root widget of a widget tree</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. <PRE>
  46.     use Tk;</PRE>
  47. <PRE>
  48.     my $mw = MainWindow->new( ... options ... );</PRE>
  49. <PRE>
  50.     my $this = $mw->ThisWidget -> pack ;
  51.     my $that = $mw->ThatWidget;
  52.     ...</PRE>
  53. <PRE>
  54.     MainLoop;</PRE>
  55. <P>
  56. <HR>
  57. <H1><A NAME="description">DESCRIPTION</A></H1>
  58. <P>Perl/Tk applications (which have windows associated with them) create
  59. one or more <STRONG>MainWindow</STRONG>s which act as the containers and parents
  60. of the other widgets.</P>
  61. <P><STRONG>Tk::MainWindow</STRONG> is a special kind of <A HREF="../../../site/lib/Tk/Toplevel.html">Toplevel</A> widget. It is
  62. the root of a widget tree. Therefore <CODE>$mw->Parent</CODE> returns
  63. <A HREF="../../../lib/Pod/perlfunc.html#item_undef"><CODE>undef</CODE></A>.</P>
  64. <P>The default title of a MainWindow is the basename of the script
  65. (actually the Class name used for options lookup, i.e. with basename
  66. with inital caps) or 'Ptk' as the fallback value.  If more than one MainWindow is created
  67. or several instances of the script are running at the same time the
  68. string <CODE>" #n"</CODE> is appended where the number <CODE>n</CODE> is set to get
  69. a unique value.</P>
  70. <P>Unlike the standard Tcl/Tk's wish, perl/Tk allows you to create
  71. several MainWindows.  When the <EM>last</EM> <STRONG>MainWindow</STRONG> is destroyed
  72. the Tk eventloop exits (the eventloop is entered with the call of
  73. <CODE>MainLoop</CODE>). Various resources (bindings, fonts, images, colors) are
  74. maintained or cached for each MainWindow, so each MainWindow consumes more
  75. resources than a Toplevel. However multiple MainWindows can make sense when
  76. the user can destroy them independently.</P>
  77. <P>
  78. <HR>
  79. <H1><A NAME="methods">METHODS</A></H1>
  80. <P>You can apply all methods that a <A HREF="../../../site/lib/Tk/Toplevel.html">Toplevel</A> widget accepts.</P>
  81. <P>The method <EM>$w</EM>-><STRONG>MainWindow</STRONG> applied to any widget will return the
  82. <STRONG>MainWindow</STRONG> to which the widget belongs (the  MainWindow belongs to itself).</P>
  83. <P>
  84. <HR>
  85. <H1><A NAME="missing">MISSING</A></H1>
  86. <P>Documentation is incomplete.
  87. Here are <EM>some</EM> missing items that should be explained in
  88. more detail:</P>
  89. <UL>
  90. <LI>
  91. The new mechanism for MainWindows is slightly different to
  92. other widgets.
  93. <P></P>
  94. <LI>
  95. There no explanation about what resources are bound
  96. to a MainWindow (e.g., ClassInit done per MainWindow)
  97. <P></P>
  98. <LI>
  99. Passing of command line options to override or augment
  100. arguments of the <CODE>new</CODE> method (see <A HREF="../../../site/lib/Tk/CmdLine.html">the Tk::CmdLine manpage</A>).
  101. <P></P></UL>
  102. <P>
  103. <HR>
  104. <H1><A NAME="see also">SEE ALSO</A></H1>
  105. <P><A HREF="../../../site/lib/Tk/Toplevel.html">Tk::Toplevel</A>
  106. <A HREF="../../../site/lib/Tk/CmdLine.html">Tk::CmdLine</A></P>
  107. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  108. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  109. <STRONG><P CLASS=block> Tk::MainWindow - Root widget of a widget tree</P></STRONG>
  110. </TD></TR>
  111. </TABLE>
  112.  
  113. </BODY>
  114.  
  115. </HTML>
  116.