]> git.saurik.com Git - wxWidgets.git/blobdiff - include/wx/vscroll.h
split wxBase into wxBase and wxNet libraries
[wxWidgets.git] / include / wx / vscroll.h
index 6d830f6417f2286dab8f44621a62f767c90fe0c2..1cdc9d1e485a4f55ac49b07b8c9b3ac97f10a0b6 100644 (file)
 #ifndef _WX_VSCROLL_H_
 #define _WX_VSCROLL_H_
 
 #ifndef _WX_VSCROLL_H_
 #define _WX_VSCROLL_H_
 
+#if defined(__GNUG__) && !defined(__APPLE__)
+#pragma interface "vscroll.h"
+#endif
+
 #include "wx/panel.h"           // base class
 
 // ----------------------------------------------------------------------------
 #include "wx/panel.h"           // base class
 
 // ----------------------------------------------------------------------------
@@ -62,7 +66,7 @@ public:
     // just as with the ctor above, wxVSCROLL style is always used, there is no
     // need to specify it
     bool Create(wxWindow *parent,
     // just as with the ctor above, wxVSCROLL style is always used, there is no
     // need to specify it
     bool Create(wxWindow *parent,
-                wxWindowID id,
+                wxWindowID id = wxID_ANY,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style = 0,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style = 0,
@@ -93,11 +97,18 @@ public:
     // redraw the specified line
     void RefreshLine(size_t line);
 
     // redraw the specified line
     void RefreshLine(size_t line);
 
-    // return the item at the specified (in physical coordinates) position or
+    // redraw all lines in the specified range (inclusive)
+    void RefreshLines(size_t from, size_t to);
+
+    // return the item at the specified (in physical coordinates) position or.
+
     // wxNOT_FOUND if none, i.e. if it is below the last item
     int HitTest(wxCoord x, wxCoord y) const;
     int HitTest(const wxPoint& pt) const { return HitTest(pt.x, pt.y); }
 
     // wxNOT_FOUND if none, i.e. if it is below the last item
     int HitTest(wxCoord x, wxCoord y) const;
     int HitTest(const wxPoint& pt) const { return HitTest(pt.x, pt.y); }
 
+    // recalculate all our parameters and redisplay all lines
+    virtual void RefreshAll();
+
 
     // accessors
     // ---------
 
     // accessors
     // ---------
@@ -137,14 +148,24 @@ protected:
     // usual
     virtual void OnGetLinesHint(size_t lineMin, size_t lineMax) const { }
 
     // usual
     virtual void OnGetLinesHint(size_t lineMin, size_t lineMax) const { }
 
+    // when the number of lines changes, we try to estimate the total height
+    // of all lines which is a rather expensive operation in terms of lines
+    // access, so if the user code may estimate the average height
+    // better/faster than we do, it should override this function to implement
+    // its own logic
+    //
+    // this function should return the best guess for the total height it may
+    // make
+    virtual wxCoord EstimateTotalHeight() const;
+
 
     // the event handlers
     void OnSize(wxSizeEvent& event);
     void OnScroll(wxScrollWinEvent& event);
 
     // find the index of the line we need to show at the top of the window such
 
     // the event handlers
     void OnSize(wxSizeEvent& event);
     void OnScroll(wxScrollWinEvent& event);
 
     // find the index of the line we need to show at the top of the window such
-    // that the last line shown is the given one
-    size_t FindFirstFromBottom(size_t lineLast);
+    // that the last (fully or partially) visible line is the given one
+    size_t FindFirstFromBottom(size_t lineLast, bool fullyVisible = false);
 
     // get the total height of the lines between lineMin (inclusive) and
     // lineMax (exclusive)
 
     // get the total height of the lines between lineMin (inclusive) and
     // lineMax (exclusive)