reverted wxHVScrolledWindow patch (rev 1.19/1.21 of vscroll.h/.cpp) because not only we don't want to duplicate code like this but it also broke wxHtmlListBox by making scrolling in it O(N) instead of O(1)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@38715 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
parent
fac6eaec24
commit
234b1c0147
@ -2,7 +2,7 @@
|
||||
// Name: include/wx/vscroll.h
|
||||
// Purpose: wxVScrolledWindow: generalization of wxScrolledWindow
|
||||
// Author: Vadim Zeitlin
|
||||
// Modified by: Brad Anderson
|
||||
// Modified by:
|
||||
// Created: 30.05.03
|
||||
// RCS-ID: $Id$
|
||||
// Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwidgets.org>
|
||||
@ -135,8 +135,6 @@ public:
|
||||
// is kept for backwards compatibility
|
||||
size_t GetLastVisibleLine() const { return GetVisibleEnd() - 1; }
|
||||
|
||||
// layout the children (including the sizer if needed)
|
||||
virtual bool Layout();
|
||||
|
||||
protected:
|
||||
// this function must be overridden in the derived class and it should
|
||||
@ -216,270 +214,5 @@ private:
|
||||
DECLARE_ABSTRACT_CLASS(wxVScrolledWindow)
|
||||
};
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// wxHVScrolledWindow
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
/*
|
||||
This class is strongly influenced by wxVScrolledWindow. In fact, much of
|
||||
code is line for line the same except it explicitly states which axis is
|
||||
being worked on. Like wxVScrolledWindow, this class is here to provide
|
||||
an easy way to implement variable line sizes. The difference is that
|
||||
wxVScrolledWindow only works with vertical scrolling. This class extends
|
||||
the behavior of wxVScrolledWindow to the horizontal axis in addition to the
|
||||
vertical axis.
|
||||
|
||||
The scrolling is also "virtual" in the sense that line widths and heights
|
||||
only need to be known for lines that are currently visible.
|
||||
|
||||
Like wxVScrolledWindow, this is a generalization of the wxScrolledWindow
|
||||
class which can be only used when all horizontal lines have the same width
|
||||
and all of the vertical lines have the same height. Like wxVScrolledWinow
|
||||
it lacks some of wxScrolledWindow features such as scrolling another window
|
||||
or only scrolling a rectangle of the window and not its entire client area.
|
||||
|
||||
If only vertical scrolling is needed, wxVScrolledWindow is recommended
|
||||
because it is simpler to use (and you get to type less).
|
||||
|
||||
There is no wxHScrolledWindow but horizontal only scrolling is implemented
|
||||
easily enough with this class. If someone feels the need for such a class,
|
||||
implementing it is trivial.
|
||||
*/
|
||||
class WXDLLEXPORT wxHVScrolledWindow : public wxPanel
|
||||
{
|
||||
public:
|
||||
// constructors and such
|
||||
// ---------------------
|
||||
|
||||
// default ctor, you must call Create() later
|
||||
wxHVScrolledWindow() { Init(); }
|
||||
|
||||
// normal ctor, no need to call Create() after this one
|
||||
//
|
||||
// note that wxVSCROLL and wxHSCROLL are always automatically added to our
|
||||
// style, there is no need to specify them explicitly
|
||||
wxHVScrolledWindow(wxWindow *parent,
|
||||
wxWindowID id = wxID_ANY,
|
||||
const wxPoint& pos = wxDefaultPosition,
|
||||
const wxSize& size = wxDefaultSize,
|
||||
long style = 0,
|
||||
const wxString& name = wxPanelNameStr)
|
||||
{
|
||||
Init();
|
||||
|
||||
(void)Create(parent, id, pos, size, style, name);
|
||||
}
|
||||
|
||||
// same as the previous ctor but returns status code: true if ok
|
||||
//
|
||||
// just as with the ctor above, wxVSCROLL and wxHSCROLL styles are always
|
||||
// used, there is no need to specify them
|
||||
bool Create(wxWindow *parent,
|
||||
wxWindowID id = wxID_ANY,
|
||||
const wxPoint& pos = wxDefaultPosition,
|
||||
const wxSize& size = wxDefaultSize,
|
||||
long style = 0,
|
||||
const wxString& name = wxPanelNameStr)
|
||||
{
|
||||
return wxPanel::Create(parent, id, pos, size,
|
||||
style | wxVSCROLL | wxHSCROLL, name);
|
||||
}
|
||||
|
||||
|
||||
// operations
|
||||
// ----------
|
||||
|
||||
// set the number of lines the window contains for each axis: the derived
|
||||
// class must provide the widths and heights for all lines with indices up
|
||||
// to each of the one given here in its OnGetColumnWidth() and
|
||||
// OnGetRowHeight()
|
||||
void SetRowColumnCounts(size_t rowCount, size_t columnCount);
|
||||
|
||||
// with physical scrolling on, the device origin is changed properly when
|
||||
// a wxPaintDC is prepared, children are actually moved and layed out
|
||||
// properly, and the contents of the window (pixels) are actually moved
|
||||
void EnablePhysicalScrolling(bool scrolling = true)
|
||||
{ m_physicalScrolling = scrolling; }
|
||||
|
||||
// scroll to the specified line: it will become the first visible line in
|
||||
// the window
|
||||
//
|
||||
// return true if we scrolled the window, false if nothing was done
|
||||
bool ScrollToRow(size_t row);
|
||||
bool ScrollToColumn(size_t column);
|
||||
bool ScrollToRowColumn(size_t row, size_t column);
|
||||
|
||||
// scroll by the specified number of lines/pages
|
||||
virtual bool ScrollRows(int rows);
|
||||
virtual bool ScrollColumns(int columns);
|
||||
virtual bool ScrollRowsColumns(int rows, int columns);
|
||||
virtual bool ScrollRowPages(int pages);
|
||||
virtual bool ScrollColumnPages(int pages);
|
||||
virtual bool ScrollPages(int rowPages, int columnPages);
|
||||
|
||||
// redraw the specified line
|
||||
virtual void RefreshRow(size_t line);
|
||||
virtual void RefreshColumn(size_t line);
|
||||
virtual void RefreshRowColumn(size_t row, size_t column);
|
||||
|
||||
// redraw all lines in the specified range (inclusive)
|
||||
virtual void RefreshRows(size_t from, size_t to);
|
||||
virtual void RefreshColumns(size_t from, size_t to);
|
||||
virtual void RefreshRowsColumns(size_t fromRow, size_t toRow,
|
||||
size_t fromColumn, size_t toColumn);
|
||||
|
||||
// return the horizontal and vertical line within a wxPoint at the
|
||||
// specified (in physical coordinates) position or.
|
||||
|
||||
// wxNOT_FOUND in either or both axes if no line is present at the
|
||||
// requested coordinates, i.e. if it is past the last lines
|
||||
wxPoint HitTest(wxCoord x, wxCoord y) const;
|
||||
wxPoint HitTest(const wxPoint& pt) const { return HitTest(pt.x, pt.y); }
|
||||
|
||||
// recalculate all our parameters and redisplay all lines
|
||||
virtual void RefreshAll();
|
||||
|
||||
|
||||
// accessors
|
||||
// ---------
|
||||
|
||||
// get the number of lines this window contains (previously set by
|
||||
// SetLineCount())
|
||||
size_t GetRowCount() const { return m_rowsMax; }
|
||||
size_t GetColumnCount() const { return m_columnsMax; }
|
||||
wxSize GetRowColumnCounts() const
|
||||
{ return wxSize((int)m_columnsMax, (int)m_rowsMax); }
|
||||
|
||||
// get the first currently visible line/lines
|
||||
size_t GetVisibleRowsBegin() const { return m_rowsFirst; }
|
||||
size_t GetVisibleColumnsBegin() const { return m_columnsFirst; }
|
||||
wxPoint GetVisibleBegin() const
|
||||
{ return wxPoint((int)m_columnsFirst, (int)m_rowsFirst); }
|
||||
|
||||
// get the last currently visible line/lines
|
||||
size_t GetVisibleRowsEnd() const
|
||||
{ return m_rowsFirst + m_nRowsVisible; }
|
||||
size_t GetVisibleColumnsEnd() const
|
||||
{ return m_columnsFirst + m_nColumnsVisible; }
|
||||
wxPoint GetVisibleEnd() const
|
||||
{ return wxPoint((int)(m_columnsFirst + m_nColumnsVisible),
|
||||
(int)(m_rowsFirst + m_nRowsVisible)); }
|
||||
|
||||
// is this line currently visible?
|
||||
bool IsRowVisible(size_t row) const
|
||||
{ return row >= m_rowsFirst &&
|
||||
row < GetVisibleRowsEnd(); }
|
||||
bool IsColumnVisible(size_t column) const
|
||||
{ return column >= m_columnsFirst &&
|
||||
column < GetVisibleColumnsEnd(); }
|
||||
bool IsVisible(size_t row, size_t column) const
|
||||
{ return IsRowVisible(row) && IsColumnVisible(column); }
|
||||
|
||||
// layout the children (including the sizer if needed)
|
||||
virtual bool Layout();
|
||||
|
||||
protected:
|
||||
// these functions must be overridden in the derived class and they should
|
||||
// return the width or height of the given line in pixels
|
||||
virtual wxCoord OnGetRowHeight(size_t n) const = 0;
|
||||
virtual wxCoord OnGetColumnWidth(size_t n) const = 0;
|
||||
|
||||
// the following functions don't need to be overridden but it may be useful
|
||||
// to do if calculating the lines widths or heights is a relatively
|
||||
// expensive operation as it gives the user code a possibility to calculate
|
||||
// several of them at once
|
||||
//
|
||||
// OnGetRowsHeightHint() and OnGetColumnsWidthHint() are normally called
|
||||
// just before OnGetRowHeight() and OnGetColumnWidth(), respectively, but
|
||||
// you shouldn't rely on the latter methods being called for all lines in
|
||||
// the interval specified here. It is also possible that OnGetRowHeight()
|
||||
// or OnGetColumnWidth() will be called for the lines outside of this
|
||||
// interval, so this is really just a hint, not a promise.
|
||||
//
|
||||
// finally note that min is inclusive, while max is exclusive, as usual
|
||||
virtual void OnGetRowsHeightHint(size_t WXUNUSED(rowMin),
|
||||
size_t WXUNUSED(rowMax)) const { }
|
||||
virtual void OnGetColumnsWidthHint(size_t WXUNUSED(columnMin),
|
||||
size_t WXUNUSED(columnMax)) const { }
|
||||
|
||||
// when the number of lines changes, we try to estimate the total width or
|
||||
// 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;
|
||||
virtual wxCoord EstimateTotalWidth() const;
|
||||
|
||||
// the event handlers
|
||||
void OnSize(wxSizeEvent& event);
|
||||
void OnScroll(wxScrollWinEvent& event);
|
||||
#if wxUSE_MOUSEWHEEL
|
||||
void OnMouseWheel(wxMouseEvent& event);
|
||||
#endif
|
||||
|
||||
|
||||
// find the index of the horizontal line we need to show at the top of the
|
||||
// window such that the last (fully or partially) visible line is the given
|
||||
// one
|
||||
size_t FindFirstFromRight(size_t columnLast, bool fullyVisible = false);
|
||||
|
||||
// find the index of the vertical line we need to show at the top of the
|
||||
// window such that the last (fully or partially) visible line is the given
|
||||
// one
|
||||
size_t FindFirstFromBottom(size_t rowLast, bool fullyVisible = false);
|
||||
|
||||
|
||||
// get the total width or height of the lines between lineMin (inclusive)
|
||||
// and lineMax (exclusive)
|
||||
wxCoord GetRowsHeight(size_t rowMin, size_t rowMax) const;
|
||||
wxCoord GetColumnsWidth(size_t columnMin, size_t columnMax) const;
|
||||
|
||||
// update the thumb size shown by the scrollbar
|
||||
void UpdateScrollbars();
|
||||
|
||||
// shifts the specified dc by the scroll position
|
||||
void PrepareDC(wxDC& dc);
|
||||
|
||||
private:
|
||||
// common part of all ctors
|
||||
void Init();
|
||||
|
||||
|
||||
// the total number of (logical) lines for each axis
|
||||
size_t m_rowsMax;
|
||||
size_t m_columnsMax;
|
||||
|
||||
// the total (estimated) height
|
||||
wxCoord m_heightTotal;
|
||||
|
||||
// the total (estimated) width
|
||||
wxCoord m_widthTotal;
|
||||
|
||||
// the first currently visible line on each axis
|
||||
size_t m_rowsFirst;
|
||||
size_t m_columnsFirst;
|
||||
|
||||
// the number of currently visible lines for each axis (including the last,
|
||||
// possibly only partly, visible one)
|
||||
size_t m_nRowsVisible;
|
||||
size_t m_nColumnsVisible;
|
||||
|
||||
// accumulated mouse wheel rotation
|
||||
#if wxUSE_MOUSEWHEEL
|
||||
int m_sumWheelRotation;
|
||||
#endif
|
||||
|
||||
// do child scrolling (used in DoPrepareDC())
|
||||
bool m_physicalScrolling;
|
||||
|
||||
DECLARE_EVENT_TABLE()
|
||||
DECLARE_NO_COPY_CLASS(wxHVScrolledWindow)
|
||||
DECLARE_ABSTRACT_CLASS(wxHVScrolledWindow)
|
||||
};
|
||||
|
||||
#endif // _WX_VSCROLL_H_
|
||||
|
||||
|
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user