Question

I’m trying to understand how view animations work in iOS; i currently have an animation that i create with:

+ (void)animateWithDuration:(NSTimeInterval)duration
                      delay:(NSTimeInterval)delay
                    options:(UIViewAnimationOptions)options
                 animations:(void (^)(void))animations
                 completion:(void (^)(BOOL finished))completion

But I’ve got a question concerning the finished parameter in the completion block; what the finished parameter does i somewhat understand in the sense that if finished is YES the animation actually happened which is a good thing, but what does it mean when it is set to NO and what is the common way to deal with this normally, especially if you want to chain animations (calling a next animation in the completion block) that work on the same view?

The reason I ask is because it returns NO at sometimes for reasons unclear to me, as the view is present in the view hierarchy and there are no other animations intervening.

Answer 1

It means that for some reason or another the animation did not complete. The view could have been removed from its superview for example or another animation could have been applied to it, or a number of other reasons best known to Apple. How you deal with it is up to you. You could start the entire animation chain again, start at the last animation, or the next.