Instance Property

fractionComplete

Required.

The completion percentage of the animation.

Declaration

var fractionComplete: CGFloat { get set }

Discussion

The value of this property is 0.0 at the beginning of the animation and 1.0 at the end of the animation. Intermediate values represent progress in the execution of the animation. For example, the value 0.5 indicates that the animation is exactly half way complete.

Assigning a new value to this property causes the animator to update the animation progress to the value you specify. You can use this capability to create interactive animations. For example, you might use a pan gesture recognizer to update the value based on the completion progress of that gesture. You can update the value of this property only while the animator is paused. Changing the value of this property on an inactive animator moves it to the active state.

When defining a custom animator, you may allow values greater than 1.0 or less than 0.0 if you support animations running past their beginning or end points.