]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/demo/wxTimeCtrl.py
reSWIGged
[wxWidgets.git] / wxPython / demo / wxTimeCtrl.py
index 09465642dd2fb162bb4f7ac875ac9c073ee3b9bb..aa5cf52762b92ec7b51cf482e8c484cc0d5c11ea 100644 (file)
-from wxPython.wx import *
-from wxPython.lib.timectrl import *
+# 11/21/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Updated for wx namespace
+# 
+# 11/21/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o wx renamer needed for timectrl lib
+# o presense of spin control causing probs (see spin ctrl demo for details)
+# 
+# 12/13/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o New binders applied. Issues still exist.
+#
+# 12/20/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o wxTimeCtrl -> TimeCtrl
+# o wxScrolledPanel -> ScrolledPanel
+#
+
+import  wx
+import  wx.lib.timectrl         as  timectl
+import  wx.lib.scrolledpanel    as  scrolled
 
 #----------------------------------------------------------------------
 
-class TestPanel( wxPanel ):
+class TestPanel( scrolled.ScrolledPanel ):
     def __init__( self, parent, log ):
 
-        wxPanel.__init__( self, parent, -1 )
+        scrolled.ScrolledPanel.__init__( self, parent, -1 )
         self.log = log
-        panel = wxPanel( self, -1 )
 
-        grid = wxFlexGridSizer( 0, 2, 20, 0 )
 
-        text1 = wxStaticText( panel, 10, "A 12-hour format wxTimeCtrl:")
-        self.time12 = wxTimeCtrl( panel, 20, name="12 hour control" )
-        spin1 = wxSpinButton( panel, 30, wxDefaultPosition, wxSize(-1,20), 0 )
+        text1 = wx.StaticText( self, -1, "12-hour format:")
+        self.time12 = timectl.TimeCtrl( self, -1, name="12 hour control" )
+        spin1 = wx.SpinButton( self, -1, wx.DefaultPosition, (-1,20), 0 )
         self.time12.BindSpinButton( spin1 )
 
-        grid.AddWindow( text1, 0, wxALIGN_RIGHT, 5 )
-        hbox1 = wxBoxSizer( wxHORIZONTAL )
-        hbox1.AddWindow( self.time12, 0, wxALIGN_CENTRE, 5 )
-        hbox1.AddWindow( spin1, 0, wxALIGN_CENTRE, 5 )
-        grid.AddSizer( hbox1, 0, wxLEFT, 5 )
+        text2 = wx.StaticText( self, -1, "24-hour format:")
+        spin2 = wx.SpinButton( self, -1, wx.DefaultPosition, (-1,20), 0 )
+        self.time24 = timectl.TimeCtrl(
+                        self, -1, name="24 hour control", fmt24hr=True, 
+                        spinButton = spin2 
+                        )
 
+        text3 = wx.StaticText( self, -1, "No seconds\nor spin button:")
+        self.spinless_ctrl = timectl.TimeCtrl(
+                                self, -1, name="spinless control", 
+                                display_seconds = False 
+                                )
 
-        text2 = wxStaticText( panel, 40, "A 24-hour format wxTimeCtrl:")
-        self.time24 = wxTimeCtrl( panel, 50, fmt24hr=True, name="24 hour control" )
-        spin2 = wxSpinButton( panel, 60, wxDefaultPosition, wxSize(-1,20), 0 )
-        self.time24.BindSpinButton( spin2 )
+        grid = wx.FlexGridSizer( 0, 2, 10, 5 )
+        grid.Add( text1, 0, wx.ALIGN_RIGHT )
+        hbox1 = wx.BoxSizer( wx.HORIZONTAL )
+        hbox1.Add( self.time12, 0, wx.ALIGN_CENTRE )
+        hbox1.Add( spin1, 0, wx.ALIGN_CENTRE )
+        grid.Add( hbox1, 0, wx.LEFT )
 
