UICollisionBehaviorDelegate Protocol Reference

Conforms to
Framework
/System/Library/Frameworks/UIKit.framework
Availability
Available in iOS 7.0 and later.
Declared in
UICollisionBehavior.h

Overview

To respond to UIKit dynamic item collisions, configure a custom class to adopt the UICollisionBehaviorDelegate protocol. Then, in a collision behavior (an instance of the UICollisionBehavior class), set the delegate to be an instance of your custom class.

The delegate is notified of collisions that occur between the behavior’s dynamic items, or between a dynamic item and a boundary, depending on the behavior’s mode (as set with its collisionMode property). In the case of a collision between an item and the boundary defined by a reference view, the identifier passed to the delegate method is nil. (For more on the reference view and the different ways to initialize a dynamic animator, read the Overview in UIDynamicAnimator Class Reference.)

Tasks

Responding to UIKit Dynamics Collisions

Instance Methods

collisionBehavior:beganContactForItem:withBoundaryIdentifier:atPoint:

Called when a collision, between a dynamic item and a collision boundary, has begun.

- (void)collisionBehavior:(UICollisionBehavior *)behavior beganContactForItem:(id<UIDynamicItem>)item withBoundaryIdentifier:(id<NSCopying>)identifier atPoint:(CGPoint)p
Parameters
behavior

The collision behavior that owns the dynamic item that has started contact with a boundary.

item

The dynamic item that has started contact with a boundary.

identifier

The identifier of the boundary that the dynamic item has started contact with.

p

The collision point on the boundary.

Availability
  • Available in iOS 7.0 and later.
Declared In
UICollisionBehavior.h

collisionBehavior:beganContactForItem:withItem:atPoint:

Called when a collision between two dynamic items has begun.

- (void)collisionBehavior:(UICollisionBehavior *)behavior beganContactForItem:(id<UIDynamicItem>)item1 withItem:(id<UIDynamicItem>)item2 atPoint:(CGPoint)p
Parameters
behavior

The collision behavior that owns the dynamic items that have started to contact each other.

item1

The first of the two dynamic items participating in the collision.

item2

The second of the two dynamic items participating in the collision.

p

The contact point for the collision. The coordinate system that pertains to a collision depends on how you initialized the associated animator. For details, read the Overview of UIDynamicAnimator Class Reference.

Availability
  • Available in iOS 7.0 and later.
Declared In
UICollisionBehavior.h

collisionBehavior:endedContactForItem:withBoundaryIdentifier:

Called when a collision between a dynamic item and a boundary has ended.

- (void)collisionBehavior:(UICollisionBehavior *)behavior endedContactForItem:(id<UIDynamicItem>)item withBoundaryIdentifier:(id<NSCopying>)identifier
Parameters
behavior

The collision behavior that owns the dynamic item that has ended contact.

item

The dynamic item that collided.

identifier

The identifier of the boundary that the dynamic item collided with.

Availability
  • Available in iOS 7.0 and later.
Declared In
UICollisionBehavior.h

collisionBehavior:endedContactForItem:withItem:

Called when a collision between two dynamic items has ended.

- (void)collisionBehavior:(UICollisionBehavior *)behavior endedContactForItem:(id<UIDynamicItem>)item1 withItem:(id<UIDynamicItem>)item2
Parameters
behavior

The collision behavior that owns the dynamic items that collided.

item1

The first of the two dynamic items participating in the collision.

item2

The second of the two dynamic items participating in the collision.

Availability
  • Available in iOS 7.0 and later.
Declared In
UICollisionBehavior.h