reSWIGged

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

diff --git a/wxPython/demo/wxColourDialog.py b/wxPython/demo/wxColourDialog.py
index 1f06f5cb288bfae9cb58b96e1ad87c4089cd180a..be0fc703d4129890afde39b7a73e92425c56a52e 100644 (file)
--- a/wxPython/demo/wxColourDialog.py
+++ b/wxPython/demo/wxColourDialog.py
@@ -1,38 +1,59 @@
+# 11/15/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Updated for wx namespace
+# 
 
-from wxPython.wx import *
+import  wx
 
 #---------------------------------------------------------------------------
 
 def runTest(frame, nb, log):
-    data = wxColourData()
-    data.SetChooseFull(true)
-    dlg = wxColourDialog(frame, data)
-    if dlg.ShowModal() == wxID_OK:
-        data = dlg.GetColourData()
-        log.WriteText('You selected: %s\n' % str(data.GetColour().Get()))
-    dlg.Destroy()
-
-#---------------------------------------------------------------------------
-
-
-
-
-
+    dlg = wx.ColourDialog(frame)
 
+    # Ensure the full colour dialog is displayed, 
+    # not the abbreviated version.
+    dlg.GetColourData().SetChooseFull(True)
 
+    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.
 
-wxColourDialog()
-------------------------------
+Use of this dialog is a multi-stage process. 
 
-wxColourDialog(wxWindow* parent, wxColourData* data = NULL)
+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. 
 
-Constructor. Pass a parent window, and optionally a pointer to a block of colour data, which will be copied to the colour dialog's colour data.
+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
+    import run
+    run.main(['', os.path.basename(sys.argv[0])])
+