X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1fded56b375bf7a4687af1cdb182899614c1b2a8..dae0faa6be08c5bb5635fd464b695ac8bb8f2b8d:/wxPython/demo/wxColourDialog.py

diff --git a/wxPython/demo/wxColourDialog.py b/wxPython/demo/wxColourDialog.py
index 151db30873..be0fc703d4 100644
--- 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):
-    dlg = wxColourDialog(frame)
+    dlg = wx.ColourDialog(frame)
+
+    # Ensure the full colour dialog is displayed, 
+    # not the abbreviated version.
     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()
+        
+        # ... 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()))
+
+    # Once the dialog is destroyed, Mr. wx.ColourData is no longer your
+    # friend. Don't use it again!
     dlg.Destroy()
 
 #---------------------------------------------------------------------------
 
 
-
-
-
-
-
-
-
-
-
-
 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