]>
Commit | Line | Data |
---|---|---|
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 | #include "wx/utils.h" // For wxMin/wxMax(). | |
35 | ||
36 | // ============================================================================ | |
37 | // wxVarScrollHelperEvtHandler declaration | |
38 | // ============================================================================ | |
39 | ||
40 | // ---------------------------------------------------------------------------- | |
41 | // wxScrollHelperEvtHandler: intercept the events from the window and forward | |
42 | // them to wxVarScrollHelperBase | |
43 | // ---------------------------------------------------------------------------- | |
44 | ||
45 | class WXDLLEXPORT wxVarScrollHelperEvtHandler : public wxEvtHandler | |
46 | { | |
47 | public: | |
48 | wxVarScrollHelperEvtHandler(wxVarScrollHelperBase *scrollHelper) | |
49 | { | |
50 | m_scrollHelper = scrollHelper; | |
51 | } | |
52 | ||
53 | virtual bool ProcessEvent(wxEvent& event); | |
54 | ||
55 | private: | |
56 | wxVarScrollHelperBase *m_scrollHelper; | |
57 | ||
58 | wxDECLARE_NO_COPY_CLASS(wxVarScrollHelperEvtHandler); | |
59 | }; | |
60 | ||
61 | // ============================================================================ | |
62 | // wxVarScrollHelperEvtHandler implementation | |
63 | // ============================================================================ | |
64 | ||
65 | bool wxVarScrollHelperEvtHandler::ProcessEvent(wxEvent& event) | |
66 | { | |
67 | wxEventType evType = event.GetEventType(); | |
68 | ||
69 | // pass it on to the real handler | |
70 | bool processed = wxEvtHandler::ProcessEvent(event); | |
71 | ||
72 | // always process the size events ourselves, even if the user code handles | |
73 | // them as well, as we need to AdjustScrollbars() | |
74 | // | |
75 | // NB: it is important to do it after processing the event in the normal | |
76 | // way as HandleOnSize() may generate a wxEVT_SIZE itself if the | |
77 | // scrollbar[s] (dis)appear and it should be seen by the user code | |
78 | // after this one | |
79 | if ( evType == wxEVT_SIZE ) | |
80 | { | |
81 | m_scrollHelper->HandleOnSize((wxSizeEvent &)event); | |
82 | ||
83 | return !event.GetSkipped(); | |
84 | } | |
85 | ||
86 | if ( processed ) | |
87 | { | |
88 | // normally, nothing more to do here - except if we have a command | |
89 | // event | |
90 | if ( event.IsCommandEvent() ) | |
91 | { | |
92 | return true; | |
93 | } | |
94 | } | |
95 | ||
96 | // reset the skipped flag (which might have been set to true in | |
97 | // ProcessEvent() above) to be able to test it below | |
98 | bool wasSkipped = event.GetSkipped(); | |
99 | if ( wasSkipped ) | |
100 | event.Skip(false); | |
101 | ||
102 | if ( evType == wxEVT_SCROLLWIN_TOP || | |
103 | evType == wxEVT_SCROLLWIN_BOTTOM || | |
104 | evType == wxEVT_SCROLLWIN_LINEUP || | |
105 | evType == wxEVT_SCROLLWIN_LINEDOWN || | |
106 | evType == wxEVT_SCROLLWIN_PAGEUP || | |
107 | evType == wxEVT_SCROLLWIN_PAGEDOWN || | |
108 | evType == wxEVT_SCROLLWIN_THUMBTRACK || | |
109 | evType == wxEVT_SCROLLWIN_THUMBRELEASE ) | |
110 | { | |
111 | m_scrollHelper->HandleOnScroll((wxScrollWinEvent &)event); | |
112 | if ( !event.GetSkipped() ) | |
113 | { | |
114 | // it makes sense to indicate that we processed the message as we | |
115 | // did scroll the window (and also notice that wxAutoScrollTimer | |
116 | // relies on our return value for continuous scrolling) | |
117 | processed = true; | |
118 | wasSkipped = false; | |
119 | } | |
120 | } | |
121 | #if wxUSE_MOUSEWHEEL | |
122 | else if ( evType == wxEVT_MOUSEWHEEL ) | |
123 | { | |
124 | m_scrollHelper->HandleOnMouseWheel((wxMouseEvent &)event); | |
125 | } | |
126 | #endif // wxUSE_MOUSEWHEEL | |
127 | ||
128 | event.Skip(wasSkipped); | |
129 | ||
130 | return processed; | |
131 | } | |
132 | ||
133 | ||
134 | // ============================================================================ | |
135 | // wxVarScrollHelperBase implementation | |
136 | // ============================================================================ | |
137 | ||
138 | // ---------------------------------------------------------------------------- | |
139 | // wxVarScrollHelperBase initialization | |
140 | // ---------------------------------------------------------------------------- | |
141 | ||
142 | wxVarScrollHelperBase::wxVarScrollHelperBase(wxWindow *win) | |
143 | { | |
144 | wxASSERT_MSG( win, wxT("associated window can't be NULL in wxVarScrollHelperBase") ); | |
145 | ||
146 | #if wxUSE_MOUSEWHEEL | |
147 | m_sumWheelRotation = 0; | |
148 | #endif | |
149 | ||
150 | m_unitMax = 0; | |
151 | m_sizeTotal = 0; | |
152 | m_unitFirst = 0; | |
153 | ||
154 | m_win = | |
155 | m_targetWindow = NULL; | |
156 | ||
157 | m_physicalScrolling = true; | |
158 | m_handler = NULL; | |
159 | ||
160 | m_win = win; | |
161 | ||
162 | // by default, the associated window is also the target window | |
163 | DoSetTargetWindow(win); | |
164 | ||
165 | } | |
166 | ||
167 | wxVarScrollHelperBase::~wxVarScrollHelperBase() | |
168 | { | |
169 | DeleteEvtHandler(); | |
170 | } | |
171 | ||
172 | // ---------------------------------------------------------------------------- | |
173 | // wxVarScrollHelperBase various helpers | |
174 | // ---------------------------------------------------------------------------- | |
175 | ||
176 | void | |
177 | wxVarScrollHelperBase::AssignOrient(wxCoord& x, | |
178 | wxCoord& y, | |
179 | wxCoord first, | |
180 | wxCoord second) | |
181 | { | |
182 | if ( GetOrientation() == wxVERTICAL ) | |
183 | { | |
184 | x = first; | |
185 | y = second; | |
186 | } | |
187 | else // horizontal | |
188 | { | |
189 | x = second; | |
190 | y = first; | |
191 | } | |
192 | } | |
193 | ||
194 | void | |
195 | wxVarScrollHelperBase::IncOrient(wxCoord& x, wxCoord& y, wxCoord inc) | |
196 | { | |
197 | if ( GetOrientation() == wxVERTICAL ) | |
198 | y += inc; | |
199 | else | |
200 | x += inc; | |
201 | } | |
202 | ||
203 | wxCoord wxVarScrollHelperBase::DoEstimateTotalSize() const | |
204 | { | |
205 | // estimate the total height: it is impossible to call | |
206 | // OnGetUnitSize() for every unit because there may be too many of | |
207 | // them, so we just make a guess using some units in the beginning, | |
208 | // some in the end and some in the middle | |
209 | static const size_t NUM_UNITS_TO_SAMPLE = 10; | |
210 | ||
211 | wxCoord sizeTotal; | |
212 | if ( m_unitMax < 3*NUM_UNITS_TO_SAMPLE ) | |
213 | { | |
214 | // in this case, full calculations are faster and more correct than | |
215 | // guessing | |
216 | sizeTotal = GetUnitsSize(0, m_unitMax); | |
217 | } | |
218 | else // too many units to calculate exactly | |
219 | { | |
220 | // look at some units in the beginning/middle/end | |
221 | sizeTotal = | |
222 | GetUnitsSize(0, NUM_UNITS_TO_SAMPLE) + | |
223 | GetUnitsSize(m_unitMax - NUM_UNITS_TO_SAMPLE, | |
224 | m_unitMax) + | |
225 | GetUnitsSize(m_unitMax/2 - NUM_UNITS_TO_SAMPLE/2, | |
226 | m_unitMax/2 + NUM_UNITS_TO_SAMPLE/2); | |
227 | ||
228 | // use the height of the units we looked as the average | |
229 | sizeTotal = (wxCoord) | |
230 | (((float)sizeTotal / (3*NUM_UNITS_TO_SAMPLE)) * m_unitMax); | |
231 | } | |
232 | ||
233 | return sizeTotal; | |
234 | } | |
235 | ||
236 | wxCoord wxVarScrollHelperBase::GetUnitsSize(size_t unitMin, size_t unitMax) const | |
237 | { | |
238 | if ( unitMin == unitMax ) | |
239 | return 0; | |
240 | else if ( unitMin > unitMax ) | |
241 | return -GetUnitsSize(unitMax, unitMin); | |
242 | //else: unitMin < unitMax | |
243 | ||
244 | // let the user code know that we're going to need all these units | |
245 | OnGetUnitsSizeHint(unitMin, unitMax); | |
246 | ||
247 | // sum up their sizes | |
248 | wxCoord size = 0; | |
249 | for ( size_t unit = unitMin; unit < unitMax; ++unit ) | |
250 | { | |
251 | size += OnGetUnitSize(unit); | |
252 | } | |
253 | ||
254 | return size; | |
255 | } | |
256 | ||
257 | size_t wxVarScrollHelperBase::FindFirstVisibleFromLast(size_t unitLast, bool full) const | |
258 | { | |
259 | const wxCoord sWindow = GetOrientationTargetSize(); | |
260 | ||
261 | // go upwards until we arrive at a unit such that unitLast is not visible | |
262 | // any more when it is shown | |
263 | size_t unitFirst = unitLast; | |
264 | wxCoord s = 0; | |
265 | for ( ;; ) | |
266 | { | |
267 | s += OnGetUnitSize(unitFirst); | |
268 | ||
269 | if ( s > sWindow ) | |
270 | { | |
271 | // for this unit to be fully visible we need to go one unit | |
272 | // down, but if it is enough for it to be only partly visible then | |
273 | // this unit will do as well | |
274 | if ( full ) | |
275 | { | |
276 | ++unitFirst; | |
277 | } | |
278 | ||
279 | break; | |
280 | } | |
281 | ||
282 | if ( !unitFirst ) | |
283 | break; | |
284 | ||
285 | --unitFirst; | |
286 | } | |
287 | ||
288 | return unitFirst; | |
289 | } | |
290 | ||
291 | size_t wxVarScrollHelperBase::GetNewScrollPosition(wxScrollWinEvent& event) const | |
292 | { | |
293 | wxEventType evtType = event.GetEventType(); | |
294 | ||
295 | if ( evtType == wxEVT_SCROLLWIN_TOP ) | |
296 | { | |
297 | return 0; | |
298 | } | |
299 | else if ( evtType == wxEVT_SCROLLWIN_BOTTOM ) | |
300 | { | |
301 | return m_unitMax; | |
302 | } | |
303 | else if ( evtType == wxEVT_SCROLLWIN_LINEUP ) | |
304 | { | |
305 | return m_unitFirst ? m_unitFirst - 1 : 0; | |
306 | } | |
307 | else if ( evtType == wxEVT_SCROLLWIN_LINEDOWN ) | |
308 | { | |
309 | return m_unitFirst + 1; | |
310 | } | |
311 | else if ( evtType == wxEVT_SCROLLWIN_PAGEUP ) | |
312 | { | |
313 | // Page up should do at least as much as line up. | |
314 | return wxMin(FindFirstVisibleFromLast(m_unitFirst), | |
315 | m_unitFirst ? m_unitFirst - 1 : 0); | |
316 | } | |
317 | else if ( evtType == wxEVT_SCROLLWIN_PAGEDOWN ) | |
318 | { | |
319 | // And page down should do at least as much as line down. | |
320 | if ( GetVisibleEnd() ) | |
321 | return wxMax(GetVisibleEnd() - 1, m_unitFirst + 1); | |
322 | else | |
323 | return wxMax(GetVisibleEnd(), m_unitFirst + 1); | |
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( wxT("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, wxT("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 | if ( m_unitMax ) | |
678 | { | |
679 | // sometimes change in varscrollable window's size can result in | |
680 | // unused empty space after the last item. Fix it by decrementing | |
681 | // first visible item position according to the available space. | |
682 | ||
683 | // determine free space | |
684 | const wxCoord sWindow = GetOrientationTargetSize(); | |
685 | wxCoord s = 0; | |
686 | size_t unit; | |
687 | for ( unit = m_unitFirst; unit < m_unitMax; ++unit ) | |
688 | { | |
689 | if ( s > sWindow ) | |
690 | break; | |
691 | ||
692 | s += OnGetUnitSize(unit); | |
693 | } | |
694 | wxCoord freeSpace = sWindow - s; | |
695 | ||
696 | // decrement first visible item index as long as there is free space | |
697 | size_t idealUnitFirst; | |
698 | for ( idealUnitFirst = m_unitFirst; | |
699 | idealUnitFirst > 0; | |
700 | idealUnitFirst-- ) | |
701 | { | |
702 | wxCoord us = OnGetUnitSize(idealUnitFirst-1); | |
703 | if ( freeSpace < us ) | |
704 | break; | |
705 | freeSpace -= us; | |
706 | } | |
707 | m_unitFirst = idealUnitFirst; | |
708 | } | |
709 | ||
710 | UpdateScrollbar(); | |
711 | ||
712 | event.Skip(); | |
713 | } | |
714 | ||
715 | void wxVarScrollHelperBase::HandleOnScroll(wxScrollWinEvent& event) | |
716 | { | |
717 | if (GetOrientation() != event.GetOrientation()) | |
718 | { | |
719 | event.Skip(); | |
720 | return; | |
721 | } | |
722 | ||
723 | DoScrollToUnit(GetNewScrollPosition(event)); | |
724 | ||
725 | #ifdef __WXMAC__ | |
726 | UpdateMacScrollWindow(); | |
727 | #endif // __WXMAC__ | |
728 | } | |
729 | ||
730 | void wxVarScrollHelperBase::DoPrepareDC(wxDC& dc) | |
731 | { | |
732 | if ( m_physicalScrolling ) | |
733 | { | |
734 | wxPoint pt = dc.GetDeviceOrigin(); | |
735 | ||
736 | IncOrient(pt.x, pt.y, -GetScrollOffset()); | |
737 | ||
738 | dc.SetDeviceOrigin(pt.x, pt.y); | |
739 | } | |
740 | } | |
741 | ||
742 | int wxVarScrollHelperBase::DoCalcScrolledPosition(int coord) const | |
743 | { | |
744 | return coord - GetScrollOffset(); | |
745 | } | |
746 | ||
747 | int wxVarScrollHelperBase::DoCalcUnscrolledPosition(int coord) const | |
748 | { | |
749 | return coord + GetScrollOffset(); | |
750 | } | |
751 | ||
752 | #if wxUSE_MOUSEWHEEL | |
753 | ||
754 | void wxVarScrollHelperBase::HandleOnMouseWheel(wxMouseEvent& event) | |
755 | { | |
756 | // we only want to process wheel events for vertical implementations. | |
757 | // There is no way to determine wheel orientation (and on MSW horizontal | |
758 | // wheel rotation just fakes scroll events, rather than sending a MOUSEWHEEL | |
759 | // event). | |
760 | if ( GetOrientation() != wxVERTICAL ) | |
761 | return; | |
762 | ||
763 | m_sumWheelRotation += event.GetWheelRotation(); | |
764 | int delta = event.GetWheelDelta(); | |
765 | ||
766 | // how much to scroll this time | |
767 | int units_to_scroll = -(m_sumWheelRotation/delta); | |
768 | if ( !units_to_scroll ) | |
769 | return; | |
770 | ||
771 | m_sumWheelRotation += units_to_scroll*delta; | |
772 | ||
773 | if ( !event.IsPageScroll() ) | |
774 | DoScrollUnits( units_to_scroll*event.GetLinesPerAction() ); | |
775 | else // scroll pages instead of units | |
776 | DoScrollPages( units_to_scroll ); | |
777 | } | |
778 | ||
779 | #endif // wxUSE_MOUSEWHEEL | |
780 | ||
781 | ||
782 | // ============================================================================ | |
783 | // wxVarHVScrollHelper implementation | |
784 | // ============================================================================ | |
785 | ||
786 | // ---------------------------------------------------------------------------- | |
787 | // wxVarHVScrollHelper operations | |
788 | // ---------------------------------------------------------------------------- | |
789 | ||
790 | void wxVarHVScrollHelper::SetRowColumnCount(size_t rowCount, size_t columnCount) | |
791 | { | |
792 | SetRowCount(rowCount); | |
793 | SetColumnCount(columnCount); | |
794 | } | |
795 | ||
796 | bool wxVarHVScrollHelper::ScrollToRowColumn(size_t row, size_t column) | |
797 | { | |
798 | bool result = false; | |
799 | result |= ScrollToRow(row); | |
800 | result |= ScrollToColumn(column); | |
801 | return result; | |
802 | } | |
803 | ||
804 | void wxVarHVScrollHelper::RefreshRowColumn(size_t row, size_t column) | |
805 | { | |
806 | // is this unit visible? | |
807 | if ( !IsRowVisible(row) || !IsColumnVisible(column) ) | |
808 | { | |
809 | // no, it is useless to do anything | |
810 | return; | |
811 | } | |
812 | ||
813 | // calculate the rect occupied by this cell on screen | |
814 | wxRect v_rect, h_rect; | |
815 | v_rect.height = OnGetRowHeight(row); | |
816 | h_rect.width = OnGetColumnWidth(column); | |
817 | ||
818 | size_t n; | |
819 | ||
820 | for ( n = GetVisibleRowsBegin(); n < row; n++ ) | |
821 | { | |
822 | v_rect.y += OnGetRowHeight(n); | |
823 | } | |
824 | ||
825 | for ( n = GetVisibleColumnsBegin(); n < column; n++ ) | |
826 | { | |
827 | h_rect.x += OnGetColumnWidth(n); | |
828 | } | |
829 | ||
830 | // refresh but specialize the behaviour if we have a single target window | |
831 | if ( wxVarVScrollHelper::GetTargetWindow() == wxVarHScrollHelper::GetTargetWindow() ) | |
832 | { | |
833 | v_rect.x = h_rect.x; | |
834 | v_rect.width = h_rect.width; | |
835 | wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect); | |
836 | } | |
837 | else | |
838 | { | |
839 | v_rect.x = 0; | |
840 | v_rect.width = wxVarVScrollHelper::GetNonOrientationTargetSize(); | |
841 | h_rect.y = 0; | |
842 | h_rect.width = wxVarHScrollHelper::GetNonOrientationTargetSize(); | |
843 | ||
844 | wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect); | |
845 | wxVarHScrollHelper::GetTargetWindow()->RefreshRect(h_rect); | |
846 | } | |
847 | } | |
848 | ||
849 | void wxVarHVScrollHelper::RefreshRowsColumns(size_t fromRow, size_t toRow, | |
850 | size_t fromColumn, size_t toColumn) | |
851 | { | |
852 | wxASSERT_MSG( fromRow <= toRow || fromColumn <= toColumn, | |
853 | wxT("RefreshRowsColumns(): empty range") ); | |
854 | ||
855 | // clump the range to just the visible units -- it is useless to refresh | |
856 | // the other ones | |
857 | if ( fromRow < GetVisibleRowsBegin() ) | |
858 | fromRow = GetVisibleRowsBegin(); | |
859 | ||
860 | if ( toRow > GetVisibleRowsEnd() ) | |
861 | toRow = GetVisibleRowsEnd(); | |
862 | ||
863 | if ( fromColumn < GetVisibleColumnsBegin() ) | |
864 | fromColumn = GetVisibleColumnsBegin(); | |
865 | ||
866 | if ( toColumn > GetVisibleColumnsEnd() ) | |
867 | toColumn = GetVisibleColumnsEnd(); | |
868 | ||
869 | // calculate the rect occupied by these units on screen | |
870 | wxRect v_rect, h_rect; | |
871 | size_t nBefore, nBetween; | |
872 | ||
873 | for ( nBefore = GetVisibleRowsBegin(); | |
874 | nBefore < fromRow; | |
875 | nBefore++ ) | |
876 | { | |
877 | v_rect.y += OnGetRowHeight(nBefore); | |
878 | } | |
879 | ||
880 | for ( nBetween = fromRow; nBetween <= toRow; nBetween++ ) | |
881 | { | |
882 | v_rect.height += OnGetRowHeight(nBetween); | |
883 | } | |
884 | ||
885 | for ( nBefore = GetVisibleColumnsBegin(); | |
886 | nBefore < fromColumn; | |
887 | nBefore++ ) | |
888 | { | |
889 | h_rect.x += OnGetColumnWidth(nBefore); | |
890 | } | |
891 | ||
892 | for ( nBetween = fromColumn; nBetween <= toColumn; nBetween++ ) | |
893 | { | |
894 | h_rect.width += OnGetColumnWidth(nBetween); | |
895 | } | |
896 | ||
897 | // refresh but specialize the behaviour if we have a single target window | |
898 | if ( wxVarVScrollHelper::GetTargetWindow() == wxVarHScrollHelper::GetTargetWindow() ) | |
899 | { | |
900 | v_rect.x = h_rect.x; | |
901 | v_rect.width = h_rect.width; | |
902 | wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect); | |
903 | } | |
904 | else | |
905 | { | |
906 | v_rect.x = 0; | |
907 | v_rect.width = wxVarVScrollHelper::GetNonOrientationTargetSize(); | |
908 | h_rect.y = 0; | |
909 | h_rect.width = wxVarHScrollHelper::GetNonOrientationTargetSize(); | |
910 | ||
911 | wxVarVScrollHelper::GetTargetWindow()->RefreshRect(v_rect); | |
912 | wxVarHScrollHelper::GetTargetWindow()->RefreshRect(h_rect); | |
913 | } | |
914 | } | |
915 | ||
916 | wxPosition wxVarHVScrollHelper::VirtualHitTest(wxCoord x, wxCoord y) const | |
917 | { | |
918 | return wxPosition(wxVarVScrollHelper::VirtualHitTest(y), | |
919 | wxVarHScrollHelper::VirtualHitTest(x)); | |
920 | } | |
921 | ||
922 | void wxVarHVScrollHelper::DoPrepareDC(wxDC& dc) | |
923 | { | |
924 | wxVarVScrollHelper::DoPrepareDC(dc); | |
925 | wxVarHScrollHelper::DoPrepareDC(dc); | |
926 | } | |
927 | ||
928 | bool wxVarHVScrollHelper::ScrollLayout() | |
929 | { | |
930 | bool layout_result = false; | |
931 | layout_result |= wxVarVScrollHelper::ScrollLayout(); | |
932 | layout_result |= wxVarHScrollHelper::ScrollLayout(); | |
933 | return layout_result; | |
934 | } | |
935 | ||
936 | wxSize wxVarHVScrollHelper::GetRowColumnCount() const | |
937 | { | |
938 | return wxSize(GetColumnCount(), GetRowCount()); | |
939 | } | |
940 | ||
941 | wxPosition wxVarHVScrollHelper::GetVisibleBegin() const | |
942 | { | |
943 | return wxPosition(GetVisibleRowsBegin(), GetVisibleColumnsBegin()); | |
944 | } | |
945 | ||
946 | wxPosition wxVarHVScrollHelper::GetVisibleEnd() const | |
947 | { | |
948 | return wxPosition(GetVisibleRowsEnd(), GetVisibleColumnsEnd()); | |
949 | } | |
950 | ||
951 | bool wxVarHVScrollHelper::IsVisible(size_t row, size_t column) const | |
952 | { | |
953 | return IsRowVisible(row) && IsColumnVisible(column); | |
954 | } | |
955 | ||
956 | ||
957 | // ============================================================================ | |
958 | // wx[V/H/HV]ScrolledWindow implementations | |
959 | // ============================================================================ | |
960 | ||
961 | IMPLEMENT_ABSTRACT_CLASS(wxVScrolledWindow, wxPanel) | |
962 | IMPLEMENT_ABSTRACT_CLASS(wxHScrolledWindow, wxPanel) | |
963 | IMPLEMENT_ABSTRACT_CLASS(wxHVScrolledWindow, wxPanel) | |
964 | ||
965 | ||
966 | #if WXWIN_COMPATIBILITY_2_8 | |
967 | ||
968 | // =========================================================================== | |
969 | // wxVarVScrollLegacyAdaptor | |
970 | // =========================================================================== | |
971 | ||
972 | size_t wxVarVScrollLegacyAdaptor::GetFirstVisibleLine() const | |
973 | { return GetVisibleRowsBegin(); } | |
974 | ||
975 | size_t wxVarVScrollLegacyAdaptor::GetLastVisibleLine() const | |
976 | { return GetVisibleRowsEnd() - 1; } | |
977 | ||
978 | size_t wxVarVScrollLegacyAdaptor::GetLineCount() const | |
979 | { return GetRowCount(); } | |
980 | ||
981 | void wxVarVScrollLegacyAdaptor::SetLineCount(size_t count) | |
982 | { SetRowCount(count); } | |
983 | ||
984 | void wxVarVScrollLegacyAdaptor::RefreshLine(size_t line) | |
985 | { RefreshRow(line); } | |
986 | ||
987 | void wxVarVScrollLegacyAdaptor::RefreshLines(size_t from, size_t to) | |
988 | { RefreshRows(from, to); } | |
989 | ||
990 | bool wxVarVScrollLegacyAdaptor::ScrollToLine(size_t line) | |
991 | { return ScrollToRow(line); } | |
992 | ||
993 | bool wxVarVScrollLegacyAdaptor::ScrollLines(int lines) | |
994 | { return ScrollRows(lines); } | |
995 | ||
996 | bool wxVarVScrollLegacyAdaptor::ScrollPages(int pages) | |
997 | { return ScrollRowPages(pages); } | |
998 | ||
999 | wxCoord wxVarVScrollLegacyAdaptor::OnGetLineHeight(size_t WXUNUSED(n)) const | |
1000 | { | |
1001 | wxFAIL_MSG( wxT("OnGetLineHeight() must be overridden if OnGetRowHeight() isn't!") ); | |
1002 | return -1; | |
1003 | } | |
1004 | ||
1005 | void wxVarVScrollLegacyAdaptor::OnGetLinesHint(size_t WXUNUSED(lineMin), | |
1006 | size_t WXUNUSED(lineMax)) const | |
1007 | { | |
1008 | } | |
1009 | ||
1010 | wxCoord wxVarVScrollLegacyAdaptor::OnGetRowHeight(size_t n) const | |
1011 | { | |
1012 | return OnGetLineHeight(n); | |
1013 | } | |
1014 | ||
1015 | void wxVarVScrollLegacyAdaptor::OnGetRowsHeightHint(size_t rowMin, | |
1016 | size_t rowMax) const | |
1017 | { | |
1018 | OnGetLinesHint(rowMin, rowMax); | |
1019 | } | |
1020 | ||
1021 | #endif // WXWIN_COMPATIBILITY_2_8 |