#ifndef _WX_VSCROLL_H_
#define _WX_VSCROLL_H_
+#if defined(__GNUG__) && !defined(__APPLE__)
+#pragma interface "vscroll.h"
+#endif
+
#include "wx/panel.h" // base class
// ----------------------------------------------------------------------------
// 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,
// 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); }
+ // recalculate all our parameters and redisplay all lines
+ virtual void RefreshAll();
+
// accessors
// ---------
// 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
- // 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)