FourWaySplitter

This class is very similar to wx.SplitterWindow except that it allows for four windows and two sashes. Many of the same styles, constants, and methods behave the same as in wx.SplitterWindow. However, in addition of the ability to drag the vertical and the horizontal sash, by dragging at the intersection between the two sashes, it is possible to resize the four windows at the same time.

Note

These things are not yet supported:

• Minimum pane size (minimum of what? Width? Height?);
• Using negative sash positions to indicate a position offset from the end;
• User controlled unsplitting with double clicks on the sash (but supported via the SetExpanded method);
• Sash gravity.

Inheritance Diagram

Inheritance diagram for: FourWaySplitter

Control Appearance

FourWaySplitter

Methods Summary

__init__	Default class constructor.
AdjustLayout	Adjust layout of FourWaySplitter. Mainly used to recalculate the
AppendWindow	Add a new window to the splitter at the right side or bottom of the window stack.
DetachWindow	Removes the window from the stack of windows managed by the splitter.
DoGetBestSize	Gets the size which best suits the window: for a control, it would be the
DoSendChangingEvent	Sends a EVT_SPLITTER_SASH_POS_CHANGING event.
DrawSplitter	Actually draws the sashes.
DrawTrackSplitter	Draws a fake sash in case we don’t have wx.SP_LIVE_UPDATE style.
ExchangeWindows	Trade the positions in the splitter of the two windows.
GetAGWWindowStyleFlag	Returns the FourWaySplitter window style.
GetBottomLeft	Returns the bottom left window (window index: 2).
GetBottomRight	Returns the bottom right window (window index: 3).
GetMode	Determines the split mode for FourWaySplitter.
GetTopLeft	Returns the top left window (window index: 0).
GetTopRight	Returns the top right window (window index: 1).
GetWindow	Returns the window at the index idx.
InsertWindow	Insert a new window into the splitter at the position given in idx.
MoveSplit	Moves the split accordingly to user action.
OnEnterWindow	Handles the wx.EVT_ENTER_WINDOW event for FourWaySplitter.
OnLeaveWindow	Handles the wx.EVT_LEAVE_WINDOW event for FourWaySplitter.
OnLeftDown	Handles the wx.EVT_LEFT_DOWN event for FourWaySplitter.
OnLeftUp	Handles the wx.EVT_LEFT_UP event for FourWaySplitter.
OnMotion	Handles the wx.EVT_MOTION event for FourWaySplitter.
OnPaint	Handles the wx.EVT_PAINT event for FourWaySplitter.
OnSize	Handles the wx.EVT_SIZE event for FourWaySplitter.
ReplaceWindow	Replaces oldWindow (which is currently being managed by the
SetAGWWindowStyleFlag	Sets the FourWaySplitter window style flags.
SetExpanded	This method is used to expand one of the four window to fill the whole client size (when expanded >= 0) or to return to the four-window view (when expanded < 0).
SetHSplit	Change horizontal split fraction.
SetVSplit	Change vertical split fraction.
_GetBorderSize	Used internally.
_GetSashSize	Used internally.
_RedrawIfHotSensitive	Used internally.
_SizeWindows	Recalculate the layout based on split positions and split fractions.

Class API

class FourWaySplitter(wx.PyPanel)

This class is very similar to wx.SplitterWindow except that it allows for four windows and two sashes. Many of the same styles, constants, and methods behave the same as in wx.SplitterWindow. However, in addition of the ability to drag the vertical and the horizontal sash, by dragging at the intersection between the two sashes, it is possible to resize the four windows at the same time.

Note

These things are not yet supported:

• Minimum pane size (minimum of what? Width? Height?);
• Using negative sash positions to indicate a position offset from the end;
• User controlled unsplitting with double clicks on the sash (but supported via the FourWaySplitter.SetExpanded() method);
• Sash gravity.

---

__init__(parent, id=wx.ID_ANY, pos=wx.DefaultPosition, size=wx.DefaultSize, style=0, agwStyle=0, name="FourWaySplitter")

Default class constructor.

Parameters:

• parent – parent window. Must not be None;
• id – window identifier. A value of -1 indicates a default value;
• pos – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;
• size – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform;
• style – the underlying wx.PyPanel window style;
• agwStyle – the AGW-specific window style. It can be a combination of the following bits:
  
  

  Window Styles	Hex Value	Description
  SP_NOSASH	0x10	No sash will be drawn on FourWaySplitter.
  SP_LIVE_UPDATE	0x80	Don’t draw XOR line but resize the child windows immediately.
  SP_3DBORDER	0x200	Draws a 3D effect border.

• name – the window name.

---

AdjustLayout()

Adjust layout of FourWaySplitter. Mainly used to recalculate the correct values for split fractions.

---

AppendWindow(window)

Add a new window to the splitter at the right side or bottom of the window stack.

Parameters:window – an instance of wx.Window.

---

DetachWindow(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.

Parameters:window – an instance of wx.Window.

---

DoGetBestSize()

Gets the size which best suits the window: for a control, it would be the minimal size which doesn’t truncate the control, for a panel - the same size as it would have after a call to Fit().

Note

Overridden from wx.PyPanel.

---

DoSendChangingEvent(pt)

Sends a EVT_SPLITTER_SASH_POS_CHANGING event.

Parameters:pt – the point at which the splitter is being positioned.

---

DrawSplitter(dc)

Actually draws the sashes.

Parameters:dc – an instance of wx.DC.

---

DrawTrackSplitter(x, y)

Draws a fake sash in case we don’t have wx.SP_LIVE_UPDATE style.

Parameters:

• x – the x position of the sash;
• y – the y position of the sash.

Note

This method relies on wx.ScreenDC which is currently unavailable on wxMac.

---

ExchangeWindows(window1, window2)

Trade the positions in the splitter of the two windows.

Parameters:

• window1 – an instance of wx.Window;

• window2 – another instance of wx.Window.

---

GetAGWWindowStyleFlag()

Returns the FourWaySplitter window style.

See also

SetAGWWindowStyleFlag for a list of possible window styles.

---

GetBottomLeft()

Returns the bottom left window (window index: 2).

---

GetBottomRight()

Returns the bottom right window (window index: 3).

---

GetMode(pt)

Determines the split mode for FourWaySplitter.

Parameters:pt – the point at which the mouse has been clicked, an instance of wx.Point. Returns:One of the following 3 split modes:

Split Mode	Description
wx.HORIZONTAL	the user has clicked on the horizontal sash
wx.VERTICAL	The user has clicked on the vertical sash
wx.BOTH	The user has clicked at the intersection between the 2 sashes

---

GetTopLeft()

Returns the top left window (window index: 0).

---

GetTopRight()

Returns the top right window (window index: 1).

---

GetWindow(idx)

Returns the window at the index idx.

Parameters:idx – the index at which the window is located.

---

InsertWindow(idx, window, sashPos=-1)

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

Parameters:

• idx – the index at which the window will be inserted;
• window – an instance of wx.Window;

• sashPos – the sash position after the window insertion.

---

MoveSplit(x, y)

Moves the split accordingly to user action.

Parameters:

• x – the new splitter x coordinate;
• y – the new splitter y coordinate.

---

OnEnterWindow(event)

Handles the wx.EVT_ENTER_WINDOW event for FourWaySplitter.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnLeaveWindow(event)

Handles the wx.EVT_LEAVE_WINDOW event for FourWaySplitter.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnLeftDown(event)

Handles the wx.EVT_LEFT_DOWN event for FourWaySplitter.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnLeftUp(event)

Handles the wx.EVT_LEFT_UP event for FourWaySplitter.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnMotion(event)

Handles the wx.EVT_MOTION event for FourWaySplitter.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnPaint(event)

Handles the wx.EVT_PAINT event for FourWaySplitter.

Parameters:event – a wx.PaintEvent event to be processed.

---

OnSize(event)

Handles the wx.EVT_SIZE event for FourWaySplitter.

Parameters:event – a wx.SizeEvent event to be processed.

---

ReplaceWindow(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.

Parameters:

• oldWindow – an instance of wx.Window;

• newWindow – another instance of wx.Window.

---

SetAGWWindowStyleFlag(agwStyle)

Sets the FourWaySplitter window style flags.

Parameters:agwStyle – the AGW-specific window style. This can be a combination of the following bits:

Window Styles	Hex Value	Description
SP_NOSASH	0x10	No sash will be drawn on FourWaySplitter.
SP_LIVE_UPDATE	0x80	Don’t draw XOR line but resize the child windows immediately.
SP_3DBORDER	0x200	Draws a 3D effect border.

---

SetExpanded(expanded)

This method is used to expand one of the four window to fill the whole client size (when expanded >= 0) or to return to the four-window view (when expanded < 0).

Parameters:expanded – an integer >= 0 to expand a window to fill the whole client size, or an integer < 0 to return to the four-window view.

---

SetHSplit(s)

Change horizontal split fraction.

Parameters:s – the split fraction, which is an integer value between 0 and 10000 (inclusive), indicating how much space to allocate to the leftmost panes. For example, to split the panes at 35 percent, use:

fourSplitter.SetHSplit(3500)

---

SetVSplit(s)

Change vertical split fraction.

Parameters:s – the split fraction, which is an integer value between 0 and 10000 (inclusive), indicating how much space to allocate to the topmost panes. For example, to split the panes at 35 percent, use:

fourSplitter.SetVSplit(3500)

AGW

• advancedsplash
• aquabutton
• artmanager
• aui
• balloontip
• buttonpanel
• cubecolourdialog
• customtreectrl
• flatmenu
• flatnotebook
• floatspin
• fmcustomizedlg
• foldpanelbar
• fourwaysplitter
• genericmessagedialog
• gradientbutton
• hyperlink
• hypertreelist
• infobar
• knobctrl
• labelbook
• multidirdialog
• peakmeter
• persist
• piectrl
• pybusyinfo
• pycollapsiblepane
• pygauge
• pyprogress
• ribbon
• rulerctrl
• shapedbutton
• shortcuteditor
• speedmeter
• supertooltip
• thumbnailctrl
• toasterbox
• ultimatelistctrl
• xlsgrid
• zoombar

Tree