IGGridViewPullDownCell Class Reference

Inherits from IGGridViewCellBase : UIView
Declared in IGGridViewCell.h

Overview

The IGGridViewPullDownCell is a cell that is used to simulate a feature similar to facebook and twitter, where a user can pull the grid view past it’s extent, and release to refresh. This cell can be used to customize what is displayed in it’s three modes.

The three modes are as follows:

PullDown: This is the intial state. It occurs when the user firsts starts to pull down the grid view past its extent. An example of what it would display is “Pull down to refresh…”

Release: This state occurs when the user pulls the grid view past its extent the distance of the grid view’s pullDownRowHeight property. An example of what it would display is “Release to refresh…”

Updating: This is the final state. It occurs when the user releases the grid view while it’s in the Release state. At this point the grid view’s delegate will notify the developer that it is in it’s update state, and that they should perform an action to refresh their content. When the developer has done this, then can then invoke the grid view’s finishedUpdating method.

Deriving from this cell, you can actually control what gets displayed in each state, and even supply a transition by using the following methods: changeStateToPullDownMode changeStateToReleaseMode changeStateToUpdatingMode

If all you desire is to change the text that is used in each state, you can use the following properties: pullDownText releaseText updatingText

To use a custom IGGridViewPullDownCell in the IGGridView, simply use the following selector on the IGGridViewDataSource - (IGGridViewPullDownCell ) pullDownCellForGridView:(IGGridView)gridView;

Display

  displayLabel

This is the main display element of the cell. You should not set the text property directly, instaed use the pullDownText, releaseText, and updatingText properties.

@property (nonatomic, readonly) UILabel *displayLabel

Declared In

IGGridViewCell.h

  updatingIndicator

This is a UIActivityIndicatorView that will be displayed when the cell is in it’s Updating state.

@property (nonatomic, readonly) UIActivityIndicatorView *updatingIndicator

Discussion

To disable the indicator set the displayUpdatingIndicator to NO.

Declared In

IGGridViewCell.h

  displayUpdatingIndicator

Controls whether the updatingIndicator will be displayed in the cell when its in it’s Updating state.

@property (nonatomic, assign) BOOL displayUpdatingIndicator

Declared In

IGGridViewCell.h

Display Text

  pullDownText

The text that is used in the displayLabel when the cell is in it’s PullDown state

@property (nonatomic, retain, nullable) NSString *pullDownText

Declared In

IGGridViewCell.h

  releaseText

The text that is used in the displayLabel when the cell is in it’s Release state

@property (nonatomic, retain, nullable) NSString *releaseText

Declared In

IGGridViewCell.h

  updatingText

The text that is used in the displayLabel when the cell is in it’s Updating state

@property (nonatomic, retain, nullable) NSString *updatingText

Declared In

IGGridViewCell.h

Protected Overrides

– changeStateToPullDownMode

This method is invoked when the cell is going into it’s pull down mode.

- (void)changeStateToPullDownMode

Discussion

Use this method to transition your content into the pull down mode.

Declared In

IGGridViewCell.h

– changeStateToReleaseMode

This method is invoked when the cell is going into it’s release mode.

- (void)changeStateToReleaseMode

Discussion

Use this method to transition your content into the release mode.

Declared In

IGGridViewCell.h

– changeStateToUpdatingMode

This method is invoked when the cell is going into it’s updating mode.

- (void)changeStateToUpdatingMode

Discussion

Use this method to transition your content into the updating mode.

Declared In

IGGridViewCell.h