// Purpose: interface of wxSplitterWindow
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
@endStyleTable
- @beginEventTable{wxSplitterEvent}
+ @beginEventEmissionTable{wxSplitterEvent}
@event{EVT_SPLITTER_SASH_POS_CHANGING(id, func)}
The sash position is in the process of being changed.
May be used to modify the position of the tracking bar to properly
@see Initialize(), SplitVertically(), SplitHorizontally(), Create()
*/
- wxSplitterWindow(wxWindow* parent, wxWindowID id,
+ wxSplitterWindow(wxWindow* parent, wxWindowID id = wxID_ANY,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = wxSP_3D,
Creation function, for two-step construction.
See wxSplitterWindow() for details.
*/
- bool Create(wxWindow* parent, wxWindowID id,
+ bool Create(wxWindow* parent, wxWindowID id = wxID_ANY,
const wxPoint& point = wxDefaultPosition,
- const wxSize& size = wxDefaultSize,
- long style = wxSP_3D,
- const wxString& name = "splitterWindow");
+ const wxSize& size = wxDefaultSize, long style = wxSP_3D,
+ const wxString& name = "splitter");
/**
Returns the current minimum pane size (defaults to zero).
*/
int GetSashPosition() const;
+ /**
+ Returns the sash size in pixels.
+
+ The size of the sash is its width for a vertically split window and its
+ height for a horizontally split one. Its other direction is the same as
+ the client size of the window in the corresponding direction.
+
+ The sash size is platform-dependent because it conforms to the current
+ platform look-and-feel and cannot be changed.
+ */
+ int GetSashSize() const;
+
/**
Gets the split mode.
@see SetSplitMode(), SplitVertically(), SplitHorizontally().
*/
- int GetSplitMode() const;
+ wxSplitMode GetSplitMode() const;
/**
Returns the left/top or only pane.
@see GetSashPosition()
*/
- void SetSashPosition(int position, const bool redraw = true);
-
- /**
- Sets the sash size. Normally, the sash size is determined according to the
- metrics
- of each platform, but the application can override this, for example to show
- a thin sash that the user is not expected to drag. If @a size is more -1,
- the custom sash size will be used.
- */
- void SetSashSize(int size);
+ void SetSashPosition(int position, bool redraw = true);
/**
Sets the split mode.
@library{wxcore}
@category{events}
- @see wxSplitterWindow, @ref overview_eventhandling
+ @see wxSplitterWindow, @ref overview_events
*/
class wxSplitterEvent : public wxNotifyEvent
{