Instance Method

addAnimations:

Adds the specified animation block to the animator.

Declaration

- (void)addAnimations:(void (^)(void))animation;

Parameters

animation

A block containing the animations you want to add to the animator object. This block has no return value and takes no parameters. This parameter must not be nil.

Discussion

Use this method to add new animation blocks to the animator. The animations in the new block run alongside any previously configured animations. Blocks added while the animator’s state is UIViewAnimatingStateInactive are executed over the time specified by the duration property. Blocks added while the animator’s state is UIViewAnimatingStateActive are executed over the remaining portion of the total run time. For example, if the duration is 2.0 and you add an animation block to a running animator whose fractionComplete property is 0.5, the animations run for 1.0 second. Any blocks you add while the animator is running begin executing immediately.

If the animation block modifies a property that is being modified by a different property animator, then the animators combine their changes in the most appropriate way. For many properties, the changes from each animator are added together to yield a new intermediate value. If a property cannot be modified in this additive manner, the new animations take over as if the UIViewAnimationOptionBeginFromCurrentState option had been specified for a view-based animation.

You can call this method multiple times to add multiple blocks to the animator. It is a programmer error to call this method when the animator’s state property is set to UIViewAnimatingStateStopped.

See Also

Modifying Animations

- addAnimations:delayFactor:

Adds the specified animation block with a delay.

- addCompletion:

Adds the specified completion block to the animator.

- continueAnimationWithTimingParameters:durationFactor:

Adjusts the timing and duration of a paused animation.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software