Search documentation of wx

# wxSashLayoutWindow (wx v2.6)

Copy Markdown View Source

`wxSashLayoutWindow` responds to OnCalculateLayout events generated by `wxLayoutAlgorithm`.

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 `wxSashWindow` allows sashes to be used if required, to allow the windows to be user-resizable.

The documentation for `wxLayoutAlgorithm` explains the purpose of this class in more detail.

For the window styles see `wxSashWindow`.

This class handles the EVT_QUERY_LAYOUT_INFO and EVT_CALCULATE_LAYOUT events for you. However, if you use sashes, see `wxSashWindow` for relevant event information. See also `wxLayoutAlgorithm` for information about the layout events.

See:

- `wxLayoutAlgorithm`

- `wxSashWindow`

- Overview events

This class is derived, and can use functions, from:

- `wxSashWindow`

- `wxWindow`

- `wxEvtHandler`

wxWidgets docs: wxSashLayoutWindow

## Summary

### Types

wxSashLayoutWindow()

### Functions

create(This, Parent)

Equivalent to `create(This, Parent, [])`.

create/3

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

destroy(This)

Destroys the object

getAlignment(This)

Returns the alignment of the window: one of wxLAYOUT_TOP, wxLAYOUT_LEFT, wxLAYOUT_RIGHT, wxLAYOUT_BOTTOM.

getOrientation(This)

Returns the orientation of the window: one of wxLAYOUT_HORIZONTAL, wxLAYOUT_VERTICAL.

new()

Default ctor.

new(Parent)

Equivalent to `new(Parent, [])`.

new/2

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

setAlignment(This, Alignment)

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

setDefaultSize(This, Size)

Sets the default dimensions of the window.

setOrientation(This, Orientation)

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

## Types

# wxSashLayoutWindow()

    -type wxSashLayoutWindow() :: wx:wx_object().

## Functions

# create(This, Parent)

    -spec create(This, Parent) -> boolean() when This :: wxSashLayoutWindow(), Parent :: wxWindow:wxWindow().

Equivalent to `create(This, Parent, [])`.

# create/3

    -spec create(This, Parent, [Option]) -> boolean()
                    when
                        This :: wxSashLayoutWindow(),
                        Parent :: wxWindow:wxWindow(),
                        Option ::
                            {id, integer()} |
                            {pos, {X :: integer(), Y :: integer()}} |
                            {size, {W :: integer(), H :: integer()}} |
                            {style, integer()}.

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

# destroy(This)

    -spec destroy(This :: wxSashLayoutWindow()) -> ok.

Destroys the object

# getAlignment(This)

    -spec getAlignment(This) -> wx:wx_enum() when This :: wxSashLayoutWindow().

Returns the alignment of the window: one of wxLAYOUT_TOP, wxLAYOUT_LEFT, wxLAYOUT_RIGHT, wxLAYOUT_BOTTOM.

# getOrientation(This)

    -spec getOrientation(This) -> wx:wx_enum() when This :: wxSashLayoutWindow().

Returns the orientation of the window: one of wxLAYOUT_HORIZONTAL, wxLAYOUT_VERTICAL.

# new()

    -spec new() -> wxSashLayoutWindow().

Default ctor.

# new(Parent)

    -spec new(Parent) -> wxSashLayoutWindow() when Parent :: wxWindow:wxWindow().

Equivalent to `new(Parent, [])`.

# new/2

    -spec new(Parent, [Option]) -> wxSashLayoutWindow()
                 when
                     Parent :: wxWindow:wxWindow(),
                     Option ::
                         {id, integer()} |
                         {pos, {X :: integer(), Y :: integer()}} |
                         {size, {W :: integer(), H :: integer()}} |
                         {style, integer()}.

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

# setAlignment(This, Alignment)

    -spec setAlignment(This, Alignment) -> ok when This :: wxSashLayoutWindow(), Alignment :: wx:wx_enum().

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

`alignment` is one of wxLAYOUT_TOP, wxLAYOUT_LEFT, wxLAYOUT_RIGHT, wxLAYOUT_BOTTOM.

# setDefaultSize(This, Size)

    -spec setDefaultSize(This, Size) -> ok
                            when This :: wxSashLayoutWindow(), Size :: {W :: integer(), H :: integer()}.

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.

# setOrientation(This, Orientation)

    -spec setOrientation(This, Orientation) -> ok
                            when This :: wxSashLayoutWindow(), Orientation :: wx:wx_enum().

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

`orientation` is one of wxLAYOUT_HORIZONTAL, wxLAYOUT_VERTICAL.