<NILauncherDataSource> Protocol Reference

Overview

The launcher data source used to populate the view.

Inheritance diagram for <NILauncherDataSource>:

Tasks
Configuring a Launcher View
(NSInteger)	- launcherView:numberOfButtonsInPage:
(UIView< NILauncherButtonView > *)	- launcherView:buttonViewForPage:atIndex:
(NSInteger)	- numberOfPagesInLauncherView:
(NSInteger)	- numberOfRowsPerPageInLauncherView:
(NSInteger)	- numberOfColumnsPerPageInLauncherView:

Method Documentation

launcherView:numberOfButtonsInPage:

Tells the receiver to return the number of rows in a given section of a table view (required).

- (NSInteger)launcherView:(NILauncherView *)launcherView numberOfButtonsInPage:(NSInteger)page;

Discussion

Parameters

launcherView	The launcher-view object requesting this information.
page	The index locating a page in launcherView.

Returns

The number of buttons in page.

launcherView:buttonViewForPage:atIndex:

Tells the receiver to return a button view for inserting into a particular location of a given page in the launcher view (required).

- (UIView<NILauncherButtonView>*)launcherView:(NILauncherView *)launcherView buttonViewForPage:(NSInteger)page atIndex:(NSInteger)index;

Discussion

Parameters

launcherView	The launcher-view object requesting this information.
page	The index locating a page in launcherView.
index	The index locating a button in a page.

Returns

A UIView that conforms to NILauncherButtonView that the launcher will display on the given page. An assertion is raised if you return nil.

numberOfPagesInLauncherView:

Asks the receiver to return the number of pages in the launcher view.

- (NSInteger)numberOfPagesInLauncherView:(NILauncherView *)launcherView;

Discussion

It is assumed that the launcher view has one page if this method is not implemented.

Parameters

launcherView

The launcher-view object requesting this information.

Returns

The number of pages in launcherView. The default value is 1.

See Also

- launcherView:numberOfButtonsInPage:

numberOfRowsPerPageInLauncherView:

Asks the receiver to return the number of rows of buttons each page can display in the launcher view.

- (NSInteger)numberOfRowsPerPageInLauncherView:(NILauncherView *)launcherView;

Discussion

This method will be called each time the frame of the launcher view changes. Notably, this will be called when the launcher view has been rotated as a result of a device rotation.

Parameters

launcherView

The launcher-view object requesting this information.

Returns

The number of rows of buttons each page can display.

See Also

- numberOfColumnsPerPageInLauncherView:

numberOfColumnsPerPageInLauncherView:

Asks the receiver to return the number of columns of buttons each page can display in the launcher view.

- (NSInteger)numberOfColumnsPerPageInLauncherView:(NILauncherView *)launcherView;

Discussion

This method will be called each time the frame of the launcher view changes. Notably, this will be called when the launcher view has been rotated as a result of a device rotation.

Parameters

launcherView

The launcher-view object requesting this information.

Returns

The number of columns of buttons each page can display.

See Also

- numberOfRowsPerPageInLauncherView: