///////////////////////////////////////////////////////////////////////////// // Name: sashwin.h // Purpose: interface of wxSashWindow // Author: wxWidgets team // RCS-ID: $Id$ // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** See wxSashWindow. */ enum wxSashEdgePosition { wxSASH_TOP = 0, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT, wxSASH_NONE = 100 }; /** See wxSashEvent. */ enum wxSashDragStatus { wxSASH_STATUS_OK, wxSASH_STATUS_OUT_OF_RANGE }; /** @class wxSashWindow wxSashWindow allows any of its edges to have a sash which can be dragged to resize the window. The actual content window will be created by the application as a child of wxSashWindow. The window (or an ancestor) will be notified of a drag via a wxSashEvent notification. @beginStyleTable @style{wxSW_3D} Draws a 3D effect sash and border. @style{wxSW_3DSASH} Draws a 3D effect sash. @style{wxSW_3DBORDER} Draws a 3D effect border. @style{wxSW_BORDER} Draws a thin black border. @endStyleTable @beginEventEmissionTable{wxSashEvent} @event{EVT_SASH_DRAGGED(id, func)} Process a wxEVT_SASH_DRAGGED event, when the user has finished dragging a sash. @event{EVT_SASH_DRAGGED_RANGE(id1, id2, func)} Process a wxEVT_SASH_DRAGGED_RANGE event, when the user has finished dragging a sash. The event handler is called when windows with ids in the given range have their sashes dragged. @endEventTable @library{wxadv} @category{miscwnd} @see wxSashEvent, wxSashLayoutWindow, @ref overview_events */ class wxSashWindow : public wxWindow { public: /** Default ctor. */ wxSashWindow(); /** Constructs a sash window, which can be a child of a frame, dialog or any other non-control window. @param parent Pointer to a parent window. @param id Window identifier. If -1, will automatically create an identifier. @param pos Window position. wxDefaultPosition is (-1, -1) which indicates that wxSashWindows should generate a default position for the window. If using the wxSashWindow class directly, supply an actual position. @param size Window size. wxDefaultSize is (-1, -1) which indicates that wxSashWindows should generate a default size for the window. @param style Window style. For window styles, please see wxSashWindow. @param name Window name. */ wxSashWindow(wxWindow* parent, wxWindowID id, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, long style = wxCLIP_CHILDREN | wxSW_3D, const wxString& name = "sashWindow"); /** Destructor. */ virtual ~wxSashWindow(); /** Gets the maximum window size in the x direction. */ virtual int GetMaximumSizeX() const; /** Gets the maximum window size in the y direction. */ virtual int GetMaximumSizeY() const; /** Gets the minimum window size in the x direction. */ virtual int GetMinimumSizeX() const; /** Gets the minimum window size in the y direction. */ virtual int GetMinimumSizeY() const; /** Returns @true if a sash is visible on the given edge, @false otherwise. @param edge Edge. One of wxSASH_TOP, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT. @see SetSashVisible() */ bool GetSashVisible(wxSashEdgePosition edge) const; /** Returns @true if the sash has a border, @false otherwise. This function is obsolete since the sash border property is unused. @param edge Edge. One of wxSASH_TOP, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT. @see SetSashBorder() */ bool HasBorder(wxSashEdgePosition edge) const; /** Sets the maximum window size in the x direction. */ virtual void SetMaximumSizeX(int min); /** Sets the maximum window size in the y direction. */ virtual void SetMaximumSizeY(int min); /** Sets the minimum window size in the x direction. */ virtual void SetMinimumSizeX(int min); /** Sets the minimum window size in the y direction. */ virtual void SetMinimumSizeY(int min); /** Call this function to give the sash a border, or remove the border. This function is obsolete since the sash border property is unused. @param edge Edge to change. One of wxSASH_TOP, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT. @param hasBorder @true to give the sash a border visible, @false to remove it. */ void SetSashBorder(wxSashEdgePosition edge, bool hasBorder); /** Call this function to make a sash visible or invisible on a particular edge. @param edge Edge to change. One of wxSASH_TOP, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT. @param visible @true to make the sash visible, @false to make it invisible. @see GetSashVisible() */ void SetSashVisible(wxSashEdgePosition edge, bool visible); }; /** @class wxSashEvent A sash event is sent when the sash of a wxSashWindow has been dragged by the user. @remarks When a sash belonging to a sash window is dragged by the user, and then released, this event is sent to the window, where it may be processed by an event table entry in a derived class, a plug-in event handler or an ancestor class. Note that the wxSashWindow doesn't change the window's size itself. It relies on the application's event handler to do that. This is because the application may have to handle other consequences of the resize, or it may wish to veto it altogether. The event handler should look at the drag rectangle: see wxSashEvent::GetDragRect to see what the new size of the window would be if the resize were to be applied. It should also call wxSashEvent::GetDragStatus to see whether the drag was OK or out of the current allowed range. @beginEventTable{wxSashEvent} @event{EVT_SASH_DRAGGED(id, func)} Process a wxEVT_SASH_DRAGGED event, when the user has finished dragging a sash. @event{EVT_SASH_DRAGGED_RANGE(id1, id2, func)} Process a wxEVT_SASH_DRAGGED_RANGE event, when the user has finished dragging a sash. The event handler is called when windows with ids in the given range have their sashes dragged. @endEventTable @library{wxadv} @category{events} @see wxSashWindow, @ref overview_events */ class wxSashEvent : public wxCommandEvent { public: /** Constructor. */ wxSashEvent(int id = 0, wxSashEdgePosition edge = wxSASH_NONE); /** Returns the rectangle representing the new size the window would be if the resize was applied. It is up to the application to set the window size if required. */ wxRect GetDragRect() const; /** Returns the status of the sash: one of wxSASH_STATUS_OK, wxSASH_STATUS_OUT_OF_RANGE. If the drag caused the notional bounding box of the window to flip over, for example, the drag will be out of rage. */ wxSashDragStatus GetDragStatus() const; /** Returns the dragged edge. The return value is one of wxSASH_TOP, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT. */ wxSashEdgePosition GetEdge() const; };