.. include:: headings.inc

.. currentmodule:: lib.splitter

.. highlight:: python



.. _lib.splitter.MultiSplitterWindow:

==========================================================================================================================================
|phoenix_title|  **MultiSplitterWindow**
==========================================================================================================================================

This class is very similar to `SplitterWindow`    except that it
allows for more than two windows and more than one sash.  Many of
the same styles, constants, and methods behave the same as in
wx.SplitterWindow.  The key differences are seen in the methods
that deal with the child windows managed by the splitter, and also
those that deal with the sash positions.  In most cases you will
need to pass an index value to tell the class which window or sash
you are refering to.

The concept of the sash position is also different than in
wx.SplitterWindow.  Since the wx.Splitterwindow has only one sash
you can think of it's position as either relative to the whole
splitter window, or as relative to the first window pane managed
by the splitter.  Once there is more than one sash then the
distinciton between the two concepts needs to be clairified.  I've
chosen to use the second definition, and sash positions are the
distance (either horizontally or vertically) from the origin of
the window just before the sash in the splitter stack.

NOTE: These things are not yet supported:

    * Using negative sash positions to indicate a position offset
      from the end.
      
    * User controlled unsplitting (with double clicks on the sash
      or dragging a sash until the pane size is zero.)
      
    * Sash gravity
   



|

|class_hierarchy| Inheritance Diagram
=====================================

Inheritance diagram for class **MultiSplitterWindow**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/lib.splitter.MultiSplitterWindow_inheritance.png" alt="Inheritance diagram of MultiSplitterWindow" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="Window.html" title="Window  is the base class for all windows and represents any visible object on screen." alt="" coords="396,5,476,35"/> <area shape="rect" id="node7" href="Panel.html" title="A panel is a window on which controls are placed." alt="" coords="525,5,597,35"/> <area shape="rect" id="node2" href="EvtHandler.html" title="A class that can handle events from the windowing system." alt="" coords="247,5,345,35"/> <area shape="rect" id="node4" href="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="125,5,197,35"/> <area shape="rect" id="node12" href="lib.splitter.MultiSplitterWindow.html" title="This class is very similar to `wx.SplitterWindow` except that it" alt="" coords="776,5,992,35"/> </map> 
   </p>

|


|super_classes| Known Superclasses
==================================

