reSWIGged

[wxWidgets.git] / wxPython / demo / wxColourDialog.py

diff --git a/wxPython/demo/wxColourDialog.py b/wxPython/demo/wxColourDialog.py
index 151db30873bd2d8bf21dc79e558ccd2f0c9a65e1..be0fc703d4129890afde39b7a73e92425c56a52e 100644 (file)
--- a/wxPython/demo/wxColourDialog.py
+++ b/wxPython/demo/wxColourDialog.py
@@ -1,38 +1,56 @@
+# 11/15/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Updated for wx namespace
+# 

 
 

-from wxPython.wx import *
+import  wx

 
 #---------------------------------------------------------------------------
 
 def runTest(frame, nb, log):
 
 #---------------------------------------------------------------------------
 
 def runTest(frame, nb, log):

-    dlg = wxColourDialog(frame)
+    dlg = wx.ColourDialog(frame)
+
+    # Ensure the full colour dialog is displayed, 
+    # not the abbreviated version.

     dlg.GetColourData().SetChooseFull(True)
     dlg.GetColourData().SetChooseFull(True)

-    if dlg.ShowModal() == wxID_OK:
+
+    if dlg.ShowModal() == wx.ID_OK:
+
+        # If the user selected OK, then the dialog's wx.ColourData will
+        # contain valid information. Fetch the data ...

         data = dlg.GetColourData()
         data = dlg.GetColourData()

+        
+        # ... then do something with it. The actual colour data will be
+        # returned as a three-tuple (r, g, b) in this particular case.

         log.WriteText('You selected: %s\n' % str(data.GetColour().Get()))
         log.WriteText('You selected: %s\n' % str(data.GetColour().Get()))

+
+    # Once the dialog is destroyed, Mr. wx.ColourData is no longer your
+    # friend. Don't use it again!

     dlg.Destroy()
 
 #---------------------------------------------------------------------------
 
 
     dlg.Destroy()
 
 #---------------------------------------------------------------------------
 
 

-
-
-
-
-
-
-
-
-
-

 overview = """\
 This class represents the colour chooser dialog.
 
 overview = """\
 This class represents the colour chooser dialog.
 

+Use of this dialog is a multi-stage process. 

 
 

-"""
-
-
+The actual information about how to display the dialog and the colors in the 
+dialog's 'registers' are contained in a wx.ColourData instance that is created by 
+the dialog at init time. Before displaying the dialog, you may alter these settings 
+to suit your needs. In the example, we set the dialog up to show the extended colour 
+data selection pane. Otherwise, only the more compact and less extensive colour 
+dialog is shown.  You may also preset the colour as well as other items. 

 
 

+If the user selects something and selects OK, then the wxColourData instance contains
+the colour data that the user selected. Before destroying the dialog, retrieve the data.
+<b>Do not try to retain the wx.ColourData instance.</b> It will probably not be valid
+after the dialog is destroyed.

 
 

+Along with he wxColourDialog documentation, see also the wx.ColourData documentation 
+for details.
+"""

 
 if __name__ == '__main__':
     import sys,os
 
 if __name__ == '__main__':
     import sys,os