<NIPagingScrollViewPage> Protocol Reference

Overview

The protocol that a paging scroll view page should implement.

By providing a protocol instead of a UIView base class we allow more flexibility when building pages.

Inheritance diagram for <NIPagingScrollViewPage>:

Tasks
NSInteger	pageIndex property
(void)	- pageDidDisappear
(void)	- setFrameAndMaintainState:
NSString *	reuseIdentifier property
(void)	- prepareForReuse

Method Documentation

pageIndex

The index of this page view.

@property (nonatomic) NSInteger pageIndex;

pageDidDisappear

Called after the page has gone off-screen.

- (void)pageDidDisappear;

Discussion

This method should be used to reset any state information after a page goes off-screen. For example, in the Nimbus photo viewer we reset the zoom scale so that if the photo was zoomed in it will fit on the screen again when the user flips back and forth between two pages.

setFrameAndMaintainState:

Called when the frame of the page is going to change.

- (void)setFrameAndMaintainState:(CGRect)frame;

Discussion

Use this method to maintain any state that may be affected by the frame changing. The Nimbus photo viewer uses this method to save and restore the zoom and center point. This makes the photo always appear to rotate around the center point of the screen rather than the center of the photo.

reuseIdentifier

The identifier used to categorize views into buckets for reuse.

@property (nonatomic, copy) NSString* reuseIdentifier;

Discussion

Views will be reused when a new view is requested with a matching identifier.

If the reuseIdentifier is nil then the class name will be used.

prepareForReuse

Called immediately after the view has been dequeued from the recycled view pool.

- (void)prepareForReuse;