1 #ifndef __DALI_TOOLKIT_INTERNAL_SCROLL_BASE_H__
2 #define __DALI_TOOLKIT_INTERNAL_SCROLL_BASE_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 // TODO - Replace list with dali-vector.h
26 #include <dali/dali.h>
28 #include <dali-toolkit/public-api/controls/scrollable/scroll-view/scroll-view.h>
29 #include <dali-toolkit/internal/controls/scrollable/scrollable-impl.h>
42 typedef IntrusivePtr<Actor> ActorPtr;
43 typedef std::list<Constraint> ConstraintStack;
46 * ScrollBase represents a set of properties (time, position
47 * scale etc.) that constrain a set of actors.
49 class ScrollBase : public Scrollable
53 struct ActorInfo : public Dali::RefObject
56 * ActorInfo constructor
57 * @param[in] actor The actor that this ActorInfo represents.
59 ActorInfo(Actor actor)
65 * ActorInfo destructor
66 * removes scrollview-related constraints only.
74 * Apply a constraint to this actor
75 * The constraint will be applied to the actor,
76 * and the ActorInfo will keep track of this constraint.
77 * @param[in] constraint The constraint to apply to the actor
79 void ApplyConstraint(Constraint constraint)
81 ActiveConstraint activeConstraint = mActor.ApplyConstraint( constraint );
82 mConstraints.push_back( activeConstraint );
86 * Remove constraints from this actor.
87 * All of the constraints that have been applied to the
88 * actor via this ActorInfo will be removed.
90 void RemoveConstraints()
92 std::vector<ActiveConstraint>::iterator it = mConstraints.begin();
93 std::vector<ActiveConstraint>::iterator end = mConstraints.end();
96 mActor.RemoveConstraint(*it);
101 Actor mActor; ///< The Actor that this ActorInfo represents.
102 std::vector<ActiveConstraint> mConstraints; ///< A list keeping track of constraints applied to the actor via this delegate.
105 typedef IntrusivePtr<ActorInfo> ActorInfoPtr;
106 typedef std::vector<ActorInfoPtr> ActorInfoContainer;
107 typedef ActorInfoContainer::iterator ActorInfoIter;
108 typedef ActorInfoContainer::const_iterator ActorInfoConstIter;
113 * Sets the delay in seconds.
114 * This delay affects the animation timing for all
117 * @param[in] delay The delay in seconds.
119 void SetDelay(float delay)
125 * Gets the current delay in seconds.
127 * @return The delay in seconds.
129 float GetDelay() const
137 * Sets ScrollBase Parent
139 * @param[in] parent The parent that this ScrollBase belongs to.
141 void SetParent(ScrollBase *parent);
144 * Bind Actor to this scroll view/group.
145 * Once Bound, this scroll view/group will affect the actor (child)
147 * @param[in] child The actor to be bound.
149 void BindActor(Actor child);
152 * Unbind Actor from this scroll view/group
153 * Once Unbound, this scroll view/group will not affect the actor
155 * @note this does not remove the child from the ScrollView container
157 * @param[in] child The actor to be unbound
159 void UnbindActor(Actor child);
162 * Searches associated ScrollBases for the Actor, and attempts to Unbind
163 * systematically this Actor from the ScrollView or Groups attached.
165 * @param[in] child The actor to be unbound.
167 virtual void FindAndUnbindActor(Actor child);
170 * Applies constraint to the bound actors within this ScrollView/Group only.
172 * @param[in] constraint, the constraint to apply to these bound actors and future
175 void ApplyConstraintToBoundActors(Constraint constraint);
178 * Removes all constraints from the bound actors within this ScrollView/Group only.
180 void RemoveConstraintsFromBoundActors();
184 static const std::string SCROLL_DOMAIN_OFFSET_PROPERTY_NAME;
189 * Construct a new ScrollBase.
194 * 2nd-phase initialization.
196 void RegisterProperties();
200 ScrollBase *mParent; ///< Pointer to ScrollBase parent, if exists.
201 Property::Index mPropertyTime; ///< Scroll Time (0 to animationDuration while animating, otherwise 0)
202 Property::Index mPropertyX; ///< Scroll Position X ("scroll-x")
203 Property::Index mPropertyY; ///< Scroll Position Y ("scroll-y")
204 Property::Index mPropertyPrePosition; ///< Scroll Position ("scroll-position") [function of scroll-x, scroll-y]
205 Property::Index mPropertyPosition; ///< Scroll Position ("scroll-position") [function of scroll-pre-position]
206 Property::Index mPropertyScale; ///< Scroll Scale ("scroll-scale")
207 Property::Index mPropertyOvershootX; ///< Scroll Overshoot ("scroll-overshoot-x") [function of scroll-pre-position, scroll-position]
208 Property::Index mPropertyOvershootY; ///< Scroll Overshoot ("scroll-overshoot-y") [function of scroll-pre-position, scroll-position]
209 Property::Index mPropertyWrap; ///< Scroll Wrap ("scroll-wrap")
210 Property::Index mPropertyPanning; ///< Whether we are panning
211 Property::Index mPropertyScrolling; ///< Whether we are scrolling
212 Property::Index mPropertyFinal; ///< Scroll Final Position ("scroll-final") [scroll-position + f(scroll-overshoot)]
213 Property::Index mPropertyDomainOffset; ///< Scroll Domain Offset ("scroll-domain-offset") keeps track of scroll position as it wraps domains
214 Property::Index mPropertyPositionDelta; ///< Scroll Position Delta ("scroll-position-delta")
215 Property::Index mPropertyScrollStartPagePosition; ///< Scroll Start Page Position ("scroll-start-page-position")
219 float mDelay; ///< delay in seconds.
220 ConstraintStack mConstraintStack; ///< The list of constraints to apply to any actors
221 ActorInfoContainer mBoundActors; ///< The list of actors that have been bound to this ScrollBase.
225 } // namespace Internal
227 } // namespace Toolkit
231 #endif // __DALI_TOOLKIT_INTERNAL_SCROLL_GROUP_H__