Class

NSAnimationContext

An animation context, which contains information about environment and state.

Declaration

@interface NSAnimationContext : NSObject

Overview

NSAnimationContext is analogous to CATransaction and is similar in overall concept to NSGraphicsContext. Each thread maintains its own stack of nestable NSAnimationContext instances, with each new instance initialized as a copy of the instance below (so, inheriting its current properties).

Multiple NSAnimationContext instances can be nested, allowing a given block of code to initiate animations using its own specified duration without affecting animations initiated by surrounding code.

[NSAnimationContext beginGrouping];
// Animate enclosed operations with a duration of 1 second
[[NSAnimationContext currentContext] setDuration:1.0];
[[aView animator] setFrame:newFrame];
...
    [NSAnimationContext beginGrouping];
    // Animate alpha fades with half-second duration
    [[NSAnimationContext currentContext] setDuration:0.5];
    [[aView animator] setAlphaValue:0.75];
    [[bView animator] setAlphaValue:0.75];
    [NSAnimationContext endGrouping];
...
// Will animate with a duration of 1 second
[[bView animator] setFrame:secondFrame];
[NSAnimationContext endGrouping];

Topics

Grouping Transactions

+ beginGrouping

Creates a new animation grouping.

+ endGrouping

Ends the current animation grouping.

Getting the Current Animation Context

currentContext

Returns the current animation context.

Animation Completion Handlers

completionHandler

A completion Block that is called when the animations in the grouping are completed.

+ runAnimationGroup:completionHandler:

Allows you to specify a completion block body after the set of animation actions whose completion will trigger the completion block.

Modifying the Animation Duration

duration

The duration used by animations created as a result of setting new values for an animatable property.

timingFunction

The timing function used for all animations within this animation proxy group.

Implicit Animation

allowsImplicitAnimation

Determine if animations are enabled or not for animations that occur as a result of another property change.

Relationships

Inherits From

See Also

View-Based Animations

NSViewAnimation

An animation of an app's views, limited to changes in frame location and size, and to fade-in and fade-out effects.

NSAnimatablePropertyContainer

A set of methods that defines a way to add animation to an existing class with a minimum of API impact.

NSAnimationProgress

The animation progress, as a floating-point number between 0.0 and 1.0.

NSAnimationEffect

The type for standard system animation effects, which include both display and sound.