Phoenix Logo

phoenix_title wx.adv.SashLayoutWindow

wx.adv.SashLayoutWindow responds to OnCalculateLayout events generated by wx.adv.LayoutAlgorithm.

It allows the application to use simple accessors to specify how the window should be laid out, rather than having to respond to events.

The fact that the class derives from wx.adv.SashWindow allows sashes to be used if required, to allow the windows to be user-resizable.

The documentation for wx.adv.LayoutAlgorithm explains the purpose of this class in more detail.

For the window styles see wx.adv.SashWindow.

This class handles the EVT_QUERY_LAYOUT_INFO and EVT_CALCULATE_LAYOUT events for you. However, if you use sashes, see wx.adv.SashWindow for relevant event information. See also wx.adv.LayoutAlgorithm for information about the layout events.


class_hierarchy Class Hierarchy

Inheritance diagram for class SashLayoutWindow:


method_summary Methods Summary

__init__ Default constructor.
Create Initializes a sash layout window, which can be a child of a frame, dialog or any other non-control window.
GetAlignment Returns the alignment of the window: one of wx.adv.LAYOUT_TOP, wx.adv.LAYOUT_LEFT, wx.adv.LAYOUT_RIGHT, wx.adv.LAYOUT_BOTTOM.
GetOrientation Returns the orientation of the window: one of wx.adv.LAYOUT_HORIZONTAL, wx.adv.LAYOUT_VERTICAL.
OnCalculateLayout The default handler for the event that is generated by wx.adv.LayoutAlgorithm.
OnQueryLayoutInfo The default handler for the event that is generated by OnCalculateLayout to get size, alignment and orientation information for the window.
SetAlignment Sets the alignment of the window (which edge of the available parent client area the window is attached to).
SetDefaultSize Sets the default dimensions of the window.
SetOrientation Sets the orientation of the window (the direction the window will stretch in, to fill the available parent client area).

api Class API



class wx.adv.SashLayoutWindow(SashWindow)

Possible constructors:

SashLayoutWindow()

SashLayoutWindow(parent, id=ID_ANY, pos=DefaultPosition,
                 size=DefaultSize, style=CLIP_CHILDREN|SW_3D, name="layoutWindow")

SashLayoutWindow responds to OnCalculateLayout events generated by LayoutAlgorithm.


Methods



__init__(self, *args, **kw)

overload Overloaded Implementations:



__init__ (self)

Default constructor.



__init__ (self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=CLIP_CHILDREN|SW_3D, name=”layoutWindow”)

Constructs a sash layout window, which can be a child of a frame, dialog or any other non-control window.

Parameters:
  • parent (wx.Window) – Pointer to a parent window.
  • id (wx.WindowID) – Window identifier. If -1, will automatically create an identifier.
  • pos (wx.Point) – Window position. DefaultPosition is (-1, -1) which indicates that SashLayoutWindows should generate a default position for the window. If using the wx.adv.SashLayoutWindow class directly, supply an actual position.
  • size (wx.Size) – Window size. DefaultSize is (-1, -1) which indicates that SashLayoutWindows should generate a default size for the window.
  • style (long) – Window style. For window styles, please see wx.adv.SashLayoutWindow.
  • name (string) – Window name.





Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=CLIP_CHILDREN|SW_3D, name="layoutWindow")

Initializes a sash layout window, which can be a child of a frame, dialog or any other non-control window.

Parameters:
  • parent (wx.Window) – Pointer to a parent window.
  • id (wx.WindowID) – Window identifier. If -1, will automatically create an identifier.
  • pos (wx.Point) – Window position. DefaultPosition is (-1, -1) which indicates that SashLayoutWindows should generate a default position for the window. If using the wx.adv.SashLayoutWindow class directly, supply an actual position.
  • size (wx.Size) – Window size. DefaultSize is (-1, -1) which indicates that SashLayoutWindows should generate a default size for the window.
  • style (long) – Window style. For window styles, please see wx.adv.SashLayoutWindow.
  • name (string) – Window name.
Return type:

bool



GetAlignment(self)

Returns the alignment of the window: one of wx.adv.LAYOUT_TOP, wx.adv.LAYOUT_LEFT, wx.adv.LAYOUT_RIGHT, wx.adv.LAYOUT_BOTTOM.

Return type: wx.adv.LayoutAlignment


GetOrientation(self)

Returns the orientation of the window: one of wx.adv.LAYOUT_HORIZONTAL, wx.adv.LAYOUT_VERTICAL.

Return type: wx.adv.LayoutOrientation


OnCalculateLayout(self, event)

The default handler for the event that is generated by wx.adv.LayoutAlgorithm.

The implementation of this function calls wx.adv.CalculateLayoutEvent.SetRect to shrink the provided size according to how much space this window takes up. For further details, see wx.adv.LayoutAlgorithm and wx.adv.CalculateLayoutEvent.

Parameters:event (wx.adv.CalculateLayoutEvent) –


OnQueryLayoutInfo(self, event)

The default handler for the event that is generated by OnCalculateLayout to get size, alignment and orientation information for the window.

The implementation of this function uses member variables as set by accessors called by the application.

For further details, see wx.adv.LayoutAlgorithm and wx.adv.QueryLayoutInfoEvent.

Parameters:event (wx.adv.QueryLayoutInfoEvent) –


SetAlignment(self, alignment)

Sets the alignment of the window (which edge of the available parent client area the window is attached to).

alignment is one of wx.adv.LAYOUT_TOP, wx.adv.LAYOUT_LEFT, wx.adv.LAYOUT_RIGHT, wx.adv.LAYOUT_BOTTOM.

Parameters:alignment (LayoutAlignment) –


SetDefaultSize(self, size)

Sets the default dimensions of the window.

The dimension other than the orientation will be fixed to this value, and the orientation dimension will be ignored and the window stretched to fit the available space.

Parameters:size (wx.Size) –


SetOrientation(self, orientation)

Sets the orientation of the window (the direction the window will stretch in, to fill the available parent client area).

orientation is one of wx.adv.LAYOUT_HORIZONTAL, wx.adv.LAYOUT_VERTICAL.

Parameters:orientation (LayoutOrientation) –

Properties



Alignment

See GetAlignment and SetAlignment



Orientation

See GetOrientation and SetOrientation