-        grid.AddWindow( text2, 0, wxALIGN_RIGHT|wxTOP|wxBOTTOM, 5 )
-        hbox2 = wxBoxSizer( wxHORIZONTAL )
-        hbox2.AddWindow( self.time24, 0, wxALIGN_CENTRE, 5 )
-        hbox2.AddWindow( spin2, 0, wxALIGN_CENTRE, 5 )
-        grid.AddSizer( hbox2, 0, wxLEFT, 5 )
+        grid.Add( text2, 0, wx.ALIGN_RIGHT|wx.TOP|wx.BOTTOM )
+        hbox2 = wx.BoxSizer( wx.HORIZONTAL )
+        hbox2.Add( self.time24, 0, wx.ALIGN_CENTRE )
+        hbox2.Add( spin2, 0, wx.ALIGN_CENTRE )
+        grid.Add( hbox2, 0, wx.LEFT )
 
+        grid.Add( text3, 0, wx.ALIGN_RIGHT|wx.TOP|wx.BOTTOM )
+        grid.Add( self.spinless_ctrl, 0, wx.LEFT )
 
-        text3 = wxStaticText( panel, 70, "A wxTimeCtrl without a spin button:")
-        self.spinless_ctrl = wxTimeCtrl( panel, 80, name="spinless control" )
 
-        grid.AddWindow( text3, 0, wxALIGN_RIGHT|wxTOP|wxBOTTOM, 5 )
-        grid.AddWindow( self.spinless_ctrl, 0, wxLEFT, 5 )
+        buttonChange = wx.Button( self, -1, "Change Controls")
+        self.radio12to24 = wx.RadioButton(
+                            self, -1, "Copy 12-hour time to 24-hour control", 
+                            wx.DefaultPosition, wx.DefaultSize, wx.RB_GROUP 
+                            )
 
+        self.radio24to12 = wx.RadioButton(
+                            self, -1, "Copy 24-hour time to 12-hour control"
+                            )
 
-        buttonChange = wxButton( panel, 100, "Change Controls")
-        self.radio12to24 = wxRadioButton( panel, 110, "Copy 12-hour time to 24-hour control", wxDefaultPosition, wxDefaultSize, wxRB_GROUP )
-        self.radio24to12 = wxRadioButton( panel, 120, "Copy 24-hour time to 12-hour control")
-        self.radioWx = wxRadioButton( panel, 130, "Set controls to 'now' using wxDateTime")
-        self.radioMx = wxRadioButton( panel, 140, "Set controls to 'now' using mxDateTime")
+        self.radioWx = wx.RadioButton( self, -1, "Set controls to 'now' using wxDateTime")
+        self.radioMx = wx.RadioButton( self, -1, "Set controls to 'now' using mxDateTime")
 
-        radio_vbox = wxBoxSizer( wxVERTICAL )
-        radio_vbox.AddWindow( self.radio12to24, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5 )
-        radio_vbox.AddWindow( self.radio24to12, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5 )
-        radio_vbox.AddWindow( self.radioWx, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5 )
-        radio_vbox.AddWindow( self.radioMx, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5 )
+        radio_vbox = wx.BoxSizer( wx.VERTICAL )
+        radio_vbox.Add( self.radio12to24, 0, wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5 )
+        radio_vbox.Add( self.radio24to12, 0, wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5 )
+        radio_vbox.Add( self.radioWx, 0, wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5 )
+        radio_vbox.Add( self.radioMx, 0, wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5 )
 
-        box_label = wxStaticBox( panel, 90, "Change Controls through API" )
-        buttonbox = wxStaticBoxSizer( box_label, wxHORIZONTAL )
-        buttonbox.AddWindow( buttonChange, 0, wxALIGN_CENTRE|wxALL, 5 )
-        buttonbox.AddSizer( radio_vbox, 0, wxALIGN_CENTRE|wxALL, 5 )
+        box_label = wx.StaticBox( self, -1, "Change Controls through API" )
+        buttonbox = wx.StaticBoxSizer( box_label, wx.HORIZONTAL )
+        buttonbox.Add( buttonChange, 0, wx.ALIGN_CENTRE|wx.ALL, 5 )
+        buttonbox.Add( radio_vbox, 0, wx.ALIGN_CENTRE|wx.ALL, 5 )
 
