Tasks

Creation and Initialization

• – initWithTableView:dataStore:

  Returns an initialized ‘SCArrayOfItemsModel given a UITableView and a data store.

Configuration

•   dataStore

  The data store that’s used to store and fetch the model’s items.

  property
•   dataFetchOptions

  The options used to fetch the model’s items from dataStore.

  property
•   items

  The items fetched from dataStore.

  property
•   autoFetchItems

  Set to FALSE to disable the section from automatically fetching its items from dataStore. Default: TRUE.

  property
•   itemsAccessoryType

  The accessory type of the generated cells.

  property
•   allowAddingItems

  Allows/disables adding new cells/items to the items array. Default: TRUE.

  property
•   allowDeletingItems

  Allows/disables deleting new cells/items from the items array. Default: TRUE.

  property
•   allowMovingItems

  Allows/disables moving cells/items from one row to another. Default: FALSE.

  property
•   allowEditDetailView

  Allows/disables a detail view for editing items' values. Default: TRUE.

  property
•   allowRowSelection

  Allows/disables row selection. Default: TRUE.

  property
•   autoSelectNewItemCell

  Allows/disables automatic cell selection of newly created items. Default: TRUE.

  property
•   addButtonItem

  Set this property to a valid UIBarButtonItem. When addButtonItem is tapped and allowAddingItems is TRUE, a detail view is automatically generated for the user to enter the new items properties. If the properties are commited, a new item is added to the array.

  property
•   searchBar

  The search bar associated with the model. Once set to a valid UISearchBar, the model will automatically filter its items based on the user’s typed search term.

  property
•   enableSearchDisplayController

  Set to TRUE to use a UISearchDisplayController to perform searches. Default: FALSE.

  property
•   searchDisplayController

  The UISearchDisplayController used to search the model values.

  property
•   detailViewControllerOptions

  Options for the generated detail view controller.

  property
•   newItemDetailViewControllerOptions

  Options for the generated detail view controller for new items.

  property

Manual Event Control

• – dispatchEventAddNewItem

  User can call this method to dispatch an AddNewItem event, the same event dispached when the end-user taps addButtonItem.

• – dispatchEventSelectRowAtIndexPath:

  User can call this method to dispatch a SelectRow event, the same event dispached when the end-user selects a cell.

• – dispatchEventRemoveRowAtIndexPath:

  User can call this method to dispatch a RemoveRow event, the same event dispached when the end-user taps the delete button on a cell.

Internal Properties & Methods (should only be used by the framework or when subclassing)

• – mutableItems

  Used internally by the framework.

• – setMutableItems:

  Used internally by the framework.

• – createSectionWithHeaderTitle:

  Subclasses should override this method to handle section creation.

• – setPropertiesForSection:

  Subclasses should override this method to set additional section properties after creation.

• – didTapAddButtonItem

  Subclasses should override this method to handle when addButtonItem is tapped.

• – addNewItem:

  Method called internally by framework when the model should add a new item.

• – itemModified:inSection:

  Method called internally by framework when a model item has been modified.

• – itemRemoved:inSection:

  Method called internally by framework when a model item has been removed.

• – invalidateItems

  Method called internally by framework when the model’s items are out of sync with the data store.

• – getSectionIndexForItem:

  Method called internally by framework.

• – setDetailViewControllerOptions:

  Method called internally.

• – setNewItemDetailViewControllerOptions:

  Method called internally.