OLD | NEW |
---|---|
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef UI_ANDROID_OVERSCROLL_REFRESH_H_ | 5 #ifndef UI_ANDROID_OVERSCROLL_REFRESH_H_ |
6 #define UI_ANDROID_OVERSCROLL_REFRESH_H_ | 6 #define UI_ANDROID_OVERSCROLL_REFRESH_H_ |
7 | 7 |
8 #include "base/macros.h" | 8 #include "base/macros.h" |
9 #include "ui/android/ui_android_export.h" | 9 #include "ui/android/ui_android_export.h" |
10 #include "ui/gfx/geometry/size_f.h" | 10 #include "ui/gfx/geometry/size_f.h" |
(...skipping 12 matching lines...) Expand all Loading... | |
23 // The actuall pull response, animation and action are delegated to the | 23 // The actuall pull response, animation and action are delegated to the |
24 // provided refresh handler. | 24 // provided refresh handler. |
25 class UI_ANDROID_EXPORT OverscrollRefresh { | 25 class UI_ANDROID_EXPORT OverscrollRefresh { |
26 public: | 26 public: |
27 // Minmum number of overscrolling pull events required to activate the effect. | 27 // Minmum number of overscrolling pull events required to activate the effect. |
28 // Useful for avoiding accidental triggering when a scroll janks (is delayed), | 28 // Useful for avoiding accidental triggering when a scroll janks (is delayed), |
29 // capping the impulse per event. | 29 // capping the impulse per event. |
30 enum { kMinPullsToActivate = 3 }; | 30 enum { kMinPullsToActivate = 3 }; |
31 | 31 |
32 explicit OverscrollRefresh(OverscrollRefreshHandler* handler); | 32 explicit OverscrollRefresh(OverscrollRefreshHandler* handler); |
33 ~OverscrollRefresh(); | 33 ~OverscrollRefresh(); |
boliu
2017/08/23 19:17:02
does the destructor need to be virtual too?
sunyunjia
2017/08/23 23:47:06
Why does it need to be virtual?
boliu
2017/08/24 02:33:54
I guess simple and safe rule of thumb is if there
| |
34 | 34 |
35 // Scroll event stream listening methods. | 35 // Scroll event stream listening methods. |
36 void OnScrollBegin(); | 36 void OnScrollBegin(); |
37 // Returns whether the refresh was activated. | 37 // Returns whether the refresh was activated. |
38 void OnScrollEnd(const gfx::Vector2dF& velocity); | 38 void OnScrollEnd(const gfx::Vector2dF& velocity); |
39 | 39 |
40 // Scroll ack listener. The effect will only be activated if the initial | 40 // Scroll ack listener. The effect will only be activated if |can_navigate| |
41 // updates go unconsumed. | 41 // is true which happens when the scroll update is not consumed and the |
42 void OnScrollUpdateAck(bool was_consumed); | 42 // scroll_boundary_behavior on y axis is 'auto'. |
boliu
2017/08/23 19:17:03
comment on virtual methods that they are virtual f
sunyunjia
2017/08/23 23:47:06
Done.
| |
43 virtual void OnOverscrolled(); | |
43 | 44 |
44 // Returns true if the effect has consumed the |scroll_delta|. | 45 // Returns true if the effect has consumed the |scroll_delta|. |
45 bool WillHandleScrollUpdate(const gfx::Vector2dF& scroll_delta); | 46 bool WillHandleScrollUpdate(const gfx::Vector2dF& scroll_delta); |
46 | 47 |
47 // Release the effect (if active), preventing any associated refresh action. | 48 // Release the effect (if active), preventing any associated refresh action. |
48 void ReleaseWithoutActivation(); | 49 void ReleaseWithoutActivation(); |
49 | 50 |
50 // Notify the effect of the latest scroll offset and overflow properties. | 51 // Notify the effect of the latest scroll offset and overflow properties. |
51 // The effect will be disabled when the offset is non-zero or overflow is | 52 // The effect will be disabled when the offset is non-zero or overflow is |
52 // hidden. Note: All dimensions are in device pixels. | 53 // hidden. Note: All dimensions are in device pixels. |
53 void OnFrameUpdated(const gfx::Vector2dF& content_scroll_offset, | 54 void OnFrameUpdated(const gfx::Vector2dF& content_scroll_offset, |
54 bool root_overflow_y_hidden); | 55 bool root_overflow_y_hidden); |
55 | 56 |
56 // Reset the effect to its inactive state, immediately detaching and | 57 // Reset the effect to its inactive state, immediately detaching and |
57 // disabling any active effects. | 58 // disabling any active effects. |
58 void Reset(); | 59 virtual void Reset(); |
59 | 60 |
60 // Returns true if the refresh effect is either being manipulated or animated. | 61 // Returns true if the refresh effect is either being manipulated or animated. |
61 bool IsActive() const; | 62 virtual bool IsActive() const; |
62 | 63 |
63 // Returns true if the effect is waiting for an unconsumed scroll to start. | 64 // Returns true if the effect is waiting for an unconsumed scroll to start. |
64 bool IsAwaitingScrollUpdateAck() const; | 65 virtual bool IsAwaitingScrollUpdateAck() const; |
65 | 66 |
66 private: | 67 private: |
67 void Release(bool allow_refresh); | 68 void Release(bool allow_refresh); |
68 | 69 |
69 bool scrolled_to_top_; | 70 bool scrolled_to_top_; |
70 bool overflow_y_hidden_; | 71 bool overflow_y_hidden_; |
71 | 72 |
72 enum ScrollConsumptionState { | 73 enum ScrollConsumptionState { |
73 DISABLED, | 74 DISABLED, |
74 AWAITING_SCROLL_UPDATE_ACK, | 75 AWAITING_SCROLL_UPDATE_ACK, |
75 ENABLED, | 76 ENABLED, |
76 } scroll_consumption_state_; | 77 } scroll_consumption_state_; |
77 | 78 |
78 OverscrollRefreshHandler* const handler_; | 79 OverscrollRefreshHandler* const handler_; |
79 | 80 |
80 DISALLOW_COPY_AND_ASSIGN(OverscrollRefresh); | 81 DISALLOW_COPY_AND_ASSIGN(OverscrollRefresh); |
81 }; | 82 }; |
82 | 83 |
83 } // namespace ui | 84 } // namespace ui |
84 | 85 |
85 #endif // UI_ANDROID_OVERSCROLL_REFRESH_H_ | 86 #endif // UI_ANDROID_OVERSCROLL_REFRESH_H_ |
OLD | NEW |