]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/sashwin.h
fixed links to global variables; fixed categories; use @see instead of @seealso
[wxWidgets.git] / interface / sashwin.h
index 22e916b9d1531ba4057bdfd388cef2a6257c2572..bae169d61e5b9ac84c0b24565e600977524e1dcb 100644 (file)
@@ -9,14 +9,14 @@
 /**
     @class wxSashWindow
     @wxheader{sashwin.h}
-    
+
     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_BORDER}:
            Draws a thin black border.
     @endStyleTable
-    
+
     @beginEventTable
-    @event{EVT_SASH_DRAGGED(id\, func)}:
+    @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)}:
+    @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}
-    
+
     @seealso
-    wxSashEvent, wxSashLayoutWindow, @ref overview_eventhandlingoverview "Event
-    handling overview"
+    wxSashEvent, wxSashLayoutWindow, @ref overview_eventhandlingoverview
 */
 class wxSashWindow : public wxWindow
 {
@@ -53,35 +52,30 @@ public:
         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
+        @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.
+            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();
-        wxSashWindow(wxWindow* parent, wxWindowID id,
-                     const wxPoint& pos = wxDefaultPosition,
-                     const wxSize& size = wxDefaultSize,
-                     long style = wxCLIP_CHILDREN |  wxSW_3D,
-                     const wxString& name = "sashWindow");
+    wxSashWindow(wxWindow* parent, wxWindowID id,
+                 const wxPoint& pos = wxDefaultPosition,
+                 const wxSize& size = wxDefaultSize,
+                 long style = wxCLIP_CHILDREN | wxSW_3D,
+                 const wxString& name = "sashWindow");
     //@}
 
     /**
@@ -92,12 +86,12 @@ public:
     /**
         Gets the maximum window size in the x direction.
     */
-    int GetMaximumSizeX();
+    int GetMaximumSizeX() const;
 
     /**
         Gets the maximum window size in the y direction.
     */
-    int GetMaximumSizeY();
+    int GetMaximumSizeY() const;
 
     /**
         Gets the minimum window size in the x direction.
@@ -107,28 +101,28 @@ public:
     /**
         Gets the minimum window size in the y direction.
     */
-    int GetMinimumSizeY();
+    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.
+        @param edge
+            Edge. One of wxSASH_TOP, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT.
         
-        @sa SetSashVisible()
+        @see SetSashVisible()
     */
-    bool GetSashVisible(wxSashEdgePosition edge);
+    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.
+        @param edge
+            Edge. One of wxSASH_TOP, wxSASH_RIGHT, wxSASH_BOTTOM, wxSASH_LEFT.
         
-        @sa SetSashBorder()
+        @see SetSashBorder()
     */
-    bool HasBorder(wxSashEdgePosition edge);
+    bool HasBorder(wxSashEdgePosition edge) const;
 
     /**
         Sets the maximum window size in the x direction.
@@ -154,24 +148,22 @@ public:
         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.
+        @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.
+        @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.
         
-        @sa GetSashVisible()
+        @see GetSashVisible()
     */
     void SetSashVisible(wxSashEdgePosition edge, bool visible);
 };
@@ -180,15 +172,15 @@ public:
 /**
     @class wxSashEvent
     @wxheader{sashwin.h}
-    
+
     A sash event is sent when the sash of a wxSashWindow has been
     dragged by the user.
-    
+
     @library{wxadv}
     @category{FIXME}
-    
+
     @seealso
-    wxSashWindow, @ref overview_eventhandlingoverview "Event handling overview"
+    wxSashWindow, @ref overview_eventhandlingoverview
 */
 class wxSashEvent : public wxCommandEvent
 {
@@ -203,7 +195,7 @@ public:
         resize was applied. It is
         up to the application to set the window size if required.
     */
-    wxRect GetDragRect();
+    wxRect GetDragRect() const;
 
     /**
         Returns the status of the sash: one of wxSASH_STATUS_OK,
@@ -211,11 +203,11 @@ public:
         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();
+    wxSashDragStatus GetDragStatus() const;
 
     /**
         Returns the dragged edge. The return value is one of wxSASH_TOP, wxSASH_RIGHT,
         wxSASH_BOTTOM, wxSASH_LEFT.
     */
-    wxSashEdgePosition GetEdge();
+    wxSashEdgePosition GetEdge() const;
 };