SCArrayOfObjectsCell

@interface SCArrayOfObjectsCell : SCCustomCell {
  SCDataStore *dataStore;
  SCDataFetchOptions *dataFetchOptions;
  BOOL allowAddingItems;
  BOOL allowDeletingItems;
  BOOL allowMovingItems;
  BOOL allowEditDetailView;
  BOOL allowRowSelection;
  BOOL autoSelectNewItemCell;
  BOOL displayItemsCountInBadgeView;
  SCTableViewCell *placeholderCell;
  SCTableViewCell *addNewItemCell;
  BOOL addNewItemCellExistsInNormalMode;
  BOOL addNewItemCellExistsInEditingMode;
  SCSectionActions *_detailSectionActions;
}

This class functions as a cell that, given an array of objects, will generate an SCArrayOfObjectsSection detail view that’s displayed when the cell is tapped.

The cell can also be optionally bound to an object and generate an additional SCObjectSection detail view when the cell is tapped while the table is in edit mode.

See

SCObjectCell, SCObjectSection, SCArrayOfObjectsSection.

Show on GitHub

dataStore
Undocumented
Declaration
Objective-C

SCDataStore *dataStore
Show on GitHub
dataFetchOptions
Undocumented
Declaration
Objective-C

SCDataFetchOptions *dataFetchOptions
Show on GitHub
allowAddingItems
Undocumented
Declaration
Objective-C

BOOL allowAddingItems
Show on GitHub
allowDeletingItems
Undocumented
Declaration
Objective-C

BOOL allowDeletingItems
Show on GitHub
allowMovingItems
Undocumented
Declaration
Objective-C

BOOL allowMovingItems
Show on GitHub
allowEditDetailView
Undocumented
Declaration
Objective-C

BOOL allowEditDetailView
Show on GitHub
allowRowSelection
Undocumented
Declaration
Objective-C

BOOL allowRowSelection
Show on GitHub
autoSelectNewItemCell
Undocumented
Declaration
Objective-C

BOOL autoSelectNewItemCell
Show on GitHub
displayItemsCountInBadgeView
Undocumented
Declaration
Objective-C

BOOL displayItemsCountInBadgeView
Show on GitHub
placeholderCell
Undocumented
Declaration
Objective-C

SCTableViewCell *placeholderCell
Show on GitHub
addNewItemCell
Undocumented
Declaration
Objective-C

SCTableViewCell *addNewItemCell
Show on GitHub
addNewItemCellExistsInNormalMode
Undocumented
Declaration
Objective-C

BOOL addNewItemCellExistsInNormalMode
Show on GitHub
addNewItemCellExistsInEditingMode
Undocumented
Declaration
Objective-C

BOOL addNewItemCellExistsInEditingMode
Show on GitHub
_detailSectionActions
Undocumented
Declaration
Objective-C

SCSectionActions *_detailSectionActions
Show on GitHub

Creation and Initialization

+cellWithDataStore:
Allocates and returns an initialized SCArrayOfObjectsCell given a data store. *
- - parameter: store The data store containing the cell’s objects.
Declaration
Objective-C

+ (instancetype)cellWithDataStore:(SCDataStore *)store;
Show on GitHub
+cellWithItems:itemsDefinition:
Allocates and returns an initialized SCArrayOfObjectsCell given an array of objects and their class definition. *
- - parameter: cellItems An array of objects that the cell will use to generate its detail cells.
- - parameter: definition The definition of the objects in the objects array. If the array contains more than one type of object, then their respective definitions must be added to the itemsClassDefinitions dictionary after initialization.
Declaration
Objective-C

+ (instancetype)cellWithItems:(NSMutableArray *)cellItems itemsDefinition:(SCDataDefinition *)definition;
Show on GitHub
-initWithDataStore:
Returns an initialized SCArrayOfObjectsCell given a data store. *
- - parameter: store The data store containing the cell’s objects.
Declaration
Objective-C

- (instancetype)initWithDataStore:(SCDataStore *)store;
Show on GitHub
-initWithItems:itemsDefinition:
Returns an initialized SCArrayOfObjectsCell given an array of objects and their class definition. *
- - parameter: cellItems An array of objects that the cell will use to generate its detail cells.
- - parameter: definition The class definition of the class or entity of the objects in the objects array. If the array contains more than one type of object, then their respective class definitions must be added to the itemsClassDefinitions dictionary after initialization.
Declaration
Objective-C

- (instancetype)initWithItems:(NSMutableArray *)cellItems itemsDefinition:(SCDataDefinition *)definition;
Show on GitHub

Configuration

dataStore
The data store that’s used to store and fetch the cell’s objects.
Declaration
Objective-C

@property (nonatomic, strong) SCDataStore *dataStore;
Show on GitHub
dataFetchOptions
The options used to fetch the cell’s items from dataStore.
Declaration
Objective-C