-        outer_box = wxBoxSizer( wxVERTICAL )
-        outer_box.AddSizer( grid, 0, wxALIGN_CENTRE|wxBOTTOM, 20 )
-        outer_box.AddSizer( buttonbox, 0, wxALIGN_CENTRE|wxALL, 5 )
+        hbox = wx.BoxSizer( wx.HORIZONTAL )
+        hbox.Add( grid, 0, wx.ALIGN_LEFT|wx.ALL, 15 )
+        hbox.Add( buttonbox, 0, wx.ALIGN_RIGHT|wx.BOTTOM, 20 )
+
+
+        box_label = wx.StaticBox( self, -1, "Bounds Control" )
+        boundsbox = wx.StaticBoxSizer( box_label, wx.HORIZONTAL )
+        self.set_bounds = wx.CheckBox( self, -1, "Set time bounds:" )
+
+        minlabel = wx.StaticText( self, -1, "minimum time:" )
+        self.min = timectl.TimeCtrl( self, -1, name="min", display_seconds = False )
+        self.min.Enable( False )
+
+        maxlabel = wx.StaticText( self, -1, "maximum time:" )
+        self.max = timectl.TimeCtrl( self, -1, name="max", display_seconds = False )
+        self.max.Enable( False )
+
+        self.limit_check = wx.CheckBox( self, -1, "Limit control" )
+
+        label = wx.StaticText( self, -1, "Resulting time control:" )
+        self.target_ctrl = timectl.TimeCtrl( self, -1, name="new" )
+
+        grid2 = wx.FlexGridSizer( 0, 2, 0, 0 )
+        grid2.Add( (20, 0), 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+        grid2.Add( (20, 0), 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+
+        grid2.Add( self.set_bounds, 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+        grid3 = wx.FlexGridSizer( 0, 2, 5, 5 )
+        grid3.Add(minlabel, 0, wx.ALIGN_RIGHT|wx.ALIGN_CENTER_VERTICAL )
+        grid3.Add( self.min, 0, wx.ALIGN_LEFT )
+        grid3.Add(maxlabel, 0, wx.ALIGN_RIGHT|wx.ALIGN_CENTER_VERTICAL )
+        grid3.Add( self.max, 0, wx.ALIGN_LEFT )
+        grid2.Add(grid3, 0, wx.ALIGN_LEFT )
+
+        grid2.Add( self.limit_check, 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+        grid2.Add( (20, 0), 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+
+        grid2.Add( (20, 0), 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+        grid2.Add( (20, 0), 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+        grid2.Add( label, 0, wx.ALIGN_LEFT|wx.ALIGN_CENTER_VERTICAL|wx.ALL, 5 )
+        grid2.Add( self.target_ctrl, 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+        boundsbox.Add(grid2, 0, wx.ALIGN_CENTER|wx.EXPAND|wx.ALL, 5)
+
+        vbox = wx.BoxSizer( wx.VERTICAL )
+        vbox.Add( (20, 20) )
+        vbox.Add( hbox, 0, wx.ALIGN_LEFT|wx.ALL, 5)
+        vbox.Add( boundsbox, 0, wx.ALIGN_LEFT|wx.ALL, 5 )
+
+
+        outer_box = wx.BoxSizer( wx.VERTICAL )
+        outer_box.Add( vbox, 0, wx.ALIGN_LEFT|wx.ALL, 5)
 
 
         # Turn on mxDateTime option only if we can import the module:
@@ -72,23 +149,28 @@ class TestPanel( wxPanel ):
             self.radioMx.Enable( False )
 
 
-        panel.SetAutoLayout( True )
-        panel.SetSizer( outer_box )
-        outer_box.Fit( panel )
-        panel.Move( (50,50) )
-        self.panel = panel
+        self.SetAutoLayout( True )
+        self.SetSizer( outer_box )
+        outer_box.Fit( self )
+        self.SetupScrolling()
 
+        self.Bind(wx.EVT_BUTTON, self.OnButtonClick, buttonChange )
+        self.Bind(timectl.EVT_TIMEUPDATE, self.OnTimeChange, self.time12 )
+        self.Bind(timectl.EVT_TIMEUPDATE, self.OnTimeChange, self.time24 )
+        self.Bind(timectl.EVT_TIMEUPDATE, self.OnTimeChange, self.spinless_ctrl )
+        self.Bind(wx.EVT_CHECKBOX, self.OnBoundsCheck, self.set_bounds )
+        self.Bind(wx.EVT_CHECKBOX, self.SetTargetMinMax, self.limit_check )
+        self.Bind(timectl.EVT_TIMEUPDATE, self.SetTargetMinMax, self.min )
+        self.Bind(timectl.EVT_TIMEUPDATE, self.SetTargetMinMax, self.max )
+        self.Bind(timectl.EVT_TIMEUPDATE, self.OnTimeChange, self.target_ctrl )
 
-        EVT_TIMEUPDATE( self, self.time12.GetId(), self.OnTimeChange )
-        EVT_TIMEUPDATE( self, self.time24.GetId(), self.OnTimeChange )
-        EVT_TIMEUPDATE( self, self.spinless_ctrl.GetId(), self.OnTimeChange )
 
-        EVT_BUTTON( self, buttonChange.GetId(), self.OnButtonClick )
+    def OnTimeChange( self, event ):
+        timectrl = self.FindWindowById( event.GetId() )
+        ib_str = [ "  (out of bounds)", "" ]
 
+        self.log.write('%s time = %s%s\n' % ( timectrl.GetName(), timectrl.GetValue(), ib_str[ timectrl.IsInBounds() ] ) )
 
-    def OnTimeChange( self, event ):
-        timectrl = self.panel.FindWindowById( event.GetId() )
-        self.log.write('%s time = %s\n' % ( timectrl.GetName(), timectrl.GetValue() ) )
 
     def OnButtonClick( self, event ):
         if self.radio12to24.GetValue():
@@ -98,17 +180,58 @@ class TestPanel( wxPanel ):
             self.time12.SetValue( self.time24.GetValue() )
 
         elif self.radioWx.GetValue():
-            now = wxDateTime_Now()
-            self.time12.SetWxDateTime( now )
-            self.time24.SetWxDateTime( now )
-            self.spinless_ctrl.SetWxDateTime( now )
+            now = wx.DateTime_Now()
+            self.time12.SetValue( now )
+            # (demonstrates that G/SetValue returns/takes a wxDateTime)
+            self.time24.SetValue( self.time12.GetValue(as_wxDateTime=True) )
+
+            # (demonstrates that G/SetValue returns/takes a wxTimeSpan)
+            self.spinless_ctrl.SetValue( self.time12.GetValue(as_wxTimeSpan=True) )
 
         elif self.radioMx.GetValue():
             from mx import DateTime
             now = DateTime.now()
-            self.time12.SetMxDateTime( now )
-            self.time24.SetMxDateTime( now )
-            self.spinless_ctrl.SetMxDateTime( now )
+            self.time12.SetValue( now )
+
+            # (demonstrates that G/SetValue returns/takes a DateTime)
+            self.time24.SetValue( self.time12.GetValue(as_mxDateTime=True) )
+
+            # (demonstrates that G/SetValue returns/takes a DateTimeDelta)
+            self.spinless_ctrl.SetValue( self.time12.GetValue(as_mxDateTimeDelta=True) )
+
+
+    def OnBoundsCheck( self, event ):
+        self.min.Enable( self.set_bounds.GetValue() )
+        self.max.Enable( self.set_bounds.GetValue() )
+        self.SetTargetMinMax()
+
+
+    def SetTargetMinMax( self, event=None ):
+        min = None
+        max = None
+
+        if self.set_bounds.GetValue():
+            min = self.min.GetWxDateTime()
+            max = self.max.GetWxDateTime()
+        else:
+            min, max = None, None
+
+        cur_min, cur_max = self.target_ctrl.GetBounds()
+
+        # jmg - A little expirimental change to ensure that min
+        # or max contain valid values before we use them
+        if min and (min != cur_min): self.target_ctrl.SetMin( min )
+        if max and (max != cur_max): self.target_ctrl.SetMax( max )
+
+        self.target_ctrl.SetLimited( self.limit_check.GetValue() )
+
+        if min != cur_min or max != cur_max:
+            new_min, new_max = self.target_ctrl.GetBounds()
+
+            if new_min and new_max:
+                self.log.write( "current min, max:  (%s, %s)\n" % ( new_min.FormatTime(), new_max.FormatTime() ) )
+            else:
+                self.log.write( "current min, max:  (None, None)\n" )
 
 #----------------------------------------------------------------------
 
@@ -118,93 +241,7 @@ def runTest( frame, nb, log ):
 
 #----------------------------------------------------------------------
 
-overview = """<html><body>
-<P>
-<B>wxTimeCtrl</B> provides a multi-cell control that allows manipulation of a time
-value.  It supports 12 or 24 hour format, and you can use wxDateTime or mxDateTime
-to get/set values from the control.
-<P>
-Left/right/tab keys to switch cells within a wxTimeCtrl, and the up/down arrows act
-like a spin control.  wxTimeCtrl also allows for an actual spin button to be attached
-to the control, so that it acts like the up/down arrow keys.
-<P>
-The <B>!</B> or <B>c</B> key sets the value of the control to <B><I>now.</I></B>
-<P>
-Here's the API for wxTimeCtrl:
-<DL><PRE>
-    <B>wxTimeCtrl</B>(
-         parent, id = -1,
-         <B>value</B> = '12:00:00 AM',
-         pos = wxDefaultPosition,
-         size = wxDefaultSize,
-         <B>fmt24hr</B> = False,
-         <B>spinButton</B> = None,
-         <B>style</B> = wxTE_PROCESS_TAB,
-         name = "time")
-</PRE>
-<UL>
-    <DT><B>value</B>
-    <DD>If no initial value is set, the default will be midnight; if an illegal string
-    is specified, a ValueError will result.  (You can always later set the initial time
-    with SetValue() after instantiation of the control.)
-    <DL><B>size</B>
-    <DD>The size of the control will be automatically adjusted for 12/24 hour format
-    if wxDefaultSize is specified.
-    <BR>
-    <DT><B>fmt24hr</B>
-    <DD>If True, control will display time in 24 hour time format; if False, it will
-    use 12 hour AM/PM format.  SetValue() will adjust values accordingly for the
-    control, based on the format specified.
-    <BR>
-    <DT><B>spinButton</B>
-    <DD>If specified, this button's events will be bound to the behavior of the
-    wxTimeCtrl, working like up/down cursor key events.  (See BindSpinButton.)
-    <BR>
-    <DT><B>style</B>
-    <DD>By default, wxTimeCtrl will process TAB events, by allowing tab to the
-    different cells within the control.
-    </DL>
-</UL>
-<BR>
-<BR>
-<DT><B>SetValue(time_string)</B>
-<DD>Sets the value of the control to a particular time, given a valid time string;
-raises ValueError on invalid value
-<BR>
-<DT><B>GetValue()</B>
-<DD>Retrieves the string value of the time from the control
-<BR>
-<DT><B>SetWxDateTime(wxDateTime)</B>
-<DD>Uses the time portion of a wxDateTime to construct a value for the control.
-<BR>
-<DT><B>GetWxDateTime()</B>
-<DD>Retrieves the value of the control, and applies it to the wxDateTimeFromHMS()
-constructor, and returns the resulting value.  (This returns the date portion as
-"today".)
-<BR>
-<DT><B>SetMxDateTime(mxDateTime)</B>
-<DD>Uses the time portion of an mxDateTime to construct a value for the control.
-<EM>NOTE:</EM> This imports mx.DateTime at runtime only if this or the Get function
-is called.
-<BR>
-<DT><B>GetMxDateTime()</B>
-<DD>Retrieves the value of the control and applies it to the DateTime.Time()
-constructor,  and returns the resulting value.  (mxDateTime is smart enough to
-know this is just a time value.)
-<BR>
-<DT><B>BindSpinButton(wxSpinBtton)</B>
-<DD>Binds an externally created spin button to the control, so that up/down spin
-events change the active cell or selection in the control (in addition to the
-up/down cursor keys.)  (This is primarily to allow you to create a "standard"
-interface to time controls, as seen in Windows.)
-<BR>
-<DT><B>EVT_TIMEUPDATE(win, id, func)</B>
-<DD>func is fired whenever the value of the control changes.
-</DL>
-</body></html>
-"""
-
-
+overview = timectl.__doc__
 
 if __name__ == '__main__':
     import sys,os