src/generic/vscroll.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/generic/vscroll.cpp
   3 // Purpose:     wxVScrolledWindow implementation
   4 // Author:      Vadim Zeitlin
   5 // Modified by: Brad Anderson, David Warkentin
   6 // Created:     30.05.03
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2003 Vadim Zeitlin <vadim@wxwindows.org>
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 // For compilers that support precompilation, includes "wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #ifdef __BORLANDC__
  24 #pragma hdrstop
  25 #endif
  26
  27 #ifndef WX_PRECOMP
  28     #include "wx/dc.h"
  29     #include "wx/sizer.h"
  30 #endif
  31
  32 #include "wx/vscroll.h"
  33
  34 // ============================================================================
  35 // wxVarScrollHelperEvtHandler declaration
  36 // ============================================================================
  37
  38 // ----------------------------------------------------------------------------
  39 // wxScrollHelperEvtHandler: intercept the events from the window and forward
  40 // them to wxVarScrollHelperBase
  41 // ----------------------------------------------------------------------------
  42
  43 class WXDLLEXPORT wxVarScrollHelperEvtHandler : public wxEvtHandler
  44 {
  45 public:
  46     wxVarScrollHelperEvtHandler(wxVarScrollHelperBase *scrollHelper)
  47     {
  48         m_scrollHelper = scrollHelper;
  49     }
  50
  51     virtual bool ProcessEvent(wxEvent& event);
  52
  53 private:
  54     wxVarScrollHelperBase *m_scrollHelper;
  55
  56     DECLARE_NO_COPY_CLASS(wxVarScrollHelperEvtHandler)
  57 };
  58
  59 // ============================================================================
  60 // wxVarScrollHelperEvtHandler implementation
  61 // ============================================================================
  62
  63 bool wxVarScrollHelperEvtHandler::ProcessEvent(wxEvent& event)
  64 {
  65     wxEventType evType = event.GetEventType();
  66
  67     // pass it on to the real handler
  68     bool processed = wxEvtHandler::ProcessEvent(event);
  69
  70     // always process the size events ourselves, even if the user code handles
  71     // them as well, as we need to AdjustScrollbars()
  72     //
  73     // NB: it is important to do it after processing the event in the normal
  74     //     way as HandleOnSize() may generate a wxEVT_SIZE itself if the
  75     //     scrollbar[s] (dis)appear and it should be seen by the user code
  76     //     after this one
  77     if ( evType == wxEVT_SIZE )
  78     {
  79         m_scrollHelper->HandleOnSize((wxSizeEvent &)event);
  80
  81         return !event.GetSkipped();
  82     }
  83
  84     if ( processed )
  85     {
  86         // normally, nothing more to do here - except if we have a command
  87         // event
  88         if ( event.IsCommandEvent() )
  89         {
  90             return true;
  91         }
  92     }
  93
  94     // reset the skipped flag (which might have been set to true in
  95     // ProcessEvent() above) to be able to test it below
  96     bool wasSkipped = event.GetSkipped();
  97     if ( wasSkipped )
  98         event.Skip(false);
  99
 100     // reset the skipped flag to false as it might have been set to true in
 101     // ProcessEvent() above
 102     event.Skip(false);
 103
 104     if ( evType == wxEVT_SCROLLWIN_TOP ||
 105          evType == wxEVT_SCROLLWIN_BOTTOM ||
 106          evType == wxEVT_SCROLLWIN_LINEUP ||
 107          evType == wxEVT_SCROLLWIN_LINEDOWN ||
 108          evType == wxEVT_SCROLLWIN_PAGEUP ||
 109          evType == wxEVT_SCROLLWIN_PAGEDOWN ||
 110          evType == wxEVT_SCROLLWIN_THUMBTRACK ||
 111          evType == wxEVT_SCROLLWIN_THUMBRELEASE )
 112     {
 113         m_scrollHelper->HandleOnScroll((wxScrollWinEvent &)event);
 114         if ( !event.GetSkipped() )
 115         {
 116             // it makes sense to indicate that we processed the message as we
 117             // did scroll the window (and also notice that wxAutoScrollTimer
 118             // relies on our return value for continuous scrolling)
 119             processed = true;
 120             wasSkipped = false;
 121         }
 122     }
 123 #if wxUSE_MOUSEWHEEL
 124     else if ( evType == wxEVT_MOUSEWHEEL )
 125     {
 126         m_scrollHelper->HandleOnMouseWheel((wxMouseEvent &)event);
 127     }
 128 #endif // wxUSE_MOUSEWHEEL
 129
 130     if ( processed )
 131         event.Skip(wasSkipped);
 132
 133     return processed;
 134 }
 135
 136
 137 // ============================================================================
 138 // wxVarScrollHelperBase implementation
 139 // ============================================================================
 140
 141 // ----------------------------------------------------------------------------
 142 // wxVarScrollHelperBase initialization
 143 // ----------------------------------------------------------------------------
 144
 145 wxVarScrollHelperBase::wxVarScrollHelperBase(wxWindow *win)
 146 {
 147     wxASSERT_MSG( win, _T("associated window can't be NULL in wxVarScrollHelperBase") );
 148
 149 #if wxUSE_MOUSEWHEEL
 150     m_sumWheelRotation = 0;
 151 #endif
 152
 153     m_unitMax = 0;
 154     m_sizeTotal = 0;
 155     m_unitFirst = 0;
 156
 157     m_win =
 158     m_targetWindow = NULL;
 159
 160     m_physicalScrolling = true;
 161     m_handler = NULL;
 162
 163     m_win = win;
 164
 165     // by default, the associated window is also the target window
 166     DoSetTargetWindow(win);
 167
 168 }
 169
 170 wxVarScrollHelperBase::~wxVarScrollHelperBase()
 171 {
 172     DeleteEvtHandler();
 173 }
 174
 175 // ----------------------------------------------------------------------------
 176 // wxVarScrollHelperBase various helpers
 177 // ----------------------------------------------------------------------------
 178
 179 void
 180 wxVarScrollHelperBase::AssignOrient(wxCoord& x,
 181                                     wxCoord& y,
 182                                     wxCoord first,
 183                                     wxCoord second)
 184 {
 185     if ( GetOrientation() == wxVERTICAL )
 186     {
 187         x = first;
 188         y = second;
 189     }
 190     else // horizontal
 191     {
 192         x = second;
 193         y = first;
 194     }
 195 }
 196
 197 void
 198 wxVarScrollHelperBase::IncOrient(wxCoord& x, wxCoord& y, wxCoord inc)
 199 {
 200     if ( GetOrientation() == wxVERTICAL )
 201         y += inc;
 202     else
 203         x += inc;
 204 }
 205
 206 wxCoord wxVarScrollHelperBase::DoEstimateTotalSize() const
 207 {
 208     // estimate the total height: it is impossible to call
 209     // OnGetUnitSize() for every unit because there may be too many of
 210     // them, so we just make a guess using some units in the beginning,
 211     // some in the end and some in the middle
 212     static const size_t NUM_UNITS_TO_SAMPLE = 10;
 213
 214     wxCoord sizeTotal;
 215     if ( m_unitMax < 3*NUM_UNITS_TO_SAMPLE )
 216     {
 217         // in this case, full calculations are faster and more correct than
 218         // guessing
 219         sizeTotal = GetUnitsSize(0, m_unitMax);
 220     }
 221     else // too many units to calculate exactly
 222     {
 223         // look at some units in the beginning/middle/end
 224         sizeTotal =
 225             GetUnitsSize(0, NUM_UNITS_TO_SAMPLE) +
 226                 GetUnitsSize(m_unitMax - NUM_UNITS_TO_SAMPLE,
 227                              m_unitMax) +
 228                     GetUnitsSize(m_unitMax/2 - NUM_UNITS_TO_SAMPLE/2,
 229                                  m_unitMax/2 + NUM_UNITS_TO_SAMPLE/2);
 230
 231         // use the height of the units we looked as the average
 232         sizeTotal = (wxCoord)
 233                 (((float)sizeTotal / (3*NUM_UNITS_TO_SAMPLE)) * m_unitMax);
 234     }
 235
 236     return sizeTotal;
 237 }
 238
 239 wxCoord wxVarScrollHelperBase::GetUnitsSize(size_t unitMin, size_t unitMax) const
 240 {
 241     if ( unitMin == unitMax )
 242         return 0;
 243     else if ( unitMin > unitMax )
 244         return -GetUnitsSize(unitMax, unitMin);
 245     //else: unitMin < unitMax
 246
 247     // let the user code know that we're going to need all these units
 248     OnGetUnitsSizeHint(unitMin, unitMax);
 249
 250     // sum up their sizes
 251     wxCoord size = 0;
 252     for ( size_t unit = unitMin; unit < unitMax; ++unit )
 253     {
 254         size += OnGetUnitSize(unit);
 255     }
 256
 257     return size;
 258 }
 259
 260 size_t wxVarScrollHelperBase::FindFirstVisibleFromLast(size_t unitLast, bool full) const
 261 {
 262     const wxCoord sWindow = GetOrientationTargetSize();
 263
 264     // go upwards until we arrive at a unit such that unitLast is not visible
 265     // any more when it is shown
 266     size_t unitFirst = unitLast;
 267     wxCoord s = 0;
 268     for ( ;; )
 269     {
 270         s += OnGetUnitSize(unitFirst);
 271
 272         if ( s > sWindow )
 273         {
 274             // for this unit to be fully visible we need to go one unit
 275             // down, but if it is enough for it to be only partly visible then
 276             // this unit will do as well
 277             if ( full )
 278             {
 279                 ++unitFirst;
 280             }
 281
 282             break;
 283         }
 284
 285         if ( !unitFirst )
 286             break;
 287
 288         --unitFirst;
 289     }
 290
 291     return unitFirst;
 292 }
 293
 294 size_t wxVarScrollHelperBase::GetNewScrollPosition(wxScrollWinEvent& event) const
 295 {
 296     wxEventType evtType = event.GetEventType();
 297
 298     if ( evtType == wxEVT_SCROLLWIN_TOP )
 299     {
 300         return 0;
 301     }
 302     else if ( evtType == wxEVT_SCROLLWIN_BOTTOM )
 303     {
 304         return m_unitMax;
 305     }
 306     else if ( evtType == wxEVT_SCROLLWIN_LINEUP )
 307     {
 308         return m_unitFirst ? m_unitFirst - 1 : 0;
 309     }
 310     else if ( evtType == wxEVT_SCROLLWIN_LINEDOWN )
 311     {
 312         return m_unitFirst + 1;
 313     }
 314     else if ( evtType == wxEVT_SCROLLWIN_PAGEUP )
 315     {
 316         return FindFirstVisibleFromLast(m_unitFirst);
 317     }
 318     else if ( evtType == wxEVT_SCROLLWIN_PAGEDOWN )
 319     {
 320         if ( GetVisibleEnd() )
 321             return GetVisibleEnd() - 1;
 322         else
 323             return GetVisibleEnd();
 324     }
 325     else if ( evtType == wxEVT_SCROLLWIN_THUMBRELEASE )
 326     {
 327         return event.GetPosition();
 328     }
 329     else if ( evtType == wxEVT_SCROLLWIN_THUMBTRACK )
 330     {
 331         return event.GetPosition();
 332     }
 333
 334     // unknown scroll event?
 335     wxFAIL_MSG( _T("unknown scroll event type?") );
 336     return 0;
 337 }
 338
 339 void wxVarScrollHelperBase::UpdateScrollbar()
 340 {
 341     // if there is nothing to scroll, remove the scrollbar
 342     if ( !m_unitMax )
 343     {
 344         RemoveScrollbar();
 345         return;
 346     }
 347
 348     // see how many units can we fit on screen
 349     const wxCoord sWindow = GetOrientationTargetSize();
 350
 351     // do vertical calculations
 352     wxCoord s = 0;
 353     size_t unit;
 354     for ( unit = m_unitFirst; unit < m_unitMax; ++unit )
 355     {
 356         if ( s > sWindow )
 357             break;
 358
 359         s += OnGetUnitSize(unit);
 360     }
 361
 362     m_nUnitsVisible = unit - m_unitFirst;
 363
 364     int unitsPageSize = m_nUnitsVisible;
 365     if ( s > sWindow )
 366     {
 367         // last unit is only partially visible, we still need the scrollbar and
 368         // so we have to "fix" pageSize because if it is equal to m_unitMax
 369         // the scrollbar is not shown at all under MSW
 370         --unitsPageSize;
 371     }
 372
 373     // set the scrollbar parameters to reflect this
 374     m_win->SetScrollbar(GetOrientation(), m_unitFirst, unitsPageSize, m_unitMax);
 375 }
 376
 377 void wxVarScrollHelperBase::RemoveScrollbar()
 378 {
 379     m_unitFirst = 0;
 380     m_nUnitsVisible = m_unitMax;
 381     m_win->SetScrollbar(GetOrientation(), 0, 0, 0);
 382 }
 383
 384 void wxVarScrollHelperBase::DeleteEvtHandler()
 385 {
 386     // search for m_handler in the handler list
 387     if ( m_win && m_handler )
 388     {
 389         if ( m_win->RemoveEventHandler(m_handler) )
 390         {
 391             delete m_handler;
 392         }
 393         //else: something is very wrong, so better [maybe] leak memory than
 394         //      risk a crash because of double deletion
 395
 396         m_handler = NULL;
 397     }
 398 }
 399
 400 void wxVarScrollHelperBase::DoSetTargetWindow(wxWindow *target)
 401 {
 402     m_targetWindow = target;
 403 #ifdef __WXMAC__
 404     target->MacSetClipChildren( true ) ;
 405 #endif
 406
 407     // install the event handler which will intercept the events we're
 408     // interested in (but only do it for our real window, not the target window
 409     // which we scroll - we don't need to hijack its events)
 410     if ( m_targetWindow == m_win )
 411     {
 412         // if we already have a handler, delete it first
 413         DeleteEvtHandler();
 414
 415         m_handler = new wxVarScrollHelperEvtHandler(this);
 416         m_targetWindow->PushEventHandler(m_handler);
 417     }
 418 }
 419
 420 // ----------------------------------------------------------------------------
 421 // wxVarScrollHelperBase operations
 422 // ----------------------------------------------------------------------------
 423
 424 void wxVarScrollHelperBase::SetTargetWindow(wxWindow *target)
 425 {
 426     wxCHECK_RET( target, wxT("target window must not be NULL") );
 427
 428     if ( target == m_targetWindow )
 429         return;
 430
 431     DoSetTargetWindow(target);
 432 }
 433
 434 void wxVarScrollHelperBase::SetUnitCount(size_t count)
 435 {
 436     // save the number of units
 437     m_unitMax = count;
 438
 439     // and our estimate for their total height
 440     m_sizeTotal = EstimateTotalSize();
 441
 442     // ScrollToUnit() will update the scrollbar itself if it changes the unit
 443     // we pass to it because it's out of [new] range
 444     size_t oldScrollPos = m_unitFirst;
 445     DoScrollToUnit(m_unitFirst);
 446     if ( oldScrollPos == m_unitFirst )
 447     {
 448         // but if it didn't do it, we still need to update the scrollbar to
 449         // reflect the changed number of units ourselves
 450         UpdateScrollbar();
 451     }
 452 }
 453
 454 void wxVarScrollHelperBase::RefreshUnit(size_t unit)
 455 {
 456     // is this unit visible?
 457     if ( !IsVisible(unit) )
 458     {
 459         // no, it is useless to do anything
 460         return;
 461     }
 462
 463     // calculate the rect occupied by this unit on screen
 464     wxRect rect;
 465     AssignOrient(rect.width, rect.height,
 466                  GetNonOrientationTargetSize(), OnGetUnitSize(unit));
 467
 468     for ( size_t n = GetVisibleBegin(); n < unit; ++n )
 469     {
 470         IncOrient(rect.x, rect.y, OnGetUnitSize(n));
 471     }
 472
 473     // do refresh it
 474     m_targetWindow->RefreshRect(rect);
 475 }
 476
 477 void wxVarScrollHelperBase::RefreshUnits(size_t from, size_t to)
 478 {
 479     wxASSERT_MSG( from <= to, _T("RefreshUnits(): empty range") );
 480
 481     // clump the range to just the visible units -- it is useless to refresh
 482     // the other ones
 483     if ( from < GetVisibleBegin() )
 484         from = GetVisibleBegin();
 485
 486     if ( to > GetVisibleEnd() )
 487         to = GetVisibleEnd();
 488
 489     // calculate the rect occupied by these units on screen
 490     int orient_size, nonorient_size, orient_pos;
 491     orient_size = nonorient_size = orient_pos = 0;
 492
 493     nonorient_size = GetNonOrientationTargetSize();
 494
 495     for ( size_t nBefore = GetVisibleBegin();
 496           nBefore < from;
 497           nBefore++ )
 498     {
 499         orient_pos += OnGetUnitSize(nBefore);
 500     }
 501
 502     for ( size_t nBetween = from; nBetween <= to; nBetween++ )
 503     {
 504         orient_size += OnGetUnitSize(nBetween);
 505     }
 506
 507     wxRect rect;
 508     AssignOrient(rect.x, rect.y, 0, orient_pos);
 509     AssignOrient(rect.width, rect.height, nonorient_size, orient_size);
 510
 511     // do refresh it
 512     m_targetWindow->RefreshRect(rect);
 513 }
 514
 515 void wxVarScrollHelperBase::RefreshAll()
 516 {
 517     UpdateScrollbar();
 518
 519     m_targetWindow->Refresh();
 520 }
 521
 522 bool wxVarScrollHelperBase::ScrollLayout()
 523 {
 524     if ( m_targetWindow->GetSizer() && m_physicalScrolling )
 525     {
 526         // adjust the sizer dimensions/position taking into account the
 527         // virtual size and scrolled position of the window.
 528
 529         int x, y;
 530         AssignOrient(x, y, 0, -GetScrollOffset());
 531
 532         int w, h;
 533         m_targetWindow->GetVirtualSize(&w, &h);
 534
 535         m_targetWindow->GetSizer()->SetDimension(x, y, w, h);
 536         return true;
 537     }
 538
 539     // fall back to default for LayoutConstraints
 540     return m_targetWindow->wxWindow::Layout();
 541 }
 542
 543 int wxVarScrollHelperBase::VirtualHitTest(wxCoord coord) const
 544 {
 545     const size_t unitMax = GetVisibleEnd();
 546     for ( size_t unit = GetVisibleBegin(); unit < unitMax; ++unit )
 547     {
 548         coord -= OnGetUnitSize(unit);
 549         if ( coord < 0 )
 550             return unit;
 551     }
 552
 553     return wxNOT_FOUND;
 554 }
 555
 556 // ----------------------------------------------------------------------------
 557 // wxVarScrollHelperBase scrolling
 558 // ----------------------------------------------------------------------------
 559
 560 bool wxVarScrollHelperBase::DoScrollToUnit(size_t unit)
 561 {
 562     if ( !m_unitMax )
 563     {
 564         // we're empty, code below doesn't make sense in this case
 565         return false;
 566     }
 567
 568     // determine the real first unit to scroll to: we shouldn't scroll beyond
 569     // the end
 570     size_t unitFirstLast = FindFirstVisibleFromLast(m_unitMax - 1, true);
 571     if ( unit > unitFirstLast )
 572         unit = unitFirstLast;
 573
 574     // anything to do?
 575     if ( unit == m_unitFirst )
 576     {
 577         // no
 578         return false;
 579     }
 580
 581
 582     // remember the currently shown units for the refresh code below
 583     size_t unitFirstOld = GetVisibleBegin(),
 584            unitLastOld = GetVisibleEnd();
 585
 586     m_unitFirst = unit;
 587
 588
 589     // the size of scrollbar thumb could have changed
 590     UpdateScrollbar();
 591
 592     // finally refresh the display -- but only redraw as few units as possible
 593     // to avoid flicker.  We can't do this if we have children because they
 594     // won't be scrolled
 595     if ( m_targetWindow->GetChildren().empty() &&
 596          (GetVisibleBegin() >= unitLastOld || GetVisibleEnd() <= unitFirstOld) )
 597     {
 598         // the simplest case: we don't have any old units left, just redraw
 599         // everything
 600         m_targetWindow->Refresh();
 601     }
 602     else // scroll the window
 603     {
 604         // Avoid scrolling visible parts of the screen on Mac
 605 #ifdef __WXMAC__
 606         if (m_physicalScrolling && m_targetWindow->IsShownOnScreen())
 607 #else
 608         if ( m_physicalScrolling )
 609 #endif
 610         {
 611             wxCoord dx = 0,
 612                     dy = GetUnitsSize(GetVisibleBegin(), unitFirstOld);
 613
 614             if ( GetOrientation() == wxHORIZONTAL )
 615             {
 616                 wxCoord tmp = dx;
 617                 dx = dy;
 618                 dy = tmp;
 619             }
 620
 621             m_targetWindow->ScrollWindow(dx, dy);
 622         }
 623         else // !m_physicalScrolling
 624         {
 625             // we still need to invalidate but we can't use ScrollWindow
 626             // because physical scrolling is disabled (the user either didn't
 627             // want children scrolled and/or doesn't want pixels to be
 628             // physically scrolled).
 629             m_targetWindow->Refresh();
 630         }
 631     }
 632
 633     return true;
 634 }
 635
 636 bool wxVarScrollHelperBase::DoScrollUnits(int units)
 637 {
 638     units += m_unitFirst;
 639     if ( units < 0 )
 640         units = 0;
 641
 642     return DoScrollToUnit(units);
 643 }
 644
 645 bool wxVarScrollHelperBase::DoScrollPages(int pages)
 646 {
 647     bool didSomething = false;
 648
 649     while ( pages )
 650     {
 651         int unit;
 652         if ( pages > 0 )
 653         {
 654             unit = GetVisibleEnd();
 655             if ( unit )
 656                 --unit;
 657             --pages;
 658         }
 659         else // pages < 0
 660         {
 661             unit = FindFirstVisibleFromLast(GetVisibleEnd());
 662             ++pages;
 663         }
 664
 665         didSomething = DoScrollToUnit(unit);
 666     }
 667
 668     return didSomething;
 669 }
 670
 671 // ----------------------------------------------------------------------------
 672 // event handling
 673 // ----------------------------------------------------------------------------
 674
 675 void wxVarScrollHelperBase::HandleOnSize(wxSizeEvent& event)
 676 {
 677     UpdateScrollbar();
 678
 679     event.Skip();
 680 }
 681
 682 void wxVarScrollHelperBase::HandleOnScroll(wxScrollWinEvent& event)
 683 {
 684     if (GetOrientation() != event.GetOrientation())
 685     {
 686         event.Skip();
 687         return;
 688     }
 689
 690     DoScrollToUnit(GetNewScrollPosition(event));
 691
 692 #ifdef __WXMAC__
 693     UpdateMacScrollWindow();
 694 #endif // __WXMAC__
 695 }
 696
 697 void wxVarScrollHelperBase::DoPrepareDC(wxDC& dc)
 698 {
 699     if ( m_physicalScrolling )
 700     {
 701         wxPoint pt = dc.GetDeviceOrigin();
 702
 703         IncOrient(pt.x, pt.y, -GetScrollOffset());
 704
 705         dc.SetDeviceOrigin(pt.x, pt.y);
 706     }
 707 }
 708
 709 int wxVarScrollHelperBase::DoCalcScrolledPosition(int coord) const
 710 {
 711     return coord - GetScrollOffset();
 712 }
 713
 714 int wxVarScrollHelperBase::DoCalcUnscrolledPosition(int coord) const
 715 {
 716     return coord + GetScrollOffset();
 717 }
 718
 719 #if wxUSE_MOUSEWHEEL
 720
 721 void wxVarScrollHelperBase::HandleOnMouseWheel(wxMouseEvent& event)
 722 {
 723     // we only want to process wheel events for vertical implementations.
 724     // There is no way to determine wheel orientation (and on MSW horizontal
 725     // wheel rotation just fakes scroll events, rather than sending a MOUSEWHEEL
 726     // event).
 727     if ( GetOrientation() != wxVERTICAL )
 728         return;
 729
 730     m_sumWheelRotation += event.GetWheelRotation();
 731     int delta = event.GetWheelDelta();
 732
 733     // how much to scroll this time
 734     int units_to_scroll = -(m_sumWheelRotation/delta);
 735     if ( !units_to_scroll )
 736         return;
 737
 738     m_sumWheelRotation += units_to_scroll*delta;
 739
 740     if ( !event.IsPageScroll() )
 741         DoScrollUnits( units_to_scroll*event.GetLinesPerAction() );
 742     else // scroll pages instead of units
 743         DoScrollPages( units_to_scroll );
 744 }
 745
 746 #endif // wxUSE_MOUSEWHEEL
 747
 748
 749 // ============================================================================
 750 // wxVarHVScrollHelper implementation
 751 // ============================================================================
 752
 753 // ----------------------------------------------------------------------------
 754 // wxVarHVScrollHelper operations
 755 // ----------------------------------------------------------------------------
 756
 757 void wxVarHVScrollHelper::SetRowColumnCount(size_t rowCount, size_t columnCount)
 758 {
 759     SetRowCount(rowCount);
 760     SetColumnCount(columnCount);
 761 }
 762
 763 bool wxVarHVScrollHelper::ScrollToRowColumn(size_t row, size_t column)
 764 {
 765     bool result = false;
 766     result |= ScrollToRow(row);
 767     result |= ScrollToColumn(column);
 768     return result;
 769 }
 770
 771 void wxVarHVScrollHelper::RefreshRowColumn(size_t row, size_t column)
 772 {
 773     // is this unit visible?
 774     if ( !IsRowVisible(row) || !IsColumnVisible(column) )
 775     {
 776         // no, it is useless to do anything
 777         return;
 778     }
 779
 780     // calculate the rect occupied by this cell on screen
 781     wxRect v_rect, h_rect;
 782     v_rect.height = OnGetRowHeight(row);
 783     h_rect.width = OnGetColumnWidth(column);
 784
 785     size_t n;
 786
 787     for ( n = GetVisibleRowsBegin(); n < row; n++ )
 788     {
 789         v_rect.y += OnGetRowHeight(n);
 790     }
 791
 792     for ( n = GetVisibleColumnsBegin(); n < column; n++ )
 793     {
 794         h_rect.x += OnGetColumnWidth(n);
 795     }
 796
 797     // refresh but specialize the behavior if we have a single target window
 798     if ( wxVarVScrollHelper::GetTargetWindow() == wxVarHScrollHelper::GetTargetWindow() )
 799     {
 800         v_rect.x = h_rect.x;
 801         v_rect.width = h_rect.width;
 802         wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect);
 803     }
 804     else
 805     {
 806         v_rect.x = 0;
 807         v_rect.width = wxVarVScrollHelper::GetNonOrientationTargetSize();
 808         h_rect.y = 0;
 809         h_rect.width = wxVarHScrollHelper::GetNonOrientationTargetSize();
 810
 811         wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect);
 812         wxVarHScrollHelper::GetTargetWindow()->RefreshRect(h_rect);
 813     }
 814 }
 815
 816 void wxVarHVScrollHelper::RefreshRowsColumns(size_t fromRow, size_t toRow,
 817                                              size_t fromColumn, size_t toColumn)
 818 {
 819     wxASSERT_MSG( fromRow <= toRow || fromColumn <= toColumn,
 820         _T("RefreshRowsColumns(): empty range") );
 821
 822     // clump the range to just the visible units -- it is useless to refresh
 823     // the other ones
 824     if ( fromRow < GetVisibleRowsBegin() )
 825         fromRow = GetVisibleRowsBegin();
 826
 827     if ( toRow > GetVisibleRowsEnd() )
 828         toRow = GetVisibleRowsEnd();
 829
 830     if ( fromColumn < GetVisibleColumnsBegin() )
 831         fromColumn = GetVisibleColumnsBegin();
 832
 833     if ( toColumn > GetVisibleColumnsEnd() )
 834         toColumn = GetVisibleColumnsEnd();
 835
 836     // calculate the rect occupied by these units on screen
 837     wxRect v_rect, h_rect;
 838     size_t nBefore, nBetween;
 839
 840     for ( nBefore = GetVisibleRowsBegin();
 841           nBefore < fromRow;
 842           nBefore++ )
 843     {
 844         v_rect.y += OnGetRowHeight(nBefore);
 845     }
 846
 847     for ( nBetween = fromRow; nBetween <= toRow; nBetween++ )
 848     {
 849         v_rect.height += OnGetRowHeight(nBetween);
 850     }
 851
 852     for ( nBefore = GetVisibleColumnsBegin();
 853           nBefore < fromColumn;
 854           nBefore++ )
 855     {
 856         h_rect.x += OnGetColumnWidth(nBefore);
 857     }
 858
 859     for ( nBetween = fromColumn; nBetween <= toColumn; nBetween++ )
 860     {
 861         h_rect.width += OnGetColumnWidth(nBetween);
 862     }
 863
 864     // refresh but specialize the behavior if we have a single target window
 865     if ( wxVarVScrollHelper::GetTargetWindow() == wxVarHScrollHelper::GetTargetWindow() )
 866     {
 867         v_rect.x = h_rect.x;
 868         v_rect.width = h_rect.width;
 869         wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect);
 870     }
 871     else
 872     {
 873         v_rect.x = 0;
 874         v_rect.width = wxVarVScrollHelper::GetNonOrientationTargetSize();
 875         h_rect.y = 0;
 876         h_rect.width = wxVarHScrollHelper::GetNonOrientationTargetSize();
 877
 878         wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect);
 879         wxVarHScrollHelper::GetTargetWindow()->RefreshRect(h_rect);
 880     }
 881 }
 882
 883 wxPosition wxVarHVScrollHelper::VirtualHitTest(wxCoord x, wxCoord y) const
 884 {
 885     return wxPosition(wxVarVScrollHelper::VirtualHitTest(y),
 886                       wxVarHScrollHelper::VirtualHitTest(x));
 887 }
 888
 889 void wxVarHVScrollHelper::DoPrepareDC(wxDC& dc)
 890 {
 891     wxVarVScrollHelper::DoPrepareDC(dc);
 892     wxVarHScrollHelper::DoPrepareDC(dc);
 893 }
 894
 895 bool wxVarHVScrollHelper::ScrollLayout()
 896 {
 897     bool layout_result = false;
 898     layout_result |= wxVarVScrollHelper::ScrollLayout();
 899     layout_result |= wxVarHScrollHelper::ScrollLayout();
 900     return layout_result;
 901 }
 902
 903 wxSize wxVarHVScrollHelper::GetRowColumnCount() const
 904 {
 905     return wxSize(GetColumnCount(), GetRowCount());
 906 }
 907
 908 wxPosition wxVarHVScrollHelper::GetVisibleBegin() const
 909 {
 910     return wxPosition(GetVisibleRowsBegin(), GetVisibleColumnsBegin());
 911 }
 912
 913 wxPosition wxVarHVScrollHelper::GetVisibleEnd() const
 914 {
 915     return wxPosition(GetVisibleRowsEnd(), GetVisibleColumnsEnd());
 916 }
 917
 918 bool wxVarHVScrollHelper::IsVisible(size_t row, size_t column) const
 919 {
 920     return IsRowVisible(row) && IsColumnVisible(column);
 921 }
 922
 923
 924 // ============================================================================
 925 // wx[V/H/HV]ScrolledWindow implementations
 926 // ============================================================================
 927
 928 IMPLEMENT_ABSTRACT_CLASS(wxVScrolledWindow, wxPanel)
 929 IMPLEMENT_ABSTRACT_CLASS(wxHScrolledWindow, wxPanel)
 930 IMPLEMENT_ABSTRACT_CLASS(wxHVScrolledWindow, wxPanel)
 931
 932
 933 #if WXWIN_COMPATIBILITY_2_8
 934
 935 // ===========================================================================
 936 // wxVarVScrollLegacyAdaptor
 937 // ===========================================================================
 938
 939 size_t wxVarVScrollLegacyAdaptor::GetFirstVisibleLine() const
 940 { return GetVisibleRowsBegin(); }
 941
 942 size_t wxVarVScrollLegacyAdaptor::GetLastVisibleLine() const
 943 { return GetVisibleRowsEnd() - 1; }
 944
 945 size_t wxVarVScrollLegacyAdaptor::GetLineCount() const
 946 { return GetRowCount(); }
 947
 948 void wxVarVScrollLegacyAdaptor::SetLineCount(size_t count)
 949 { SetRowCount(count); }
 950
 951 void wxVarVScrollLegacyAdaptor::RefreshLine(size_t line)
 952 { RefreshRow(line); }
 953
 954 void wxVarVScrollLegacyAdaptor::RefreshLines(size_t from, size_t to)
 955 { RefreshRows(from, to); }
 956
 957 bool wxVarVScrollLegacyAdaptor::ScrollToLine(size_t line)
 958 { return ScrollToRow(line); }
 959
 960 bool wxVarVScrollLegacyAdaptor::ScrollLines(int lines)
 961 { return ScrollRows(lines); }
 962
 963 bool wxVarVScrollLegacyAdaptor::ScrollPages(int pages)
 964 { return ScrollRowPages(pages); }
 965
 966 wxCoord wxVarVScrollLegacyAdaptor::OnGetLineHeight(size_t WXUNUSED(n)) const
 967 {
 968     wxFAIL_MSG( _T("OnGetLineHeight() must be overridden if OnGetRowHeight() isn't!") );
 969     return -1;
 970 }
 971
 972 void wxVarVScrollLegacyAdaptor::OnGetLinesHint(size_t WXUNUSED(lineMin),
 973                                                size_t WXUNUSED(lineMax)) const
 974 {
 975 }
 976
 977 wxCoord wxVarVScrollLegacyAdaptor::OnGetRowHeight(size_t n) const
 978 {
 979     return OnGetLineHeight(n);
 980 }
 981
 982 void wxVarVScrollLegacyAdaptor::OnGetRowsHeightHint(size_t rowMin,
 983                                                     size_t rowMax) const
 984 {
 985     OnGetLinesHint(rowMin, rowMax);
 986 }
 987
 988 #endif // WXWIN_COMPATIBILITY_2_8