wxPython/demo/wxDynamicSashWindow.py

   1
   2 from wxPython.wx import *
   3 from wxPython.gizmos import *
   4 from wxPython.stc import *
   5
   6 #----------------------------------------------------------------------
   7 # This is an example of the complex view that manages its own scrollbars
   8 # as described in the overview below.
   9
  10 class TestView(wxStyledTextCtrl):
  11     def __init__(self, parent, ID, log):
  12         wxStyledTextCtrl.__init__(self, parent, ID, style=wxNO_BORDER)
  13         self.dyn_sash = parent
  14         self.log = log
  15         self.SetupScrollBars()
  16         self.SetMarginWidth(1,0)
  17         self.StyleSetFont(wxSTC_STYLE_DEFAULT,
  18                           wxFont(10, wxMODERN, wxNORMAL, wxNORMAL))
  19         EVT_DYNAMIC_SASH_SPLIT(self, -1, self.OnSplit)
  20         EVT_DYNAMIC_SASH_UNIFY(self, -1, self.OnUnify)
  21         #self.SetScrollWidth(500)
  22
  23     def SetupScrollBars(self):
  24         # hook the scrollbars provided by the wxDynamicSashWindow
  25         # to this view
  26         v_bar = self.dyn_sash.GetVScrollBar(self)
  27         h_bar = self.dyn_sash.GetHScrollBar(self)
  28         EVT_SCROLL(v_bar, self.OnSBScroll)
  29         EVT_SCROLL(h_bar, self.OnSBScroll)
  30         EVT_SET_FOCUS(v_bar, self.OnSBFocus)
  31         EVT_SET_FOCUS(h_bar, self.OnSBFocus)
  32
  33         # And set the wxStyledText to use these scrollbars instead
  34         # of its built-in ones.
  35         self.SetVScrollBar(v_bar)
  36         self.SetHScrollBar(h_bar)
  37
  38
  39     def __del__(self):
  40         self.log.write("TestView.__del__\n")
  41
  42     def OnSplit(self, evt):
  43         self.log.write("TestView.OnSplit\n");
  44         newview = TestView(self.dyn_sash, -1, self.log)
  45         newview.SetDocPointer(self.GetDocPointer())     # use the same document
  46         self.SetupScrollBars()
  47
  48
  49     def OnUnify(self, evt):
  50         self.log.write("TestView.OnUnify\n");
  51         self.SetupScrollBars()
  52
  53
  54     def OnSBScroll(self, evt):
  55         # redirect the scroll events from the dyn_sash's scrollbars to the STC
  56         self.GetEventHandler().ProcessEvent(evt)
  57
  58     def OnSBFocus(self, evt):
  59         # when the scrollbar gets the focus move it back to the STC
  60         self.SetFocus()
  61
  62
  63 sampleText="""\
  64 You can drag the little tabs above the vertical scrollbar, or to the
  65 left of the horizontal scrollbar to split this view, and you can
  66 continue splitting the new views as much as you like.  Try it and see.
  67
  68 In this case the views also share the same document so changes in one
  69 are instantly seen in the others.  This is a feature of the
  70 wxStyledTextCtrl that is used for the view class in this sample.
  71 """
  72
  73 #----------------------------------------------------------------------
  74 # This one is simpler, but doesn't do anything with the scrollbars
  75 # except the default wxDynamicSashWindow behaviour
  76
  77 class SimpleView(wxPanel):
  78     def __init__(self, parent, ID, log):
  79         wxPanel.__init__(self, parent, ID)
  80         self.dyn_sash = parent
  81         self.log = log
  82         self.SetBackgroundColour("LIGHT BLUE")
  83         EVT_DYNAMIC_SASH_SPLIT(self, -1, self.OnSplit)
  84
  85     def OnSplit(self, evt):
  86         v = SimpleView(self.dyn_sash, -1, self.log)
  87
  88
  89 #----------------------------------------------------------------------
  90
  91 def runTest(frame, nb, log):
  92     if wxPlatform == "__WXMAC__":
  93         wxMessageBox("This demo currently fails on the Mac. The problem is being looked into...", "Sorry")
  94         return
  95
  96     if 1:
  97         win = wxDynamicSashWindow(nb, -1, style = 0
  98                                   | wxCLIP_CHILDREN
  99                                   #| wxDS_MANAGE_SCROLLBARS
 100                                   #| wxDS_DRAG_CORNER
 101                                   )
 102         win.SetFont(wxFont(10, wxMODERN, wxNORMAL, wxNORMAL))
 103         view = TestView(win, -1, log)
 104         view.SetText(sampleText)
 105     else:
 106         win = wxDynamicSashWindow(nb, -1)
 107         view = SimpleView(win, -1, log)
 108     return win
 109
 110 #----------------------------------------------------------------------
 111
 112 overview = """\
 113 <html><body>
 114 <h2>wxDynamicSashWindow</h2>
 115 <p>
 116 wxDynamicSashWindow widgets manages the way other widgets are viewed.
 117 When a wxDynamicSashWindow is first shown, it will contain one child
 118 view, a viewport for that child, and a pair of scrollbars to allow the
 119 user to navigate the child view area.  Next to each scrollbar is a small
 120 tab.  By clicking on either tab and dragging to the appropriate spot, a
 121 user can split the view area into two smaller views separated by a
 122 draggable sash.  Later, when the user wishes to reunify the two subviews,
 123 the user simply drags the sash to the side of the window.
 124 wxDynamicSashWindow will automatically reparent the appropriate child
 125 view back up the window hierarchy, and the wxDynamicSashWindow will have
 126 only one child view once again.
 127 <p>
 128 As an application developer, you will simply create a wxDynamicSashWindow
 129 using either the Create() function or the more complex constructor
 130 provided below, and then create a view window whose parent is the
 131 wxDynamicSashWindow.  The child should respond to
 132 wxDynamicSashSplitEvents -- perhaps with an OnSplit() event handler -- by
 133 constructing a new view window whose parent is also the
 134 wxDynamicSashWindow.  That's it!  Now your users can dynamically split
 135 and reunify the view you provided.
 136 <p>
 137 If you wish to handle the scrollbar events for your view, rather than
 138 allowing wxDynamicSashWindow to do it for you, things are a bit more
 139 complex.  (You might want to handle scrollbar events yourself, if,
 140 for instance, you wish to scroll a subwindow of the view you add to
 141 your wxDynamicSashWindow object, rather than scrolling the whole view.)
 142 In this case, you will need to construct your wxDynamicSashWindow without
 143 the wxDS_MANAGE_SCROLLBARS style and  you will need to use the
 144 GetHScrollBar() and GetVScrollBar() methods to retrieve the scrollbar
 145 controls and call SetEventHanler() on them to redirect the scrolling
 146 events whenever your window is reparented by wxDyanmicSashWindow.
 147 You will need to set the scrollbars' event handler at three times:
 148 <p>
 149 <ul>
 150 <li>  When your view is created
 151 <li>  When your view receives a wxDynamicSashSplitEvent
 152 <li>  When your view receives a wxDynamicSashUnifyEvent
 153 </ul>
 154 </body></html>
 155 """
 156
 157
 158 if __name__ == '__main__':
 159     import sys,os
 160     import run
 161     run.main(['', os.path.basename(sys.argv[0])])
 162