28  * <p>There are two different approaches to adding animations to a <code>AnimatorSet</code>:
29  * either the {@link AnimatorSet#playTogether(Animator[]) playTogether()} or
30  * {@link AnimatorSet#playSequentially(Animator[]) playSequentially()} methods can be called to add
31  * a set of animations all at once, or the {@link AnimatorSet#play(Animator)} can be
32  * used in conjunction with methods in the {@link AnimatorSet.Builder Builder}
36  * <p>It is possible to set up a <code>AnimatorSet</code> with circular dependencies between
45  * <p>For more information about animating with {@code AnimatorSet}, read the
50 public final class AnimatorSet extends Animator {
61      * cancel or end when cancel() or end() is called on this AnimatorSet
74      * Set of all nodes created for this AnimatorSet. This list is used upon
97      * Flag indicating that the AnimatorSet has been manually
100      * child animations of this AnimatorSet end. It also determines whether cancel/end
106      * Indicates whether an AnimatorSet has been start()'d, whether or
119     // simply means that there is no duration set on the AnimatorSet. When a real duration is
124     // was set on this AnimatorSet, so it should not be passed down to the children.
129      * Sets up this AnimatorSet to play all of the supplied animations at the same time.
150      * Sets up this AnimatorSet to play all of the supplied animations at the same time.
169      * Sets up this AnimatorSet to play each of the supplied animations when the
188      * Sets up this AnimatorSet to play each of the supplied animations when the
208      * AnimatorSet. This is a copy of the internal list; modifications to the returned list
209      * will not affect the AnimatorSet, although changes to the underlying Animator objects
210      * will affect those objects being managed by the AnimatorSet.
212      * @return ArrayList<Animator> The list of child animations of this AnimatorSet.
224      * of this AnimatorSet that take targets ({@link ObjectAnimator} and
225      * AnimatorSet).
233             if (animation instanceof AnimatorSet) {
234                 ((AnimatorSet)animation).setTarget(target);
243      * of this AnimatorSet. The default value is null, which means that no interpolator
244      * is set on this AnimatorSet. Setting the interpolator to any non-null value
248      * @param interpolator the interpolator to be used by each child animation of this AnimatorSet
265      * calling <code>play(a1).with(a2)</code> sets up the AnimatorSet to play
267      * <code>play(a1).before(a2)</code> sets up the AnimatorSet to play
269      * <code>play(a1).after(a2)</code> sets up the AnimatorSet to play
284      * @return Builder The object that constructs the AnimatorSet based on the dependencies
299      * <p>Note that canceling a <code>AnimatorSet</code> also cancels all of the animations that it
335      * <p>Note that ending a <code>AnimatorSet</code> also ends all of the animations that it is
372      * Returns true if any of the child animations of this AnimatorSet have been started and have
374      * @return Whether this AnimatorSet has been started and has not yet ended.
414      * Gets the length of each of the child animations of this AnimatorSet. This value may
415      * be less than 0, which indicates that no duration has been set on this AnimatorSet
419      * animations of this AnimatorSet.
427      * Sets the length of each of the current child animations of this AnimatorSet. By default,
428      * each child animation will use its own duration. If the duration is set on the AnimatorSet,
432      * animations of this AnimatorSet.
435     public AnimatorSet setDuration(long duration) {
439         // Just record the value for now - it will be used later when the AnimatorSet starts
461      * <p>Starting this <code>AnimatorSet</code> will, in turn, start the animations for which
472             // If the duration was set on this AnimatorSet, pass it along to all child animations
474                 // TODO: don't set the duration of the timing-only nodes created by AnimatorSet to
565             // Handle unusual case where empty AnimatorSet is started - should send out
580     public AnimatorSet clone() {
581         final AnimatorSet anim = (AnimatorSet) super.clone();
584          * AnimatorSet, because it will copy references that need to be recreated and state
599         // One problem is that the old node dependencies point to nodes in the old AnimatorSet.
612             // clear out any listeners that were set up by the AnimatorSet; these will
656         private AnimatorSet mAnimatorSet;
665         public DependencyListener(AnimatorSet animatorSet, Node node, int rule) {
711                 // if the parent AnimatorSet was canceled, then don't start any dependent anims
739         private AnimatorSet mAnimatorSet;
741         AnimatorSetListener(AnimatorSet animatorSet) {
747                 // Listeners are already notified of the AnimatorSet canceling in cancel().
767                 // Listeners are already notified of the AnimatorSet ending in cancel() or
780                     // AnimatorSet has ended
849                         + " in AnimatorSet");
920          * if the AnimatorSet is launched in the future. So we create a copy of the dependency
921          * list when the AnimatorSet starts and use this tmpDependencies list to track the
941          * is used by AnimatorSet to check, as each animation ends, whether all child animations
942          * are done and it's time to send out an end event for the entire AnimatorSet.
992      * <code>AnimatorSet</code> along with the relationships between the various animations. The
994      * AnimatorSet#play(Animator) play()} method of <code>AnimatorSet</code> is to make it possible
996      * use the {@link AnimatorSet#playTogether(Animator[]) playTogether()} and {@link
997      * AnimatorSet#playSequentially(Animator[]) playSequentially()} methods if these suit the need,
998      * but it might be easier in some situations to express the AnimatorSet of animations in pairs.
1001      * internally via a call to {@link AnimatorSet#play(Animator)}.</p>
1003      * <p>For example, this sets up a AnimatorSet to play anim1 and anim2 at the same time, anim3 to
1006      *     AnimatorSet s = new AnimatorSet();
1019      * {@link AnimatorSet#play(Animator)} method that is the dependency in any of the successive
1024      *   AnimatorSet s = new AnimatorSet();
1030      *   AnimatorSet s = new AnimatorSet();
1046          * of AnimatorSet and passed into the constructor of Builder.
1051          * package-private constructor. Builders are only constructed by AnimatorSet, when the
1068          * {@link AnimatorSet#play(Animator)} call that created this <code>Builder</code> object.
1071          * {@link AnimatorSet#play(Animator)} method starts.
1087          * {@link AnimatorSet#play(Animator)} call that created this <code>Builder</code> object
1091          * {@link AnimatorSet#play(Animator)} method ends.
1107          * {@link AnimatorSet#play(Animator)} call that created this <code>Builder</code> object
1111          * {@link AnimatorSet#play(Animator)} method to play.
1127          * {@link AnimatorSet#play(Animator)} call that created this <code>Builder</code> object

Indexes created Thu Nov 07 17:47:47 CET 2013