| 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_TOUCH_SELECTION_TOUCH_HANDLE_H_ | 5 #ifndef UI_TOUCH_SELECTION_TOUCH_HANDLE_H_ |
| 6 #define UI_TOUCH_SELECTION_TOUCH_HANDLE_H_ | 6 #define UI_TOUCH_SELECTION_TOUCH_HANDLE_H_ |
| 7 | 7 |
| 8 #include "base/logging.h" | 8 #include "base/logging.h" |
| 9 #include "base/memory/scoped_ptr.h" | 9 #include "base/memory/scoped_ptr.h" |
| 10 #include "base/time/time.h" | 10 #include "base/time/time.h" |
| 11 #include "ui/events/gesture_detection/motion_event.h" | 11 #include "ui/events/gesture_detection/motion_event.h" |
| 12 #include "ui/gfx/geometry/point_f.h" | 12 #include "ui/gfx/geometry/point_f.h" |
| 13 #include "ui/gfx/geometry/rect_f.h" | 13 #include "ui/gfx/geometry/rect_f.h" |
| 14 #include "ui/gfx/geometry/vector2d_f.h" | 14 #include "ui/gfx/geometry/vector2d_f.h" |
| 15 #include "ui/touch_selection/touch_handle_orientation.h" | 15 #include "ui/touch_selection/touch_handle_orientation.h" |
| 16 #include "ui/touch_selection/touch_selection_draggable.h" |
| 16 #include "ui/touch_selection/ui_touch_selection_export.h" | 17 #include "ui/touch_selection/ui_touch_selection_export.h" |
| 17 | 18 |
| 18 namespace ui { | 19 namespace ui { |
| 19 | 20 |
| 20 class TouchHandle; | 21 class TouchHandle; |
| 21 | 22 |
| 22 // Interface through which |TouchHandle| delegates rendering-specific duties. | 23 // Interface through which |TouchHandle| delegates rendering-specific duties. |
| 23 class UI_TOUCH_SELECTION_EXPORT TouchHandleDrawable { | 24 class UI_TOUCH_SELECTION_EXPORT TouchHandleDrawable { |
| 24 public: | 25 public: |
| 25 virtual ~TouchHandleDrawable() {} | 26 virtual ~TouchHandleDrawable() {} |
| 26 virtual void SetEnabled(bool enabled) = 0; | 27 virtual void SetEnabled(bool enabled) = 0; |
| 27 virtual void SetOrientation(TouchHandleOrientation orientation) = 0; | 28 virtual void SetOrientation(TouchHandleOrientation orientation) = 0; |
| 28 virtual void SetAlpha(float alpha) = 0; | 29 virtual void SetAlpha(float alpha) = 0; |
| 29 virtual void SetFocus(const gfx::PointF& position) = 0; | 30 virtual void SetFocus(const gfx::PointF& position) = 0; |
| 30 virtual gfx::RectF GetVisibleBounds() const = 0; | 31 virtual gfx::RectF GetVisibleBounds() const = 0; |
| 31 }; | 32 }; |
| 32 | 33 |
| 33 // Interface through which |TouchHandle| communicates handle manipulation and | 34 // Interface through which |TouchHandle| communicates handle manipulation and |
| 34 // requests concrete drawable instances. | 35 // requests concrete drawable instances. |
| 35 class UI_TOUCH_SELECTION_EXPORT TouchHandleClient { | 36 class UI_TOUCH_SELECTION_EXPORT TouchHandleClient |
| 37 : public TouchSelectionDraggableClient { |
| 36 public: | 38 public: |
| 37 virtual ~TouchHandleClient() {} | 39 ~TouchHandleClient() override {} |
| 38 virtual void OnHandleDragBegin(const TouchHandle& handle) = 0; | |
| 39 virtual void OnHandleDragUpdate(const TouchHandle& handle, | |
| 40 const gfx::PointF& new_position) = 0; | |
| 41 virtual void OnHandleDragEnd(const TouchHandle& handle) = 0; | |
| 42 virtual void OnHandleTapped(const TouchHandle& handle) = 0; | 40 virtual void OnHandleTapped(const TouchHandle& handle) = 0; |
| 43 virtual void SetNeedsAnimate() = 0; | 41 virtual void SetNeedsAnimate() = 0; |
| 44 virtual scoped_ptr<TouchHandleDrawable> CreateDrawable() = 0; | 42 virtual scoped_ptr<TouchHandleDrawable> CreateDrawable() = 0; |
| 45 virtual base::TimeDelta GetTapTimeout() const = 0; | 43 virtual base::TimeDelta GetTapTimeout() const = 0; |
| 46 virtual float GetTapSlop() const = 0; | |
| 47 }; | 44 }; |
| 48 | 45 |
| 49 // Responsible for displaying a selection or insertion handle for text | 46 // Responsible for displaying a selection or insertion handle for text |
| 50 // interaction. | 47 // interaction. |
| 51 class UI_TOUCH_SELECTION_EXPORT TouchHandle { | 48 class UI_TOUCH_SELECTION_EXPORT TouchHandle : public TouchSelectionDraggable { |
| 52 public: | 49 public: |
| 53 // The drawable will be enabled but invisible until otherwise specified. | 50 // The drawable will be enabled but invisible until otherwise specified. |
| 54 TouchHandle(TouchHandleClient* client, TouchHandleOrientation orientation); | 51 TouchHandle(TouchHandleClient* client, TouchHandleOrientation orientation); |
| 55 ~TouchHandle(); | 52 ~TouchHandle() override; |
| 53 |
| 54 // TouchSelectionDraggable implementation. |
| 55 bool WillHandleTouchEvent(const MotionEvent& event) override; |
| 56 bool IsActive() const override; |
| 56 | 57 |
| 57 // Sets whether the handle is active, allowing resource cleanup if necessary. | 58 // Sets whether the handle is active, allowing resource cleanup if necessary. |
| 58 // If false, active animations or touch drag sequences will be cancelled. | 59 // If false, active animations or touch drag sequences will be cancelled. |
| 59 // While disabled, manipulation is *explicitly not supported*, and may lead to | 60 // While disabled, manipulation is *explicitly not supported*, and may lead to |
| 60 // undesirable and/or unstable side-effects. The handle can be safely | 61 // undesirable and/or unstable side-effects. The handle can be safely |
| 61 // re-enabled to allow continued operation. | 62 // re-enabled to allow continued operation. |
| 62 void SetEnabled(bool enabled); | 63 void SetEnabled(bool enabled); |
| 63 | 64 |
| 64 enum AnimationStyle { ANIMATION_NONE, ANIMATION_SMOOTH }; | 65 enum AnimationStyle { ANIMATION_NONE, ANIMATION_SMOOTH }; |
| 65 // Update the handle visibility, fading in/out according to |animation_style|. | 66 // Update the handle visibility, fading in/out according to |animation_style|. |
| 66 // If an animation is in-progress, it will be overriden appropriately. | 67 // If an animation is in-progress, it will be overriden appropriately. |
| 67 void SetVisible(bool visible, AnimationStyle animation_style); | 68 void SetVisible(bool visible, AnimationStyle animation_style); |
| 68 | 69 |
| 69 // Update the handle placement to |position|. | 70 // Update the handle placement to |position|. |
| 70 // Note: If a fade out animation is active or the handle is invisible, the | 71 // Note: If a fade out animation is active or the handle is invisible, the |
| 71 // handle position will not be updated until the handle regains visibility. | 72 // handle position will not be updated until the handle regains visibility. |
| 72 void SetPosition(const gfx::PointF& position); | 73 void SetPosition(const gfx::PointF& position); |
| 73 | 74 |
| 74 // Update the handle visuals to |orientation|. | 75 // Update the handle visuals to |orientation|. |
| 75 // Note: If the handle is being dragged, the orientation change will be | 76 // Note: If the handle is being dragged, the orientation change will be |
| 76 // deferred until the drag has ceased. | 77 // deferred until the drag has ceased. |
| 77 void SetOrientation(TouchHandleOrientation orientation); | 78 void SetOrientation(TouchHandleOrientation orientation); |
| 78 | 79 |
| 79 // Allows touch-dragging of the handle. Returns true if the event was | |
| 80 // consumed, in which case the caller should cease further handling. | |
| 81 bool WillHandleTouchEvent(const MotionEvent& event); | |
| 82 | |
| 83 // Ticks an active animation, as requested to the client by |SetNeedsAnimate|. | 80 // Ticks an active animation, as requested to the client by |SetNeedsAnimate|. |
| 84 // Returns true if an animation is active and requires further ticking. | 81 // Returns true if an animation is active and requires further ticking. |
| 85 bool Animate(base::TimeTicks frame_time); | 82 bool Animate(base::TimeTicks frame_time); |
| 86 | 83 |
| 87 // Get the visible bounds of the handle, based on the current position and | 84 // Get the visible bounds of the handle, based on the current position and |
| 88 // the drawable's size/orientation. If the handle is invisible or disabled, | 85 // the drawable's size/orientation. If the handle is invisible or disabled, |
| 89 // the bounds will be empty. | 86 // the bounds will be empty. |
| 90 gfx::RectF GetVisibleBounds() const; | 87 gfx::RectF GetVisibleBounds() const; |
| 91 | 88 |
| 92 bool is_dragging() const { return is_dragging_; } | |
| 93 const gfx::PointF& position() const { return position_; } | 89 const gfx::PointF& position() const { return position_; } |
| 94 TouchHandleOrientation orientation() const { return orientation_; } | 90 TouchHandleOrientation orientation() const { return orientation_; } |
| 95 | 91 |
| 96 private: | 92 private: |
| 97 void BeginDrag(); | 93 void BeginDrag(); |
| 98 void EndDrag(); | 94 void EndDrag(); |
| 99 void BeginFade(); | 95 void BeginFade(); |
| 100 void EndFade(); | 96 void EndFade(); |
| 101 void SetAlpha(float alpha); | 97 void SetAlpha(float alpha); |
| 102 | 98 |
| 103 scoped_ptr<TouchHandleDrawable> drawable_; | 99 scoped_ptr<TouchHandleDrawable> drawable_; |
| 104 | 100 |
| 105 TouchHandleClient* const client_; | 101 TouchHandleClient* const client_; |
| 106 | 102 |
| 107 gfx::PointF position_; | 103 gfx::PointF position_; |
| 108 TouchHandleOrientation orientation_; | 104 TouchHandleOrientation orientation_; |
| 109 TouchHandleOrientation deferred_orientation_; | 105 TouchHandleOrientation deferred_orientation_; |
| 110 | 106 |
| 111 gfx::PointF touch_down_position_; | 107 gfx::PointF touch_down_position_; |
| 112 gfx::Vector2dF touch_to_focus_offset_; | 108 gfx::Vector2dF touch_drag_offset_; |
| 113 base::TimeTicks touch_down_time_; | 109 base::TimeTicks touch_down_time_; |
| 114 | 110 |
| 115 // Note that when a fade animation is active, |is_visible_| and |position_| | 111 // Note that when a fade animation is active, |is_visible_| and |position_| |
| 116 // may not reflect the actual visibilty and position of the drawable. This | 112 // may not reflect the actual visibilty and position of the drawable. This |
| 117 // discrepancy is resolved either upon fade completion or cancellation. | 113 // discrepancy is resolved either upon fade completion or cancellation. |
| 118 base::TimeTicks fade_end_time_; | 114 base::TimeTicks fade_end_time_; |
| 119 gfx::PointF fade_start_position_; | 115 gfx::PointF fade_start_position_; |
| 120 float alpha_; | 116 float alpha_; |
| 121 bool animate_deferred_fade_; | 117 bool animate_deferred_fade_; |
| 122 | 118 |
| 123 bool enabled_; | 119 bool enabled_; |
| 124 bool is_visible_; | 120 bool is_visible_; |
| 125 bool is_dragging_; | 121 bool is_dragging_; |
| 126 bool is_drag_within_tap_region_; | 122 bool is_drag_within_tap_region_; |
| 127 | 123 |
| 128 DISALLOW_COPY_AND_ASSIGN(TouchHandle); | 124 DISALLOW_COPY_AND_ASSIGN(TouchHandle); |
| 129 }; | 125 }; |
| 130 | 126 |
| 131 } // namespace ui | 127 } // namespace ui |
| 132 | 128 |
| 133 #endif // UI_TOUCH_SELECTION_TOUCH_HANDLE_H_ | 129 #endif // UI_TOUCH_SELECTION_TOUCH_HANDLE_H_ |
| OLD | NEW |