SCSelectionCell Class Reference
| Inherits from | SCLabelCell : SCControlCell : SCCustomCell : SCTableViewCell : UITableViewCell |
| Declared in | SCTableViewCell.h |
Overview
This class functions as a cell that provides the end-user with an automatically generated detail view of options to choose from, much like the Ringtone selection cell in the iPhone’s sound settings. The selection items are provided in the form of an array of NSStrings, called the items array. ‘SCSelectionCell’ can be configured to allow multiple selection and to allow no selection at all. the bound property of this cell must be of type NSNumber, NSString, or NSMutableSet. If allowMultipleSelection is TRUE, then only NSString and NSMutableSet property types are allowed.
Tasks
Creation and Initialization
-
+ cellWithText:boundObject:selectedIndexPropertyName:items: -
+ cellWithText:boundObject:selectedIndexesPropertyName:items:allowMultipleSelection: -
+ cellWithText:boundObject:selectionStringPropertyName:items: -
– initWithText:boundObject:selectedIndexPropertyName:items: -
– initWithText:boundObject:selectedIndexesPropertyName:items:allowMultipleSelection: -
– initWithText:boundObject:selectionStringPropertyName:items:
Configuration
-
selectionItemsStoreproperty -
selectionItemsFetchOptionsproperty -
itemsproperty -
selectedItemIndexproperty -
selectedItemsIndexesproperty -
allowMultipleSelectionproperty -
allowNoSelectionproperty -
maximumSelectionsproperty -
autoDismissDetailViewproperty -
hideDetailViewNavigationBarproperty -
allowAddingItemsproperty -
allowDeletingItemsproperty -
allowMovingItemsproperty -
allowEditDetailViewproperty -
displaySelectionproperty -
delimeterproperty
Configuring Special Cells
-
placeholderCellproperty -
addNewItemCellproperty -
addNewItemCellExistsInNormalModeproperty -
addNewItemCellExistsInEditingModeproperty
Properties
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 addButtonItem. Default: nil.
@property (nonatomic, strong) SCTableViewCell *addNewItemCellDeclared In
SCTableViewCell.haddNewItemCellExistsInEditingMode
When TRUE, addNewItemCell will be displayed in Editing Mode. Default: TRUE.
@property (nonatomic, readwrite) BOOL addNewItemCellExistsInEditingModeDeclared In
SCTableViewCell.haddNewItemCellExistsInNormalMode
When TRUE, addNewItemCell will be displayed in Normal Mode. Default: FALSE.
@property (nonatomic, readwrite) BOOL addNewItemCellExistsInNormalModeDeclared In
SCTableViewCell.hallowAddingItems
Allows/disables adding new objects to the items array. Default: FALSE.
@property (nonatomic, readwrite) BOOL allowAddingItemsDeclared In
SCTableViewCell.hallowDeletingItems
Allows/disables deleting new objects from the items array. Default: FALSE.
@property (nonatomic, readwrite) BOOL allowDeletingItemsDeclared In
SCTableViewCell.hallowEditDetailView
Allows/disables editing detail views for items. Default: FALSE.
@property (nonatomic, readwrite) BOOL allowEditDetailViewDeclared In
SCTableViewCell.hallowMovingItems
Allows/disables moving an item from one row to another. Default: FALSE.
@property (nonatomic, readwrite) BOOL allowMovingItemsDeclared In
SCTableViewCell.hallowMultipleSelection
If TRUE, the cell allows multiple selection. Default: FALSE.
@property (nonatomic, readwrite) BOOL allowMultipleSelectionDeclared In
SCTableViewCell.hallowNoSelection
If TRUE, the cell allows no selection at all. Default: FALSE.
@property (nonatomic, readwrite) BOOL allowNoSelectionDeclared In
SCTableViewCell.hautoDismissDetailView
If TRUE, the detail view is automatically dismissed when an item is selected. Default: FALSE.
@property (nonatomic, readwrite) BOOL autoDismissDetailViewDeclared In
SCTableViewCell.hdelimeter
The delimeter that separates the titles of the selected items. Default: @“ ,”.
@property (nonatomic, copy) NSString *delimeterDiscussion
Note: This property is applicable only if displaySelection is TRUE.
Declared In
SCTableViewCell.hdisplaySelection
If TRUE, the cell displays the selected items' titles inside the cell in a left aligned label. Default: TRUE.
@property (nonatomic, readwrite) BOOL displaySelectionDeclared In
SCTableViewCell.hhideDetailViewNavigationBar
If TRUE, the detail view’s navigation bar is hidder. Default: FALSE.
@property (nonatomic, readwrite) BOOL hideDetailViewNavigationBarDiscussion
Note: Only applicable when autoDismissDetailView is TRUE.
Declared In
SCTableViewCell.hitems
The items stored in selectionItemsStore.
@property (nonatomic, strong) NSArray *itemsDeclared In
SCTableViewCell.hmaximumSelections
The maximum number of items that can be selected. Set to zero to allow an infinite number of selections. Default: 0.
@property (nonatomic, readwrite) NSUInteger maximumSelectionsDiscussion
Note: Only applicable when allowMultipleSelection is TRUE.
Declared In
SCTableViewCell.hplaceholderCell
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.
@property (nonatomic, strong) SCTableViewCell *placeholderCellDeclared In
SCTableViewCell.hselectedItemIndex
This property reflects the current cell’s selection. You can set this property to define the cell’s selection.
@property (nonatomic, copy) NSNumber *selectedItemIndexDiscussion
Note: If you have bound this cell to an object or a key, you can define the cell’s selection using either the bound property value or the key value, respectively.
Declared In
SCTableViewCell.hselectedItemsIndexes
This property reflects the current cell’s selection(s). You can add index(es) to the set to define the cell’s selection.
@property (nonatomic, readonly) NSMutableSet *selectedItemsIndexesDiscussion
Note: If you have bound this cell to an object or a key, you can define the cell’s selection using either the bound property value or the key value, respectively.
Declared In
SCTableViewCell.hselectionItemsFetchOptions
The fetch options for the selection items.
@property (nonatomic, strong) SCDataFetchOptions *selectionItemsFetchOptionsDeclared In
SCTableViewCell.hselectionItemsStore
The data store for the selection items.
@property (nonatomic, strong) SCDataStore *selectionItemsStoreDeclared In
SCTableViewCell.hClass Methods
cellWithText:boundObject:selectedIndexPropertyName:items:
Allocates and returns an initialized SCSelectionCell given cell text, bound object, an NSNumber bound property name, and an array of selection items.
+ (instancetype)cellWithText:(NSString *)cellText boundObject:(NSObject *)object selectedIndexPropertyName:(NSString *)propertyName items:(NSArray *)cellItemsParameters
- cellText
The text that will appear in the cell’s textLabel.
- object
The cell’s bound object (see SCTableViewCell class overview).
- propertyName
The cell’s bound property name corresponding to the selected item index. Property must be of an NSNumber type and cannot be a readonly property.
Declared In
SCTableViewCell.hcellWithText:boundObject:selectedIndexesPropertyName:items:allowMultipleSelection:
Allocates and returns an initialized SCSelectionCell given cell text, bound object, a bound property name, an array of selection items, and whether to allow multiple selection.
+ (instancetype)cellWithText:(NSString *)cellText boundObject:(NSObject *)object selectedIndexesPropertyName:(NSString *)propertyName items:(NSArray *)cellItems allowMultipleSelection:(BOOL)multipleSelectionParameters
- cellText
The text that will appear in the cell’s textLabel.
- object
The cell’s bound object (see SCTableViewCell class overview).
- propertyName
The cell’s bound property name corresponding to the selected items indexes set. Property must be of an NSMutableSet type and can be a readonly property.
- cellItems
An array of the items that the user will choose from. All items must be of an NSString type.
- multipleSelection
Determines if multiple selection is allowed.
Declared In
SCTableViewCell.hcellWithText:boundObject:selectionStringPropertyName:items:
Allocates and returns an initialized SCSelectionCell given cell text, bound object, an NSString bound property name, and an array of selection items.
+ (instancetype)cellWithText:(NSString *)cellText boundObject:(NSObject *)object selectionStringPropertyName:(NSString *)propertyName items:(NSArray *)cellItemsParameters
- cellText
The text that will appear in the cell’s textLabel.
- object
The cell’s bound object (see SCTableViewCell class overview).
- propertyName
The cell’s bound property name corresponding to the selected item string. Property must be of an NSString type and cannot be a readonly property.
Declared In
SCTableViewCell.hInstance Methods
initWithText:boundObject:selectedIndexPropertyName:items:
Returns an initialized SCSelectionCell given cell text, bound object, an NSNumber bound property name, and an array of selection items.
- (instancetype)initWithText:(NSString *)cellText boundObject:(NSObject *)object selectedIndexPropertyName:(NSString *)propertyName items:(NSArray *)cellItemsParameters
- cellText
The text that will appear in the cell’s textLabel.
- object
The cell’s bound object (see SCTableViewCell class overview).
- propertyName
The cell’s bound property name corresponding to the selected item index. Property must be of an NSNumber type and cannot be a readonly property.
Declared In
SCTableViewCell.hinitWithText:boundObject:selectedIndexesPropertyName:items:allowMultipleSelection:
Returns an initialized SCSelectionCell given cell text, bound object, a bound property name, an array of selection items, and whether to allow multiple selection.
- (instancetype)initWithText:(NSString *)cellText boundObject:(NSObject *)object selectedIndexesPropertyName:(NSString *)propertyName items:(NSArray *)cellItems allowMultipleSelection:(BOOL)multipleSelectionParameters
- cellText
The text that will appear in the cell’s textLabel.
- object
The cell’s bound object (see SCTableViewCell class overview).
- propertyName
The cell’s bound property name corresponding to the selected items indexes set. Property must be of an NSMutableSet type and can be a readonly property.
- cellItems
An array of the items that the user will choose from. All items must be of an NSString type.
- multipleSelection
Determines if multiple selection is allowed.
Declared In
SCTableViewCell.hinitWithText:boundObject:selectionStringPropertyName:items:
Returns an initialized SCSelectionCell given cell text, bound object, an NSString bound property name, and an array of selection items.
- (instancetype)initWithText:(NSString *)cellText boundObject:(NSObject *)object selectionStringPropertyName:(NSString *)propertyName items:(NSArray *)cellItemsParameters
- cellText
The text that will appear in the cell’s textLabel.
- object
The cell’s bound object (see SCTableViewCell class overview).
- propertyName
The cell’s bound property name corresponding to the selected item string. Property must be of an NSString type and cannot be a readonly property.
Declared In
SCTableViewCell.h