:class:`PyPanel`

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~lib.splitter.MultiSplitterWindow.__init__`                               
:meth:`~lib.splitter.MultiSplitterWindow.AppendWindow`                           Add a new window to the splitter at the right side or bottom
:meth:`~lib.splitter.MultiSplitterWindow.DetachWindow`                           Removes the window from the stack of windows managed by the
:meth:`~lib.splitter.MultiSplitterWindow.DoGetBestSize`                          Overridden base class virtual.  Determines the best size of
:meth:`~lib.splitter.MultiSplitterWindow.ExchangeWindows`                        Trade the positions in the splitter of the two windows.
:meth:`~lib.splitter.MultiSplitterWindow.GetMinimumPaneSize`                     Returns the smallest allowed size for a window pane.
:meth:`~lib.splitter.MultiSplitterWindow.GetOrientation`                         Returns the current orientation of the splitter, either
:meth:`~lib.splitter.MultiSplitterWindow.GetSashPosition`                        Returns the position of the idx'th sash, measured from the
:meth:`~lib.splitter.MultiSplitterWindow.GetWindow`                              Returns the idx'th window being managed by the splitter.
:meth:`~lib.splitter.MultiSplitterWindow.InsertWindow`                           Insert a new window into the splitter at the position given in
:meth:`~lib.splitter.MultiSplitterWindow.ReplaceWindow`                          Replaces oldWindow (which is currently being managed by the
:meth:`~lib.splitter.MultiSplitterWindow.SetBackgroundColour`                    
:meth:`~lib.splitter.MultiSplitterWindow.SetMinimumPaneSize`                     Set the smallest size that any pane will be allowed to be
:meth:`~lib.splitter.MultiSplitterWindow.SetOrientation`                         Set whether the windows managed by the splitter will be
:meth:`~lib.splitter.MultiSplitterWindow.SetSashPosition`                        Set the psition of the idx'th sash, measured from the left/top
:meth:`~lib.splitter.MultiSplitterWindow.SizeWindows`                            Reposition and size the windows managed by the splitter.
================================================================================ ================================================================================


|


|api| Class API
===============
   

.. class:: MultiSplitterWindow(PyPanel)

   This class is very similar to `SplitterWindow`    except that it
   allows for more than two windows and more than one sash.  Many of
   the same styles, constants, and methods behave the same as in
   wx.SplitterWindow.  The key differences are seen in the methods
   that deal with the child windows managed by the splitter, and also
   those that deal with the sash positions.  In most cases you will
   need to pass an index value to tell the class which window or sash
   you are refering to.
   
   The concept of the sash position is also different than in
   wx.SplitterWindow.  Since the wx.Splitterwindow has only one sash
   you can think of it's position as either relative to the whole
   splitter window, or as relative to the first window pane managed
   by the splitter.  Once there is more than one sash then the
   distinciton between the two concepts needs to be clairified.  I've
   chosen to use the second definition, and sash positions are the
   distance (either horizontally or vertically) from the origin of
   the window just before the sash in the splitter stack.
   
   NOTE: These things are not yet supported:
   
       * Using negative sash positions to indicate a position offset
         from the end.
         
       * User controlled unsplitting (with double clicks on the sash
         or dragging a sash until the pane size is zero.)
         
       * Sash gravity
      

   .. method:: __init__(self, parent, id=-1, pos = DefaultPosition, size = DefaultSize, style = 0, name="multiSplitter")


   .. method:: AppendWindow(self, window, sashPos=-1)

      Add a new window to the splitter at the right side or bottom
      of the window stack.  If sashPos is given then it is used to
      size the new window.


   .. method:: DetachWindow(self, window)

      Removes the window from the stack of windows managed by the
      splitter.  The window will still exist so you should `Hide` or
      `Destroy` it as needed.


   .. method:: DoGetBestSize(self)

      Overridden base class virtual.  Determines the best size of
      the control based on the best sizes of the child windows.


   .. method:: ExchangeWindows(self, window1, window2)

      Trade the positions in the splitter of the two windows.


   .. method:: GetMinimumPaneSize(self)

      Returns the smallest allowed size for a window pane.


   .. method:: GetOrientation(self)

      Returns the current orientation of the splitter, either
      wx.VERTICAL or wx.HORIZONTAL.


   .. method:: GetSashPosition(self, idx)

      Returns the position of the idx'th sash, measured from the
      left/top of the window preceding the sash.


   .. method:: GetWindow(self, idx)

      Returns the idx'th window being managed by the splitter.


   .. method:: InsertWindow(self, idx, window, sashPos=-1)

      Insert a new window into the splitter at the position given in
      ``idx``.


   .. method:: ReplaceWindow(self, oldWindow, newWindow)

      Replaces oldWindow (which is currently being managed by the
      splitter) with newWindow.  The oldWindow window will still
      exist so you should `Hide` or `Destroy` it as needed.


   .. method:: SetBackgroundColour(self,color)


   .. method:: SetMinimumPaneSize(self, minSize)

      Set the smallest size that any pane will be allowed to be
      resized to.


   .. method:: SetOrientation(self, orient)

      Set whether the windows managed by the splitter will be
      stacked vertically or horizontally.  The default is
      horizontal.


   .. method:: SetSashPosition(self, idx, pos)

      Set the psition of the idx'th sash, measured from the left/top
      of the window preceding the sash.


   .. method:: SizeWindows(self)

      Reposition and size the windows managed by the splitter.
      Useful when windows have been added/removed or when styles
      have been changed.