@property (nonatomic, strong) SCDataFetchOptions *dataFetchOptions;
Show on GitHub
items
The items fetched from the dataStore.
Declaration
Objective-C

@property (nonatomic, readonly) NSArray *items;
Show on GitHub
allowAddingItems
Allows/disables adding new objects to the items array. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL allowAddingItems;
Show on GitHub
allowDeletingItems
Allows/disables deleting new objects from the items array. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL allowDeletingItems;
Show on GitHub
allowMovingItems
Allows/disables moving objects from one row to another. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL allowMovingItems;
Show on GitHub
allowEditDetailView
Allows/disables editing detail views for objects. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL allowEditDetailView;
Show on GitHub
allowRowSelection
Allows/disables row selection. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL allowRowSelection;
Show on GitHub
autoSelectNewItemCell
Allows/disables automatic cell selection of newly created items. Default: FALSE.
Declaration
Objective-C

@property (nonatomic) BOOL autoSelectNewItemCell;
Show on GitHub
displayItemsCountInBadgeView
Allows/disables displaying the number of objects in the cell’s badgeView. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL displayItemsCountInBadgeView;
Show on GitHub
detailSectionActions
The set of actions for the cell’s automatically generated detail section.
Declaration
Objective-C

@property (nonatomic, readonly) SCSectionActions *detailSectionActions;
Show on GitHub

Configuring Special Cells

placeholderCell
When set to a valid cell object, ‘placeholderCell’ will be displayed when no items exist in the generated section. As soon as any items are added, this cell automatically disappears. Default: nil.
Declaration
Objective-C

@property (nonatomic, strong) SCTableViewCell *placeholderCell;
Show on GitHub
addNewItemCell
When set to a valid cell object, ‘addNewItemCell’ will be displayed as the last cell of the generated section, and will add a new item to the section whenever it gets tapped by the user. This cell can be used as an alternative to the section’s addButtonItem. Default: nil.
Declaration
Objective-C

@property (nonatomic, strong) SCTableViewCell *addNewItemCell;
Show on GitHub
addNewItemCellExistsInNormalMode
When TRUE, addNewItemCell will be displayed in Normal Mode. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL addNewItemCellExistsInNormalMode;
Show on GitHub
addNewItemCellExistsInEditingMode
When TRUE, addNewItemCell will be displayed in Editing Mode. Default: TRUE.
Declaration
Objective-C

@property (nonatomic) BOOL addNewItemCellExistsInEditingMode;
Show on GitHub

Creation and Initialization


                    
                    
                    +cellWithEntityDefinition:

Allocates and returns an initialized SCArrayOfObjectsCell given a header title and an entity definition.

Note

This method creates a cell with all the objects that exist in classDefinition’s entity’s managedObjectContext. To create a cell with only a subset of these objects, consider using the other cell initializers.

Declaration

Objective-C

+ (instancetype)cellWithEntityDefinition:(SCEntityDefinition *)definition;

Parameters


                                definition

The entity definition of the objects in the objects set.

Show on GitHub


                    
                    
                    +cellWithBoundItemsSet:boundSetEntityDefinition:boundSetOwnsObjects:

Allocates and returns an initialized SCArrayOfObjectsCell given a mutable set of objects.

Warning

This method should only be used to create a cell with the contents of a Core Data relationship.

Declaration

Objective-C

+ (instancetype)cellWithBoundItemsSet:(NSMutableSet *)cellItemsSet
             boundSetEntityDefinition:(SCEntityDefinition *)definition
                  boundSetOwnsObjects:(BOOL)ownsObjects;

Parameters

`cellItemsSet`	A mutable set of objects that the cell will use to generate its cells.
`definition`	The class definition of the entity of the objects in the objects set.

Show on GitHub


                    
                    
                    -initWithEntityDefinition:

Returns an initialized SCArrayOfObjectsCell given a header title and an entity definition.

Note

Declaration

Objective-C

- (instancetype)initWithEntityDefinition:(SCEntityDefinition *)definition;

Parameters


                                definition

The entity definition of the objects in the objects set.

Show on GitHub


                    
                    
                    -initWithBoundItemsSet:boundSetEntityDefinition:boundSetOwnsObjects:

Returns an initialized SCArrayOfObjectsCell given a mutable set of objects.

Warning

This method should only be used to create a cell with the contents of a Core Data relationship.

Declaration

Objective-C

- (instancetype)initWithBoundItemsSet:(NSMutableSet *)cellItemsSet
             boundSetEntityDefinition:(SCEntityDefinition *)definition
                  boundSetOwnsObjects:(BOOL)ownsObjects;

Parameters

`cellItemsSet`	A mutable set of objects that the cell will use to generate its cells.
`definition`	The class definition of the entity of the objects in the objects set.

Show on GitHub