1 #ifndef __DALI_TOOLKIT_INTERNAL_SCROLL_VIEW_H__
2 #define __DALI_TOOLKIT_INTERNAL_SCROLL_VIEW_H__
5 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
22 #include <dali/dali.h>
25 #include <dali-toolkit/public-api/controls/control-impl.h>
26 #include <dali-toolkit/internal/controls/scrollable/scroll-view/scroll-base-impl.h>
27 #include <dali-toolkit/public-api/controls/scrollable/scroll-view/scroll-view.h>
28 #include <dali-toolkit/public-api/controls/scrollable/scroll-view/scroll-view-effect.h>
30 // predefined effect includes
31 #include <dali-toolkit/public-api/controls/scrollable/scroll-view/scroll-view-custom-effect.h>
43 typedef IntrusivePtr<ScrollView> ScrollViewPtr;
45 class ScrollInternalConstraints;
46 typedef IntrusivePtr<ScrollInternalConstraints> ScrollInternalConstraintsPtr;
48 class ScrollOvershootIndicator;
49 typedef IntrusivePtr<ScrollOvershootIndicator> ScrollOvershootIndicatorPtr;
52 * @copydoc Toolkit::ScrollView
54 class ScrollView : public ScrollBase
59 * FindDirection specifies how searching is conducted within the Find... routines.
63 None = -3, ///< Includes none within the search query.
64 All = -2, ///< Includes all within the search query.
65 Left = -1, ///< Includes only those not right !(>)
66 Right = 1, ///< Includes only those right (>)
67 Up = -1, ///< Includes only those not below !(>)
68 Down = 1, ///< Includes only those below (>)
69 Out = -1, ///< Includes only those not infront !(>)
70 In = 1 ///< Includes only those infront (>)
75 LockPossible = 0, ///< Locking is possible, but not set in stone yet.
76 LockHorizontal, ///< Locking is set to horizontal. (can pan vertically)
77 LockVertical, ///< Locking is set to vertical. (can pan horizontally)
78 LockNone ///< Locking is set to none (free panning).
83 AnimatingInternalX = 0x01, ///< animating mPropertyX due to externally requested ScrollTo or internal snapping operation
84 AnimatingInternalY = 0x02, ///< animating mPropertyY due to externally requested ScrollTo or internal snapping operation
85 SnappingInternalX = 0x04, ///< snapping mPropertyX back to mPropertyPreScroll x value to remove x overshoot over time
86 SnappingInternalY = 0x08, ///< snapping mPropertyY back to mPropertyPreScroll y value to remove y overshoot over time
89 static const unsigned int SCROLL_X_STATE_MASK = AnimatingInternalX | SnappingInternalX;
90 static const unsigned int SCROLL_Y_STATE_MASK = AnimatingInternalY | SnappingInternalY;
91 static const unsigned int SCROLL_ANIMATION_FLAGS = AnimatingInternalX | AnimatingInternalY;
92 static const unsigned int SNAP_ANIMATION_FLAGS = SnappingInternalX | SnappingInternalY;
97 * Create a new ScrollView.
98 * @return A public handle to the newly allocated ScrollView.
100 static Dali::Toolkit::ScrollView New();
105 * @copydoc Toolkit::ScrollView::GetScrollSnapAlphaFunction
107 AlphaFunction GetScrollSnapAlphaFunction() const;
110 * @copydoc Toolkit::ScrollView::SetScrollSnapAlphaFunction
112 void SetScrollSnapAlphaFunction(AlphaFunction alpha);
115 * @copydoc Toolkit::ScrollView::GetScrollFlickAlphaFunction
117 AlphaFunction GetScrollFlickAlphaFunction() const;
120 * @copydoc Toolkit::ScrollView::SetScrollFlickAlphaFunction
122 void SetScrollFlickAlphaFunction(AlphaFunction alpha);
125 * @copydoc Toolkit::ScrollView::GetScrollSnapDuration
127 float GetScrollSnapDuration() const;
130 * @copydoc Toolkit::ScrollView::SetScrollSnapDuration
132 void SetScrollSnapDuration(float time);
135 * @copydoc Toolkit::ScrollView::GetScrollFlickDuration
137 float GetScrollFlickDuration() const;
140 * @copydoc Toolkit::ScrollView::SetScrollFlickDuration
142 void SetScrollFlickDuration(float time);
145 * @copydoc Toolkit::ScrollView::ApplyEffect
147 void ApplyEffect(Toolkit::ScrollViewEffect effect);
150 * @brief ApplyEffect Applies a predefined effect
153 Toolkit::ScrollViewEffect ApplyEffect(Toolkit::ScrollView::PageEffect effect);
156 * @copydoc Toolkit::ScrollView::RemoveEffect
158 void RemoveEffect(Toolkit::ScrollViewEffect effect);
161 * @copydoc Toolkit::ScrollView::RemoveAllEffects
163 void RemoveAllEffects();
166 * @copydoc Toolkit::ScrollView::ApplyConstraintToChildren
168 void ApplyConstraintToChildren(Constraint constraint);
171 * @copydoc Toolkit::ScrollView::RemoveConstraintsFromChildren
173 void RemoveConstraintsFromChildren();
176 * @copydoc Toolkit::ScrollView::GetRulerX
178 const RulerPtr GetRulerX() const;
181 * @copydoc Toolkit::ScrollView::GetRulerY
183 const RulerPtr GetRulerY() const;
186 * @copydoc Toolkit::ScrollView::SetRulerX
188 void SetRulerX(RulerPtr ruler);
191 * @copydoc Toolkit::ScrollView::SetRulerY
193 void SetRulerY(RulerPtr ruler);
196 * @copydoc Toolkit::ScrollView::SetRulerScaleX
198 void SetRulerScaleX(RulerPtr ruler);
201 * @copydoc Toolkit::ScrollView::SetRulerScaleY
203 void SetRulerScaleY(RulerPtr ruler);
206 * Set Rotation axis ruler (defines how rotating is snapped in radians)
207 * @param[in] ruler The ruler to be used for the Rotation axis
209 void SetRulerRotation(RulerPtr ruler);
212 * @copydoc Toolkit::ScrollView::SetScrollSensitive
214 void SetScrollSensitive(bool sensitive);
217 * @copydoc Toolkit::ScrollView::SetMaxOvershoot
219 void SetMaxOvershoot(float overshootX, float overshootY);
222 * @copydoc Toolkit::ScrollView::SetSnapOvershootAlphaFunction
224 void SetSnapOvershootAlphaFunction(AlphaFunction alpha);
227 * @copydoc Toolkit::ScrollView::SetSnapOvershootDuration
229 void SetSnapOvershootDuration(float duration);
232 * @copydoc Toolkit::ScrollView::SetTouchesRequiredForPanning
234 void SetTouchesRequiredForPanning(unsigned int minTouches, unsigned int maxTouches, bool endOutside);
237 * @copydoc Toolkit::ScrollView::SetActorAutoSnap
239 void SetActorAutoSnap(bool enable);
242 * Enables or Disables Auto Resizing mode for ScrollView contents.
244 * When enabled, the ScrollView's X/Y Domains are restricted to the
245 * dimensions of the content's bounds, which may change as Actors are
246 * Added/Removed, and repositioned.
248 * @note This has been disabled for now, as this requires some fundamental
249 * changes to the way Actors positions and bounds are retrieved.
250 * (currently only constraints have these initial state knowledge)
252 * @param[in] enable Enables (true), or disables (false) Auto Resize.
254 void SetAutoResize(bool enable);
257 * Returns whether the wrap mode has been enabled (true) or not (false).
259 * @return Wrap Mode Enabled flag.
261 bool GetWrapMode() const;
264 * @copydoc Toolkit::ScrollView::SetWrapMode
266 void SetWrapMode(bool enable);
270 * @copydoc Toolkit::ScrollView::GetRefreshInterval
272 int GetRefreshInterval() const;
276 * @copydoc Toolkit::ScrollView::SetRefreshInterval
278 void SetRefreshInterval(int milliseconds);
281 * @copydoc Toolkit::ScrollView::GetScrollupdateDistance
283 int GetScrollUpdateDistance() const;
286 * @copydoc Toolkit::ScrollView::SetScrollUpdateDistance
288 void SetScrollUpdateDistance(int distance);
291 * @copydoc Toolkit::ScrollView::GetAxisAutoLock
293 bool GetAxisAutoLock() const;
296 * @copydoc Toolkit::ScrollView::SetAxisAutoLock
298 void SetAxisAutoLock(bool enable);
301 * @copydoc Toolkit::ScrollView::GetAxisAutoLockGradient
303 float GetAxisAutoLockGradient() const;
306 * @copydoc Toolkit::ScrollView::SetAxisAutoLockGradient
308 void SetAxisAutoLockGradient(float gradient);
311 * @copydoc Toolkit::ScrollView::GetFrictionCoefficient
313 float GetFrictionCoefficient() const;
316 * @copydoc Toolkit::ScrollView::SetFrictionCoefficient
318 void SetFrictionCoefficient(float friction);
321 * @copydoc Toolkit::ScrollView::GetFlickSpeedCoefficient
323 float GetFlickSpeedCoefficient() const;
326 * @copydoc Toolkit::ScrollView::SetFlickSpeedCoefficient
328 void SetFlickSpeedCoefficient(float speed);
331 * @copydoc Toolkit::ScrollView::GetMinimumDistanceForFlick
333 Vector2 GetMinimumDistanceForFlick() const;
336 * @copydoc Toolkit::ScrollView::SetMinimumDistanceForFlick
338 void SetMinimumDistanceForFlick( const Vector2& distance );
341 * @copydoc Toolkit::ScrollView::GetMinimumSpeedForFlick
343 float GetMinimumSpeedForFlick() const;
346 * @copydoc Toolkit::ScrollView::SetMinimumSpeedForFlick
348 void SetMinimumSpeedForFlick( float speed );
351 * @copydoc Toolkit::ScrollView::GetMaxFlickSpeed
353 float GetMaxFlickSpeed() const;
356 * @copydoc Toolkit::ScrollView::SetMaxFlickSpeed
358 void SetMaxFlickSpeed(float speed);
361 * @copydoc Toolkit::ScrollView::GetMouseWheelScrollDistanceStep
363 Vector2 GetMouseWheelScrollDistanceStep() const;
366 * @copydoc Toolkit::ScrollView::SetMouseWheelScrollDistanceStep
368 void SetMouseWheelScrollDistanceStep(Vector2 step);
371 * @copydoc Toolkit::ScrollView::GetCurrentPage
373 unsigned int GetCurrentPage() const;
376 * @copydoc Toolkit::ScrollView::GetCurrentScrollPosition
378 Vector3 GetCurrentScrollPosition() const;
381 * @copydoc Toolkit::ScrollView::SetScrollPosition
383 void SetScrollPosition(const Vector3& position);
386 * @copydoc Toolkit::ScrollView::GetCurrentScrollScale
388 Vector3 GetCurrentScrollScale() const;
391 * @copydoc Toolkit::Scrollable::GetDomainSize
393 Vector3 GetDomainSize() const;
396 * @copydoc Toolkit::ScrollView::TransformTo(const Vector3& position, const Vector3& scale, float rotation)
398 void TransformTo(const Vector3& position, const Vector3& scale, float rotation,
399 DirectionBias horizontalBias = DirectionBiasNone, DirectionBias verticalBias = DirectionBiasNone);
402 * @copydoc Toolkit::ScrollView::TransformTo(const Vector3& position, const Vector3& scale, float rotation, float duration)
404 void TransformTo(const Vector3& position, const Vector3& scale, float rotation, float duration,
405 DirectionBias horizontalBias = DirectionBiasNone, DirectionBias verticalBias = DirectionBiasNone);
408 * @copydoc Toolkit::ScrollView::ScrollTo(const Vector3 &position)
410 void ScrollTo(const Vector3 &position);
413 * @copydoc Toolkit::Scrollable::ScrollTo(const Vector3& position, float duration)
415 void ScrollTo(const Vector3& position, float duration);
418 * @copydoc Toolkit::ScrollView::ScrollTo(const Vector3 &position, float duration, DirectionBias horizontalBias, DirectionBias verticalBias)
420 void ScrollTo(const Vector3& position, float duration,
421 DirectionBias horizontalBias, DirectionBias verticalBias);
424 * @copydoc Toolkit::ScrollView::ScrollTo(unsigned int page)
426 void ScrollTo(unsigned int page);
429 * @copydoc Toolkit::ScrollView::ScrollTo(unsigned int page, float duration, DirectionBias bias)
431 void ScrollTo(unsigned int page, float duration, DirectionBias bias = DirectionBiasNone);
434 * @copydoc Toolkit::ScrollView::ScrollTo(Actor& actor)
436 void ScrollTo(Actor &actor);
439 * @copydoc Toolkit::ScrollView::ScrollTo(Actor& actor, float duration)
441 void ScrollTo(Actor &actor, float duration);
444 * @copydoc Toolkit::ScrollView::SetScrollingDirection()
446 void SetScrollingDirection( Radian direction, Radian threshold );
449 * @copydoc Toolkit::ScrollView::RemoveScrollingDirection()
451 void RemoveScrollingDirection( Radian angle );
454 * Finds the closest Actor to the current center of the ScrollView.
456 * @return A handle to the actor if found, or an empty handle if not.
458 Actor FindClosestActor();
461 * Finds the closest Actor to position in ScrollView
463 * @param[in] position position within ScrollView.
464 * @param[in] dirX Whether to search only those elements that are Left,Right, or All
465 * @param[in] dirY Whether to search only those elements that are Up,Down, or All
466 * @param[in] dirZ Whether to search only those elements that are Out,In, or All
467 * @return A handle to the actor if found, or an empty handle if not.
469 Actor FindClosestActorToPosition(const Vector3& position, FindDirection dirX = All, FindDirection dirY = All, FindDirection dirZ = All);
472 * @copydoc Toolkit::ScrollView::ScrollToSnapPoint
474 bool ScrollToSnapPoint();
477 * @copydoc Toolkit::ScrollView::ScaleTo(const Vector3& scale)
479 void ScaleTo(const Vector3& scale);
482 * @copydoc Toolkit::ScrollView::ScaleTo(const Vector3& scale, float duration)
484 void ScaleTo(const Vector3& scale, float duration);
489 void StopAnimation(void);
492 * Stops the input animation
494 * @param[in] the animation to stop
496 void StopAnimation(Animation& animation);
499 * Animates to position/scale/rotation transform.
501 * @param[in] position The position to animate to
502 * @param[in] positionDuration The number of seconds this animation should run for in each axis.
503 * @param[in] scale The scale to animate to
504 * @param[in] scaleDuration The number of seconds this animation should run for in each axis.
505 * @param[in] rotation The angle to animate to
506 * @param[in] rotationDuration The number of seconds this animation should run for in each axis.
507 * @param[in] alpha The easing alpha function to use.
508 * @param[in] findShortcuts (optional) Whether to find the shortest route (in Wrap mode)
509 * @param[in] horizontalBias (optional) Whether to bias animation to left or right (or no biasing)
510 * @param[in] verticalBias (optional) Whether to bias animation to top or bottom (or no biasing)
511 * @return True if animation necessary and taking place to reach desired transform.
513 bool AnimateTo(const Vector3& position, const Vector3& positionDuration,
514 const Vector3& scale, const Vector3& scaleDuration,
515 float rotation, float rotationDuration,
516 AlphaFunction alpha, bool findShortcuts = true,
517 DirectionBias horizontalBias = DirectionBiasNone, DirectionBias verticalBias = DirectionBiasNone,
518 SnapType snapType = Snap);
521 * @copydoc Toolkit::Scrollable::AddOverlay()
523 void AddOverlay(Actor actor);
526 * @copydoc Toolkit::Scrollable::RemoveOverlay()
528 void RemoveOverlay(Actor actor);
531 * @copydoc Toolkit::Internal::Scrollable::SetOvershootEffectColor
533 void SetOvershootEffectColor( const Vector4& color );
538 * @copydoc Dali::Toolkit::ScrollView::SnapStartedSignal()
540 Toolkit::ScrollView::SnapStartedSignalV2& SnapStartedSignal();
543 * Connects a callback function with the object's signals.
544 * @param[in] object The object providing the signal.
545 * @param[in] tracker Used to disconnect the signal.
546 * @param[in] signalName The signal to connect to.
547 * @param[in] functor A newly allocated FunctorDelegate.
548 * @return True if the signal was connected.
549 * @post If a signal was connected, ownership of functor was passed to CallbackBase. Otherwise the caller is responsible for deleting the unused functor.
551 static bool DoConnectSignal( BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor );
553 private: // private overriden functions from CustomActorImpl and Controls
556 * @copydoc Dali::CustomActorImpl::OnSizeAnimation(Animation&, const Vector3&)
558 virtual void OnSizeAnimation(Animation& animation, const Vector3& targetSize);
561 * @copydoc Dali::Control::OnControlSizeSet(const Vector3&)
563 virtual void OnControlSizeSet( const Vector3& size );
566 * From CustomActorImpl; called after a child has been added to the owning actor.
567 * @param[in] child The child which has been added.
569 virtual void OnChildAdd(Actor& child);
572 * From CustomActorImpl; called shortly before a child is removed from the owning actor.
573 * @param[in] child The child being removed.
575 virtual void OnChildRemove(Actor& child);
578 * @copydoc Dali::CustomActorImpl::OnPropertySet( Property::Index index, Property::Value propertyValue )
580 virtual void OnPropertySet( Property::Index index, Property::Value propertyValue );
583 * From CustomActorImpl; called after a touch-signal is received by the owning actor.
585 * We don't listen to these events as content within the contain may consume events.
587 * @param[in] event The touch event.
588 * @return True if the event should be consumed.
590 virtual bool OnTouchEvent(const TouchEvent& event);
593 * From CustomActorImpl; called after a mouse-wheel-event is received by the owning actor.
594 * @param[in] event The mouse wheel event.
595 * @return True if the event should be consumed.
597 virtual bool OnMouseWheelEvent(const MouseWheelEvent& event);
600 * @copydoc Toolkit::Control::OnInitialize()
602 virtual void OnInitialize();
605 * @copydoc Toolkit::Control::OnControlStageConnection()
607 virtual void OnControlStageConnection();
610 * @copydoc Toolkit::Control::OnControlStageConnection()
612 virtual void OnControlStageDisconnection();
615 * @copydoc Toolkit::Control::OnAccessibilityPan()
617 virtual bool OnAccessibilityPan(PanGesture gesture);
620 * @copydoc Toolkit::Scrollable::SetOvershootEnabled()
622 virtual void SetOvershootEnabled(bool enable);
627 * Start a timer which calls OnTouchDownTimeout()
629 void StartTouchDownTimer();
632 * Stop a timer which calls OnTouchDownTimeout()
634 void StopTouchDownTimer();
637 * Helper to detect when touch-point has been down (outside of pan gesture)
639 bool OnTouchDownTimeout();
642 * Called whenever a snap animation has completed
643 * @param[in] source the Animation instance that has completed.
644 * Resets all scrolling animations and states, leaving current scroll position at mPropertyPosition
646 void ResetScrolling();
649 * Updates mScrollInternalPosition, mScrollPrePosition and mScrollPostPosition from their property counterparts
651 void UpdateLocalScrollProperties();
654 * Makes sure scroll values are ready for animated scrolling
656 void PreAnimatedScrollSetup();
659 * Finish an animated scroll, ensuring all scroll properties are updated
662 void FinaliseAnimatedScroll();
665 * Animates the internal x property to the given value
667 * @param[in] position The X position to animate to
668 * @param[in] duration The time in seconds for animation
669 * @param[in] alpha The alpha function to use for animating
671 void AnimateInternalXTo( float position, float duration, AlphaFunction alpha );
674 * Animates the internal y property to the given value
676 * @param[in] position The Y position to animate to
677 * @param[in] duration The time in seconds for animation
678 * @param[in] alpha The alpha function to use for animating
680 void AnimateInternalYTo( float position, float duration, AlphaFunction alpha );
683 * Called whenever a snap animation on the x-axis has completed
684 * @param[in] source the Animation instance that has completed.
686 void OnScrollAnimationFinished( Animation& source );
689 * Called when either the X or Y internal scroll positions have finished snapping back to mPropertyPrePosition
691 * @param[in] source the Animation instance that has completed.
693 void OnSnapInternalPositionFinished( Animation& source );
696 * Called whenever a snap animation on the x-axis has completed and we need to snap pre scroll
697 * position to our clamped position
698 * @param[in] position The x position to snap pre scroll property to
700 void SnapInternalXTo( float position );
703 * Called whenever a snap animation on the y-axis has completed and we need to snap pre scroll
704 * position to our clamped position
705 * @param[in] position The y position to snap pre scroll property to
707 void SnapInternalYTo( float position );
710 * This is called internally whenever the Scroll Rulers are
711 * modified. This will update the properties: 'scroll-position-min'
712 * and 'scroll-position-max' to reflect the changes.
714 * @param[in] size size of the visible scroll area (ScrollView control size)
716 void UpdatePropertyDomain(const Vector3& size);
719 * Called when the gesture starts.
721 void GestureStarted();
724 * Amalgamated Gesture Continuing event
726 * @param[in] panDelta average panning delta from base position (0)
727 * @param[in] scaleDelta average scale delta from base scale (1)
728 * @param[in] rotationDelta average rotation delta from base angle (0)
730 void GestureContinuing(const Vector2& panDelta, const Vector2& scaleDelta, float rotationDelta);
733 * Called upon pan gesture event.
735 * @param[in] gesture The gesture event.
737 void OnPan(PanGesture pan);
740 * Extension of the above gestures.
742 * @param[in] gesture The gesture event.
744 void OnGestureEx(Gesture::State state);
747 * Performs snapping while taking into account Velocity of gesture
748 * (velocity in pixels/sec)
750 * @param[in] velocity velocity in pixels/sec
752 bool SnapWithVelocity(Vector2 velocity);
755 * Updates Container Transform based on Pan, Scale, and Rotation props.
756 * (occurs when continuing gesture i.e. dragging/pinching.)
758 void UpdateTransform();
761 * Finishes Container Transform
762 * (occurs upon finishing gesture i.e. releasing)
764 void FinishTransform();
767 * Returns overshoot vector based on current position
769 * Overshoot vector is defined as how far outside of bounds
770 * the viewport is trying to view (prior to being clamped).
772 * an overshoot of (100,50), means user is in bottom right corner,
773 * trying to pan +100 to the right, and +50 below. This can be used
774 * to determine an effect, such as stretching.
776 * @param[in] position The position for which you wish to obtain overshoot vector
778 Vector3 GetOvershoot(Vector3& position) const;
781 * Clamps position within the domain set up by X/Y Rulers
783 * @param[in,out] position The position you wish to clamp
785 void ClampPosition(Vector3& position) const;
788 * Clamps position within the domain set up by X/Y Rulers
790 * @param[in,out] position The position you wish to clamp
791 * @param[out] clamped The results of the clamping.
793 void ClampPosition(Vector3& position, ClampState3 &clamped) const;
796 * Wraps position within the domain set up by X/Y Rulers
798 * @note Only wraps if mWrapMode is enabled, and respective domains
801 * @param[in,out] position The position you wish to wrap
803 void WrapPosition(Vector3& position) const;
806 * Clamps scale within the domain set up by Scale-X/Scale-Y Rulers
808 * @param[in,out] scale The scale you wish to clamp
810 void ClampScale(Vector3& scale) const;
813 * Clamps scale within the domain set up by Scale-X/Scale-Y Rulers
815 * @param[in,out] scale The scale you wish to clamp
816 * @param[out] clamped The results of the clamping.
818 void ClampScale(Vector3& scale, ClampState3 &clamped) const;
821 * Updates the main internal scroll constraints with new ruler and domain
824 void UpdateMainInternalConstraint();
827 * Enables/disables the overshoot constraints
829 * @param[in] enabled whether to enable or disable the overshoot constraints
831 void SetOvershootConstraintsEnabled(bool enabled);
834 * Sets internal constraints for this ScrollView.
835 * Many of these internal constraints are based on properties within
838 void SetInternalConstraints();
843 * Construct a new ScrollView.
848 * A reference counted object may only be deleted by calling Unreference()
850 virtual ~ScrollView();
855 * Searches this ScrollView, and attempts to Unbind
856 * systematically this Actor from the ScrollView attached.
858 * @param[in] child The actor to be unbound.
860 virtual void FindAndUnbindActor(Actor child);
863 * Gets position property.
865 * @return The current position
867 Vector3 GetPropertyPrePosition() const;
870 * Gets position property.
872 * @return The current position
874 Vector3 GetPropertyPosition() const;
877 * Gets scale property.
879 * @return The current scale
881 Vector3 GetPropertyScale() const;
884 * Handles a Stopped animation. Its position/scale/rotation properties need to be
885 * saved, and the animation flag switched off.
887 void HandleStoppedAnimation();
890 * Handles a Stopped animation (whether the animation completed, or was
891 * manually stopped). Its position/scale/rotation properties need to be
892 * saved, and the animation flag switched off.
894 void HandleSnapAnimationFinished();
897 * Checks if the property notifications are active and adds them if not
899 void SetScrollUpdateNotification( bool enabled );
902 * Refresh the ScrollView (used when animating to update application developer of changes)
903 * @return True if the refresh timer should be kept running.
905 void OnScrollUpdateNotification(Dali::PropertyNotification& source);
910 ScrollView(const ScrollView&);
913 ScrollView& operator=(const ScrollView& rhs);
917 unsigned long mTouchDownTime; ///< The touch down time
919 int mGestureStackDepth; ///< How many gestures are currently occuring.
921 Vector3 mPanDelta; ///< Amount currently panned.
922 Vector3 mScaleDelta; ///< Amount currently scaled.
923 float mRotationDelta; ///< Amount currently rotated.
925 unsigned int mScrollStateFlags; ///< flags indicating current state of scrolling
926 // Scroll delegate pre and post position/scale/rotation properties...
927 Vector3 mScrollPrePosition; ///< Wrapped scroll position, but not clamped
928 Vector3 mScrollPostPosition; ///< Wrapped and clamped, this is the final scroll position used
929 Vector3 mScrollTargetPosition; ///< Final target position for an animated scroll
930 Vector3 mScrollPreScale; ///< Scroll delegate pre-scale
931 Vector3 mScrollPostScale; ///< Scroll delegate post-scale (affected by current touch)
932 float mScrollPreRotation; ///< Scroll delegate pre-rotation
933 float mScrollPostRotation; ///< Scroll delegate post-rotation (affected by current touch)
934 Vector3 mDomainOffset; ///< Domain offset (this keeps track of the domain boundaries that scroll positions traverses)
936 // Rulers for each axes...
939 RulerPtr mRulerScaleX;
940 RulerPtr mRulerScaleY;
941 RulerPtr mRulerRotation;
943 // Last property values set to ScrollView
947 unsigned int mMinTouchesForPanning; ///< Minimum number of touches for panning to be used.
948 unsigned int mMaxTouchesForPanning; ///< Maximum number of touches for panning to be used.
950 Animation mSnapAnimation; ///< Used to animate rotation and scaling of scroll properties
951 Animation mInternalXAnimation; ///< Animates mPropertyX to a snap position or application requested scroll position
952 Animation mInternalYAnimation; ///< Animates mPropertyY to a snap position or application requested scroll position
955 Vector2 mLastVelocity; ///< Record the last velocity from PanGesture (Finish event doesn't have correct velocity)
958 Timer mTouchDownTimer; ///< Used to interrupt snap-animation. This cannot be done in OnTouchEvent without breaking fast flick behavior.
960 float mScrollUpdateDistance; ///< Distance for scrolling to travel for the scroll update notifications
961 Dali::PropertyNotification mScrollXUpdateNotification; ///< scroll x position update notification
962 Dali::PropertyNotification mScrollYUpdateNotification; ///< scroll y position update notification
964 Actor mInternalActor; ///< Internal actor (we keep internal actors in here e.g. scrollbars, so we can ignore it in searches)
966 ScrollViewEffectContainer mEffects; ///< Container keeping track of all the applied effects.
968 float mOvershootDelay; ///< Time to wait for input before reducing overshoot back to 0
969 Vector2 mMaxOvershoot; ///< Number of scrollable pixels that will take overshoot from 0.0f to 1.0f
970 Vector2 mUserMaxOvershoot; ///< Set by user, allows overriding of default max overshoot for the scroll indicator
971 float mSnapOvershootDuration; ///< Duration for overshoot snapping back to Vector3::ZERO
972 AlphaFunction mSnapOvershootAlphaFunction; ///< AlphaFunction to be used for this overshoot.
974 float mSnapDuration; ///< Time for the snap animation to take (in seconds).
975 AlphaFunction mSnapAlphaFunction; ///< AlphaFunction to be used for the Snap Animation.
977 Vector2 mMinFlickDistance; ///< Minimum pan distance required for a flick
978 float mFlickSpeedThreshold; ///< Minimum pan speed required for a flick in pixels/ms
979 float mFlickDuration; ///< Time for the flick animation to take (in seconds).
980 AlphaFunction mFlickAlphaFunction; ///< AlphaFunction to be used for the Flick Animation.
982 float mAxisAutoLockGradient; ///< Axis Auto-lock gradient threshold. Above this gradient and it will lock scrolling to closest axis.
983 float mFrictionCoefficient; ///< Friction coefficient. Amount of friction to apply to free panning flick animation. in stage.lengths/sec
984 float mFlickSpeedCoefficient; ///< Flick velocity coefficient. Input touch velocity is multiplied by this.
985 float mMaxFlickSpeed; ///< Maximum flick speed. Maximum speed of flick in stage.lengths/sec.
987 Vector2 mMouseWheelScrollDistanceStep; ///< The step of scroll distance in actor coordinates in X and Y axes for each mouse wheel event received.
989 //ScrollInternalConstraintsPtr mScrollInternalConstraints;
990 ActiveConstraint mScrollMainInternalPrePositionConstraint;
991 ActiveConstraint mScrollMainInternalPositionConstraint;
992 ActiveConstraint mScrollMainInternalXConstraint;
993 ActiveConstraint mScrollMainInternalYConstraint;
994 ActiveConstraint mScrollMainInternalOvershootXConstraint;
995 ActiveConstraint mScrollMainInternalOvershootYConstraint;
996 ActiveConstraint mScrollMainInternalDeltaConstraint;
997 ActiveConstraint mScrollMainInternalFinalConstraint;
998 ActiveConstraint mScrollMainInternalRelativeConstraint;
1000 ScrollOvershootIndicatorPtr mOvershootIndicator;
1002 Toolkit::ScrollView::SnapStartedSignalV2 mSnapStartedSignalV2;
1004 bool mInAccessibilityPan : 1; ///< With AccessibilityPan its easier to move between snap positions
1005 bool mInitialized:1;
1006 bool mScrolling:1; ///< Flag indicating whether the scroll view is being scrolled (by user or animation)
1007 bool mScrollInterrupted:1; ///< Flag set for when a down event interrupts a scroll
1008 bool mPanning:1; ///< Whether scroll view is currently panning or not
1009 bool mSensitive:1; ///< Scroll Sensitivity Flag.
1010 bool mTouchDownTimeoutReached:1; ///< Indicates when down event timeout occured without corresponding up event (touch still down)
1011 bool mActorAutoSnapEnabled:1; ///< Whether to automatically snap to closest actor.
1012 bool mAutoResizeContainerEnabled:1; ///< Whether to automatically resize container (affects RulerDomain's on X/Y axes)
1013 bool mWrapMode:1; ///< Whether to wrap contents based on container size.
1014 bool mAxisAutoLock:1; ///< Whether to automatically lock axis when panning.
1015 bool mAlterChild:1; ///< Internal flag to control behavior of OnChildAdd/OnChildRemove when Adding internal Actors.
1016 bool mDefaultMaxOvershoot:1; ///< Whether to use default max overshoot or application defined one
1017 bool mCanScrollHorizontal:1; ///< Local value of our property to check against
1018 bool mCanScrollVertical:1; ///< Local value of our property to check against
1021 } // namespace Internal
1023 // Helpers for public-api forwarding methods
1025 inline Toolkit::Internal::ScrollView& GetImpl(Toolkit::ScrollView& scrollView)
1027 DALI_ASSERT_ALWAYS(scrollView);
1029 Dali::RefObject& handle = scrollView.GetImplementation();
1031 return static_cast<Toolkit::Internal::ScrollView&>(handle);
1034 inline const Toolkit::Internal::ScrollView& GetImpl(const Toolkit::ScrollView& scrollView)
1036 DALI_ASSERT_ALWAYS(scrollView);
1038 const Dali::RefObject& handle = scrollView.GetImplementation();
1040 return static_cast<const Toolkit::Internal::ScrollView&>(handle);
1043 } // namespace Toolkit
1047 #endif // __DALI_TOOLKIT_INTERNAL_SCROLL_VIEW_H__