X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/b8b8dda73001819104b83776e4c014369c013ce8..d9f39e09e82e99c422619f4e3df536d0a9e87987:/utils/wxPython/tests/test1.py

diff --git a/utils/wxPython/tests/test1.py b/utils/wxPython/tests/test1.py
index a35465e2db..90e68ee2de 100644
--- a/utils/wxPython/tests/test1.py
+++ b/utils/wxPython/tests/test1.py
@@ -5,30 +5,47 @@
 #
 # Author:       Robin Dunn
 #
-# Created:
+# Created:      A long time ago, in a galaxy far, far away...
 # RCS-ID:       $Id$
 # Copyright:    (c) 1998 by Total Control Software
 # Licence:      wxWindows license
 #----------------------------------------------------------------------------
 
 
+## import all of the wxPython GUI package
 from wxPython.wx import *
 
 
 #---------------------------------------------------------------------------
 
+## Create a new frame class, derived from the wxPython Frame.
 class MyFrame(wxFrame):
+
     def __init__(self, parent, id, title):
-        wxFrame.__init__(self, parent, id, title, wxPoint(100, 100), wxSize(160, 100))
-        self.Connect(-1, -1, wxEVT_MOVE, self.OnMove)
+        # First, call the base class' __init__ method to create the frame
+        wxFrame.__init__(self, parent, id, title,
+                         wxPoint(100, 100), wxSize(160, 100))
+
+        # Associate some events with methods of this class
+        EVT_SIZE(self, self.OnSize)
+        EVT_MOVE(self, self.OnMove)
 
+
+    # This method is called automatically when the CLOSE event is
+    # sent to this window
     def OnCloseWindow(self, event):
+        # tell the window to kill itself
         self.Destroy()
 
+
+    # This method is called by the System when the window is resized,
+    # because of the association above.
     def OnSize(self, event):
         size = event.GetSize()
         print "size:", size.width, size.height
 
+    # This method is called by the System when the window is moved,
+    # because of the association above.
     def OnMove(self, event):
         pos = event.GetPosition()
         print "pos:", pos.x, pos.y
@@ -37,58 +54,30 @@ class MyFrame(wxFrame):
 
 #---------------------------------------------------------------------------
 
-
+# Every wxWindows application must have a class derived from wxApp
 class MyApp(wxApp):
+
+    # wxWindows calls this method to initialize the application
     def OnInit(self):
+
+        # Create an instance of our customized Frame class
         frame = MyFrame(NULL, -1, "This is a test")
         frame.Show(true)
+
+        # Tell wxWindows that this is our main window
         self.SetTopWindow(frame)
+
+        # Return a success flag
         return true
 
 #---------------------------------------------------------------------------
 
 
-def main():
-    app = MyApp(0)
-    app.MainLoop()
-
-
-def t():
-    import pdb
-    pdb.run('main()')
-
-if __name__ == '__main__':
-    main()
-
+app = MyApp(0)     # Create an instance of the application class
+app.MainLoop()     # Tell it to start processing events
 
+print 'done!'
 
 #----------------------------------------------------------------------------
 #
-# $Log$
-# Revision 1.3  1998/12/15 20:44:34  RD
-# Changed the import semantics from "from wxPython import *" to "from
-# wxPython.wx import *"  This is for people who are worried about
-# namespace pollution, they can use "from wxPython import wx" and then
-# prefix all the wxPython identifiers with "wx."
-#
-# Added wxTaskbarIcon for wxMSW.
-#
-# Made the events work for wxGrid.
-#
-# Added wxConfig.
-#
-# Added wxMiniFrame for wxGTK, (untested.)
-#
-# Changed many of the args and return values that were pointers to gdi
-# objects to references to reflect changes in the wxWindows API.
-#
-# Other assorted fixes and additions.
-#
-# Revision 1.2  1998/10/02 06:42:27  RD
-#
-# Version 0.4 of wxPython for MSW.
-#
-# Revision 1.1  1998/08/09 08:28:05  RD
-# Initial version
-#
-#
+