Type Method


Creates and returns an animator object that begins running its animations immediately.


+ (instancetype)runningPropertyAnimatorWithDuration:(NSTimeInterval)duration delay:(NSTimeInterval)delay options:(UIViewAnimationOptions)options animations:(void (^)(void))animations completion:(void (^)(UIViewAnimatingPosition finalPosition))completion;



The duration of the animation, in seconds.


The number of seconds to wait before starting the animations. Specify 0 to begin the animations immediately.


The options to apply to the animations. You can specify most options, but transition-related options and options related to the animation direction are ignored. For a list of options, see UIViewAnimationOptions.


The block containing the animations. This block has no return value and takes no parameters. Use this block to modify any animatable properties of your view. Those properties are animated from their current values to the new values using the specified animation parameters.


The block to execute when the animations finish. You can use this block to perform any final actions. This block has no return value and takes the following parameter:


The ending position of the animations. Use this value to determine whether the animations stopped at the beginning, end, or somewhere in the middle.

Return Value

An initialized animator object or nil if the object could not be created.


This method creates the property animator object, configures it, and calls its startAnimation method after the specified delay. If you do not specify an animation curve in the options parameter, this method uses the UIViewAnimationOptionCurveEaseInOut option.

See Also

Initializing a Property Animator

- initWithDuration:curve:animations:

Initializes the animator with a built-in UIKit timing curve.

- initWithDuration:controlPoint1:controlPoint2:animations:

Initializes the animator object with a cubic Bézier timing curve.

- initWithDuration:dampingRatio:animations:

Initializes the animator object with spring-based timing information.

- initWithDuration:timingParameters:

Initializes the animator object with a custom timing curve object.