SCTableViewModelDelegate Protocol Reference
| Declared in | SCTableViewModel.h |
Overview
This protocol should be adopted by objects that want to mediate as a delegate for SCTableViewModel. All methods for this protocol are optional.
Tasks
Managing TableView Model
-
– tableViewModelShouldBeginEditing:Return FALSE to prevent the model from entering into editing mode.
-
– tableViewModelWillBeginEditing:Notifies the delegate that the table view will enter editing mode.
-
– tableViewModelDidBeginEditing:Notifies the delegate that the table view did enter editing mode.
-
– tableViewModelShouldEndEditing:Return FALSE to prevent the model from exiting editing mode.
-
– tableViewModelWillEndEditing:Notifies the delegate that the table view will exit editing mode.
-
– tableViewModelDidEndEditing:Notifies the delegate that the table view did exit editing mode.
-
– tableViewModelDidScroll:Notifies the delegate that the table view did scroll.
-
– tableViewModelDidEndDragging:willDecelerate:Notifies the delegate that the table view did end dragging.
Managing Sections
-
– tableViewModel:didAddSectionAtIndex:Notifies the delegate that a section at the specified index has been added.
-
– tableViewModel:didRemoveSectionAtIndex:Notifies the delegate that a section at the specified index has been removed.
-
– tableViewModel:valueChangedForSectionAtIndex:Notifies the delegate that the value for the section at the specified index has changed.
-
– tableViewModel:itemCreatedForSectionAtIndex:item:Notifies the delegate that a new item bound cell has been created for the section at the specified index.
-
– tableViewModel:willAddItemForSectionAtIndex:item:Asks the delegate if a new item should be added to the section at the specified index.
-
– tableViewModel:itemAddedForSectionAtIndexPath:item:Notifies the delegate that a new item bound cell has been added to a section at the specified indexPath.
-
– tableViewModel:itemEditedForSectionAtIndexPath:item:Notifies the delegate that an item bound cell has been edited for a section at the specified indexPath.
Managing Cells
-
– tableViewModel:willConfigureCell:forRowAtIndexPath:Notifies the delegate that the cell at the specified indexPath is about to be configured in its owner UITableView.
-
– tableViewModel:didLayoutSubviewsForCell:forRowAtIndexPath:Notifies the delegate that the cell at the specified indexPath did perform layout to its subviews.
-
– tableViewModel:willDisplayCell:forRowAtIndexPath:Notifies the delegate that the cell at the specified indexPath will be displayed.
-
– tableViewModel:lazyLoadCell:forRowAtIndexPath:Implement this method if you want to lazy-load the cell’s contents. This method is usually used when the cell’s contents are expensive to retrieve inside willDisplayCell (gets retrieved via web services for example).
-
– tableViewModel:willSelectRowAtIndexPath:Notifies the delegate that the cell at the specified indexPath will be selected.
-
– tableViewModel:didSelectRowAtIndexPath:Notifies the delegate that the cell at the specified indexPath has been selected.
-
– tableViewModel:didDeselectRowAtIndexPath:Notifies the delegate that the cell at the specified indexPath has been deselected.
-
– tableViewModel:accessoryButtonTappedForRowWithIndexPath:Notifies the delegate that the accessory button for the cell at the specified indexPath has been selected. *
* @param tableModel The model informing the delegate of the event. * @param indexPath The index path of the cell with the accessory button. -
– tableViewModel:customButtonTapped:forRowWithIndexPath:Notifies the delegate that a custom button for the cell at the specified indexPath has been selected. This method gets called whenever any custom button placed on an SCControlCell is tapped. Note: button.tag must be greater than zero for this method to get called.
-
– tableViewModel:titleForDeleteConfirmationButtonForRowAtIndexPath:Requests the default title of the delete-confirmation button for the cell at the specified indexPath. *
* @param tableModel The model informing the delegate of the event. * @param indexPath The index path of the cell requesting the delete-confirmation button title. * @return A localized string to used as the title of the delete-confirmation button. -
– tableViewModel:valueChangedForRowAtIndexPath:Notifies the delegate that the value of the cell at the specified indexPath has changed.
-
– tableViewModel:targetIndexPathForMoveFromRowAtIndexPath:toProposedIndexPath:Asks the delegate to return a new index path to retarget a proposed move of a row.
-
– tableViewModel:rowAtIndexPath:textViewShouldBeginEditing:Asks the delegate if editing should begin for the text view of the cell at the specified indexPath.
-
– tableViewModel:rowAtIndexPath:textFieldShouldBeginEditing:Asks the delegate if editing should begin for the text field of the cell at the specified indexPath.
-
– tableViewModel:rowAtIndexPath:textField:shouldChangeCharactersInRange:replacementString:Asks the delegate if the specified text should be changed for the text field of the cell at the specified indexPath.
-
– tableViewModel:valueIsValidForRowAtIndexPath:Asks the delegate if the value is valid for the cell at the specified indexPath. Define this method if you want to override the cells' default value validation and provide your own custom validation.
-
– tableViewModel:returnButtonTappedForRowAtIndexPath:Notifies the delegate that the return keyboard button has been tapped for the cell at the specified indexPath. Define this method if you want to override the cells' default behaviour for tapping the return button.
-
– tableViewModel:didInsertRowAtIndexPath:Notifies the delegate that cell at the specified indexPath has been newly inserted.
-
– tableViewModel:willRemoveRowAtIndexPath:Notifies the delegate that cell at the specified indexPath will be removed.
-
– tableViewModel:didRemoveRowAtIndexPath:Notifies the delegate that cell at the specified indexPath has been removed.
-
– tableViewModel:detailModelCreatedForRowAtIndexPath:detailTableViewModel:Notifies the delegate that the detail model for the cell at the specified index path has been created. This is the perfect time to do any customizations to the cell’s detail table view model before any automatically generated sections are added, including setting its dataSource and delegate properties.
-
– tableViewModel:detailModelConfiguredForRowAtIndexPath:detailTableViewModel:Notifies the delegate that the detail model for the cell at the specified index path has been configured with the appropriate sections and cells. This is the perfect time to do any customizations to the cell’s detail table view model after the automatically generated sections have been added.
-
– tableViewModel:detailViewWillPresentForRowAtIndexPath:withDetailTableViewModel:Notifies the delegate that the detail view for the cell at the specified indexPath will be presented. This is the perfect time to do any customizations to the cell’s detail view model after the automatically generated sections have been added.
-
– tableViewModel:detailViewDidPresentForRowAtIndexPath:withDetailTableViewModel:Notifies the delegate that the detail view for the cell at the specified indexPath has been presented.
-
– tableViewModel:shouldDismissDetailViewForRowAtIndexPath:withDetailTableViewModel:cancelButtonTapped:doneButtonTapped:Asks the delegate if the detail view for the cell at the specified indexPath should be dismissed.
-
– tableViewModel:detailViewWillDismissForRowAtIndexPath:Notifies the delegate that the detail view for the cell at the specified indexPath will be dismissed.
-
– tableViewModel:detailViewDidDismissForRowAtIndexPath:Notifies the delegate that the detail view for the cell at the specified indexPath has been dismissed.
-
– tableViewModel:imageNameForRowAtIndexPath:Asks the delegate for a new image name for the SCImagePickerCell at the specified indexPath. Define this method to provide a new name for the selected image, instead of using the auto generated one.
-
– tableViewModel:saveImage:toPath:forRowAtIndexPath:Asks the delegate to handle saving the image for the SCImagePickerCell at the specified indexPath. Define this method to provide your own algorithm for saving the image instead of using the default one.
-
– tableViewModel:loadImageFromPath:forRowAtIndexPath:Asks the delegate to handle loading the image for the SCImagePickerCell at the specified indexPath.Define this method to provide your own algorithm for loading the image instead of using the default one.
SCArrayOfItemsModel methods
-
– tableViewModelSearchBarShouldBeginEditing:Asks the delegate if editing should begin in the search bar.
-
– tableViewModel:searchBarSelectedScopeButtonIndexDidChange:Notifies the delegate that the search bar scope button selection changed.
-
– tableViewModelSearchBarBookmarkButtonClicked:Notifies the delegate that the search bar bookmark button was tapped.
-
– tableViewModelSearchBarCancelButtonClicked:Notifies the delegate that the search bar cancel button was tapped.
-
– tableViewModelSearchBarResultsListButtonClicked:Notifies the delegate that the search bar results list button was tapped.
-
– tableViewModelSearchBarSearchButtonClicked:Notifies the delegate that the search bar search button was tapped.
Instance Methods
tableViewModel:accessoryButtonTappedForRowWithIndexPath:
Notifies the delegate that the accessory button for the cell at the
specified indexPath has been selected.
*
* @param tableModel The model informing the delegate of the event.
* @param indexPath The index path of the cell with the accessory button.
- (void)tableViewModel:(SCTableViewModel *)tableModel accessoryButtonTappedForRowWithIndexPath:(NSIndexPath *)indexPathDeclared In
SCTableViewModel.htableViewModel:customButtonTapped:forRowWithIndexPath:
Notifies the delegate that a custom button for the cell at the specified indexPath has been selected. This method gets called whenever any custom button placed on an SCControlCell is tapped. Note: button.tag must be greater than zero for this method to get called.
- (void)tableViewModel:(SCTableViewModel *)tableModel customButtonTapped:(UIButton *)button forRowWithIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- button
The custom button tapped.
- indexPath
The index path of the cell with the accessory button.
Declared In
SCTableViewModel.htableViewModel:detailModelConfiguredForRowAtIndexPath:detailTableViewModel:
Notifies the delegate that the detail model for the cell at the specified index path has been configured with the appropriate sections and cells. This is the perfect time to do any customizations to the cell’s detail table view model after the automatically generated sections have been added.
- (void)tableViewModel:(SCTableViewModel *)tableModel detailModelConfiguredForRowAtIndexPath:(NSIndexPath *)indexPath detailTableViewModel:(SCTableViewModel *)detailTableViewModelParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell whose detail model has been configured.
- detailTableViewModel
The model for the cell’s detail view.
Declared In
SCTableViewModel.htableViewModel:detailModelCreatedForRowAtIndexPath:detailTableViewModel:
Notifies the delegate that the detail model for the cell at the specified index path has been created. This is the perfect time to do any customizations to the cell’s detail table view model before any automatically generated sections are added, including setting its dataSource and delegate properties.
- (void)tableViewModel:(SCTableViewModel *)tableModel detailModelCreatedForRowAtIndexPath:(NSIndexPath *)indexPath detailTableViewModel:(SCTableViewModel *)detailTableViewModelParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell whose detail model has been created.
- detailTableViewModel
The model for the cell’s detail view.
Declared In
SCTableViewModel.htableViewModel:detailViewDidDismissForRowAtIndexPath:
Notifies the delegate that the detail view for the cell at the specified indexPath has been dismissed.
- (void)tableViewModel:(SCTableViewModel *)tableModel detailViewDidDismissForRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index of the cell whose detail view has disappeared.
Declared In
SCTableViewModel.htableViewModel:detailViewDidPresentForRowAtIndexPath:withDetailTableViewModel:
Notifies the delegate that the detail view for the cell at the specified indexPath has been presented.
- (void)tableViewModel:(SCTableViewModel *)tableModel detailViewDidPresentForRowAtIndexPath:(NSIndexPath *)indexPath withDetailTableViewModel:(SCTableViewModel *)detailTableViewModelParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell whose detail view did appear.
- detailTableViewModel
The model for the cell’s detail view.
Declared In
SCTableViewModel.htableViewModel:detailViewWillDismissForRowAtIndexPath:
Notifies the delegate that the detail view for the cell at the specified indexPath will be dismissed.
- (void)tableViewModel:(SCTableViewModel *)tableModel detailViewWillDismissForRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index of the cell whose detail view will disappear.
Declared In
SCTableViewModel.htableViewModel:detailViewWillPresentForRowAtIndexPath:withDetailTableViewModel:
Notifies the delegate that the detail view for the cell at the specified indexPath will be presented. This is the perfect time to do any customizations to the cell’s detail view model after the automatically generated sections have been added.
- (void)tableViewModel:(SCTableViewModel *)tableModel detailViewWillPresentForRowAtIndexPath:(NSIndexPath *)indexPath withDetailTableViewModel:(SCTableViewModel *)detailTableViewModelParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell whose detail view will appear.
- detailTableViewModel
The model for the cell’s detail view.
Declared In
SCTableViewModel.htableViewModel:didAddSectionAtIndex:
Notifies the delegate that a section at the specified index has been added.
- (void)tableViewModel:(SCTableViewModel *)tableModel didAddSectionAtIndex:(NSUInteger)indexParameters
- tableModel
The model informing the delegate of the event.
- index
The added section’s index.
- section
The added section.
Declared In
SCTableViewModel.htableViewModel:didDeselectRowAtIndexPath:
Notifies the delegate that the cell at the specified indexPath has been deselected.
- (void)tableViewModel:(SCTableViewModel *)tableModel didDeselectRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell that has been deselected.
Declared In
SCTableViewModel.htableViewModel:didInsertRowAtIndexPath:
Notifies the delegate that cell at the specified indexPath has been newly inserted.
- (void)tableViewModel:(SCTableViewModel *)tableModel didInsertRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell who has been newly inserted.
Declared In
SCTableViewModel.htableViewModel:didLayoutSubviewsForCell:forRowAtIndexPath:
Notifies the delegate that the cell at the specified indexPath did perform layout to its subviews.
- (void)tableViewModel:(SCTableViewModel *)tableModel didLayoutSubviewsForCell:(SCTableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- cell
The cell that performed layout to its subviews.
- indexPath
The index path of the cell.
Discussion
This is the perfect place to do any customization to the cell’s subviews' layouts/frames.
Declared In
SCTableViewModel.htableViewModel:didRemoveRowAtIndexPath:
Notifies the delegate that cell at the specified indexPath has been removed.
- (void)tableViewModel:(SCTableViewModel *)tableModel didRemoveRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell that has been removed.
Declared In
SCTableViewModel.htableViewModel:didRemoveSectionAtIndex:
Notifies the delegate that a section at the specified index has been removed.
- (void)tableViewModel:(SCTableViewModel *)tableModel didRemoveSectionAtIndex:(NSUInteger)indexParameters
- tableModel
The model informing the delegate of the event.
- index
The index of the removed section.
Declared In
SCTableViewModel.htableViewModel:didSelectRowAtIndexPath:
Notifies the delegate that the cell at the specified indexPath has been selected.
- (void)tableViewModel:(SCTableViewModel *)tableModel didSelectRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell that has been selected.
Declared In
SCTableViewModel.htableViewModel:imageNameForRowAtIndexPath:
Asks the delegate for a new image name for the SCImagePickerCell at the specified indexPath. Define this method to provide a new name for the selected image, instead of using the auto generated one.
- (NSString *)tableViewModel:(SCTableViewModel *)tableModel imageNameForRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model asking the delegate for validation.
- indexPath
The index path of the SCImagePickerCell who needs a new image name.
Return Value
The image name. Return value must be autoreleased.
Declared In
SCTableViewModel.htableViewModel:itemAddedForSectionAtIndexPath:item:
Notifies the delegate that a new item bound cell has been added to a section at the specified indexPath.
- (void)tableViewModel:(SCTableViewModel *)tableModel itemAddedForSectionAtIndexPath:(NSIndexPath *)indexPath item:(NSObject *)itemParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path the new item bound cell has been added to.
- item
The item that has been added.
Discussion
Note: Method usually called for SCArrayOfItemsSection’s subclasses.
Declared In
SCTableViewModel.htableViewModel:itemCreatedForSectionAtIndex:item:
Notifies the delegate that a new item bound cell has been created for the section at the specified index.
- (void)tableViewModel:(SCTableViewModel *)tableModel itemCreatedForSectionAtIndex:(NSUInteger)index item:(NSObject *)itemParameters
- tableModel
The model informing the delegate of the event.
- index
The index of the section whose a new item has been created for.
- item
The item that has been created.
Discussion
Note: Method usually called for SCArrayOfItemsSection’s subclasses.
Warning: Although item has been created, it’s still not added to the section and can be deallocated if the user cancels the item’s detail view.
Declared In
SCTableViewModel.htableViewModel:itemEditedForSectionAtIndexPath:item:
Notifies the delegate that an item bound cell has been edited for a section at the specified indexPath.
- (void)tableViewModel:(SCTableViewModel *)tableModel itemEditedForSectionAtIndexPath:(NSIndexPath *)indexPath item:(NSObject *)itemParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path the new item bound cell has been added to.
- item
The item that has been edited.
Discussion
Note: Method usually called for SCArrayOfItemsSection’s subclasses.
Declared In
SCTableViewModel.htableViewModel:lazyLoadCell:forRowAtIndexPath:
Implement this method if you want to lazy-load the cell’s contents. This method is usually used when the cell’s contents are expensive to retrieve inside willDisplayCell (gets retrieved via web services for example).
- (void)tableViewModel:(SCTableViewModel *)tableModel lazyLoadCell:(SCTableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- cell
The cell that will be displayed.
- indexPath
The index path of the cell that will be lazy-loaded.
Declared In
SCTableViewModel.htableViewModel:loadImageFromPath:forRowAtIndexPath:
Asks the delegate to handle loading the image for the SCImagePickerCell at the specified indexPath.Define this method to provide your own algorithm for loading the image instead of using the default one.
- (UIImage *)tableViewModel:(SCTableViewModel *)tableModel loadImageFromPath:(NSString *)path forRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model asking the delegate for validation.
- path
The path that the image should be loaded from.
- indexPath
The index path of the SCImagePickerCell that requests the image to be loaded.
Return Value
The loaded image. This image should be autoreleased.
Declared In
SCTableViewModel.htableViewModel:returnButtonTappedForRowAtIndexPath:
Notifies the delegate that the return keyboard button has been tapped for the cell at the specified indexPath. Define this method if you want to override the cells' default behaviour for tapping the return button.
- (void)tableViewModel:(SCTableViewModel *)tableModel returnButtonTappedForRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model asking the delegate for validation.
- indexPath
The index path of the cell whose keyboard return key has been tapped.
Declared In
SCTableViewModel.htableViewModel:rowAtIndexPath:textField:shouldChangeCharactersInRange:replacementString:
Asks the delegate if the specified text should be changed for the text field of the cell at the specified indexPath.
- (BOOL)tableViewModel:(SCTableViewModel *)tableModel rowAtIndexPath:(NSIndexPath *)indexPath textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)stringParameters
- tableModel
The model asking the delegate for validation.
- indexPath
The index path of the cell containing the text field.
- textField
The text field containing the text.
- range
The range of characters to be replaced.
- string
The replacement string.
Declared In
SCTableViewModel.htableViewModel:rowAtIndexPath:textFieldShouldBeginEditing:
Asks the delegate if editing should begin for the text field of the cell at the specified indexPath.
- (BOOL)tableViewModel:(SCTableViewModel *)tableModel rowAtIndexPath:(NSIndexPath *)indexPath textFieldShouldBeginEditing:(UITextField *)textFieldParameters
- tableModel
The model asking the delegate.
- indexPath
The index path of the cell containing the text field.
- textField
The text field.
Declared In
SCTableViewModel.htableViewModel:rowAtIndexPath:textViewShouldBeginEditing:
Asks the delegate if editing should begin for the text view of the cell at the specified indexPath.
- (BOOL)tableViewModel:(SCTableViewModel *)tableModel rowAtIndexPath:(NSIndexPath *)indexPath textViewShouldBeginEditing:(UITextView *)textViewParameters
- tableModel
The model asking the delegate.
- indexPath
The index path of the cell containing the text field.
- textView
The text view.
Declared In
SCTableViewModel.htableViewModel:saveImage:toPath:forRowAtIndexPath:
Asks the delegate to handle saving the image for the SCImagePickerCell at the specified indexPath. Define this method to provide your own algorithm for saving the image instead of using the default one.
- (void)tableViewModel:(SCTableViewModel *)tableModel saveImage:(UIImage *)image toPath:(NSString *)path forRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model asking the delegate for validation.
- image
The image to be saved.
- path
The path that the image should be saved to.
- indexPath
The index path of the SCImagePickerCell that requests the image to be saved.
Discussion
Warning: If you choose to save the image to a location other than that of the given path, then tableViewModel:loadImageFromImagePath:forRowAtIndexPath: method must also be implemented.
Declared In
SCTableViewModel.htableViewModel:searchBarSelectedScopeButtonIndexDidChange:
Notifies the delegate that the search bar scope button selection changed.
- (void)tableViewModel:(SCArrayOfItemsModel *)tableModel searchBarSelectedScopeButtonIndexDidChange:(NSInteger)selectedScopeParameters
- tableModel
The model informing the delegate of the event.
- selectedScope
The index of the selected scope button.
Declared In
SCTableViewModel.htableViewModel:shouldDismissDetailViewForRowAtIndexPath:withDetailTableViewModel:cancelButtonTapped:doneButtonTapped:
Asks the delegate if the detail view for the cell at the specified indexPath should be dismissed.
- (BOOL)tableViewModel:(SCTableViewModel *)tableModel shouldDismissDetailViewForRowAtIndexPath:(NSIndexPath *)indexPath withDetailTableViewModel:(SCTableViewModel *)detailTableViewModel cancelButtonTapped:(BOOL)cancelTapped doneButtonTapped:(BOOL)doneTappedParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell.
- detailTableViewModel
The model for the cell’s detail view.
- cancelTapped
TRUE if Cancel button has been tapped to dismiss the detail view.
- doneTapped
TRUE if Done button has been tapped to dismiss the detail view.
Return Value
Retrun TRUE to have the detail view dismissed, otherwise return FALSE.
Declared In
SCTableViewModel.htableViewModel:targetIndexPathForMoveFromRowAtIndexPath:toProposedIndexPath:
Asks the delegate to return a new index path to retarget a proposed move of a row.
- (NSIndexPath *)tableViewModel:(SCTableViewModel *)tableModel targetIndexPathForMoveFromRowAtIndexPath:(NSIndexPath *)sourceIndexPath toProposedIndexPath:(NSIndexPath *)proposedDestinationIndexPathParameters
- tableModel
The model requesting this information.
- sourceIndexPath
The index path identifying the original location of a row (in its section) that is being dragged.
- proposedDestinationIndexPath
The index path identifying the currently proposed destination of the row being dragged.
Return Value
The index path locating the desired row destination for the move operation. Return proposedDestinationIndexPath if that location is suitable.
Discussion
Warning: It is very rare when you’ll need to define this method. If you are using an SCArrayOfItemsSection or any of its subclasses, this will be automatically handeled for you.
Declared In
SCTableViewModel.htableViewModel:titleForDeleteConfirmationButtonForRowAtIndexPath:
Requests the default title of the delete-confirmation button for the cell
at the specified indexPath.
*
* @param tableModel The model informing the delegate of the event.
* @param indexPath The index path of the cell requesting the delete-confirmation button title.
* @return A localized string to used as the title of the delete-confirmation button.
- (NSString *)tableViewModel:(SCTableViewModel *)tableModel titleForDeleteConfirmationButtonForRowAtIndexPath:(NSIndexPath *)indexPathDeclared In
SCTableViewModel.htableViewModel:valueChangedForRowAtIndexPath:
Notifies the delegate that the value of the cell at the specified indexPath has changed.
- (void)tableViewModel:(SCTableViewModel *)tableModel valueChangedForRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell whose value has changed.
Declared In
SCTableViewModel.htableViewModel:valueChangedForSectionAtIndex:
Notifies the delegate that the value for the section at the specified index has changed.
- (void)tableViewModel:(SCTableViewModel *)tableModel valueChangedForSectionAtIndex:(NSUInteger)indexParameters
- tableModel
The model informing the delegate of the event.
- index
The index of the section whose value has changed.
Declared In
SCTableViewModel.htableViewModel:valueIsValidForRowAtIndexPath:
Asks the delegate if the value is valid for the cell at the specified indexPath. Define this method if you want to override the cells' default value validation and provide your own custom validation.
- (BOOL)tableViewModel:(SCTableViewModel *)tableModel valueIsValidForRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model asking the delegate for validation.
- indexPath
The index path of the cell whose value needs validation.
Declared In
SCTableViewModel.htableViewModel:willAddItemForSectionAtIndex:item:
Asks the delegate if a new item should be added to the section at the specified index.
- (BOOL)tableViewModel:(SCTableViewModel *)tableModel willAddItemForSectionAtIndex:(NSUInteger)index item:(NSObject *)itemParameters
- tableModel
The model informing the delegate of the event.
- index
The index of the section the new item will be added to.
- item
The item that will be added.
Discussion
Note: Method usually called for SCArrayOfItemsSection’s subclasses.
Declared In
SCTableViewModel.htableViewModel:willConfigureCell:forRowAtIndexPath:
Notifies the delegate that the cell at the specified indexPath is about to be configured in its owner UITableView.
- (void)tableViewModel:(SCTableViewModel *)tableModel willConfigureCell:(SCTableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- cell
The cell that is about to layout controls.
- indexPath
The index path of the cell.
Discussion
This is the perfect time to do any customization to the cell’s height, editable, and movable properties.
Declared In
SCTableViewModel.htableViewModel:willDisplayCell:forRowAtIndexPath:
Notifies the delegate that the cell at the specified indexPath will be displayed.
- (void)tableViewModel:(SCTableViewModel *)tableModel willDisplayCell:(SCTableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- cell
The cell that will be displayed.
- indexPath
The index path of the cell that will be displayed.
Discussion
This is the perfect place to do any customization to the cell’s appearance.
Note: To change cell properties like the height, editable, or movable states, use the willConfigureCell delegate method instead.
Declared In
SCTableViewModel.htableViewModel:willRemoveRowAtIndexPath:
Notifies the delegate that cell at the specified indexPath will be removed.
- (BOOL)tableViewModel:(SCTableViewModel *)tableModel willRemoveRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell that will be removed.
Return Value
Return TRUE to proceed with the remove operation, otherwise return FALSE.
Declared In
SCTableViewModel.htableViewModel:willSelectRowAtIndexPath:
Notifies the delegate that the cell at the specified indexPath will be selected.
- (void)tableViewModel:(SCTableViewModel *)tableModel willSelectRowAtIndexPath:(NSIndexPath *)indexPathParameters
- tableModel
The model informing the delegate of the event.
- indexPath
The index path of the cell that will be selected.
Declared In
SCTableViewModel.htableViewModelDidBeginEditing:
Notifies the delegate that the table view did enter editing mode.
- (void)tableViewModelDidBeginEditing:(SCTableViewModel *)tableModelDiscussion
Note: For this method to get fired, the SCTableViewModel editButtonItem property must be set.
Declared In
SCTableViewModel.htableViewModelDidEndDragging:willDecelerate:
Notifies the delegate that the table view did end dragging.
- (void)tableViewModelDidEndDragging:(SCTableViewModel *)tableModel willDecelerate:(BOOL)decelerateDeclared In
SCTableViewModel.htableViewModelDidEndEditing:
Notifies the delegate that the table view did exit editing mode.
- (void)tableViewModelDidEndEditing:(SCTableViewModel *)tableModelDiscussion
Note: For this method to get fired, the SCTableViewModel editButtonItem property must be set.
Declared In
SCTableViewModel.htableViewModelDidScroll:
Notifies the delegate that the table view did scroll.
- (void)tableViewModelDidScroll:(SCTableViewModel *)tableModelDeclared In
SCTableViewModel.htableViewModelSearchBarBookmarkButtonClicked:
Notifies the delegate that the search bar bookmark button was tapped.
- (void)tableViewModelSearchBarBookmarkButtonClicked:(SCArrayOfItemsModel *)tableModelParameters
- tableModel
The model informing the delegate of the event.
Declared In
SCTableViewModel.htableViewModelSearchBarCancelButtonClicked:
Notifies the delegate that the search bar cancel button was tapped.
- (void)tableViewModelSearchBarCancelButtonClicked:(SCArrayOfItemsModel *)tableModelParameters
- tableModel
The model informing the delegate of the event.
Declared In
SCTableViewModel.htableViewModelSearchBarResultsListButtonClicked:
Notifies the delegate that the search bar results list button was tapped.
- (void)tableViewModelSearchBarResultsListButtonClicked:(SCArrayOfItemsModel *)tableModelParameters
- tableModel
The model informing the delegate of the event.
Declared In
SCTableViewModel.htableViewModelSearchBarSearchButtonClicked:
Notifies the delegate that the search bar search button was tapped.
- (void)tableViewModelSearchBarSearchButtonClicked:(SCArrayOfItemsModel *)tableModelParameters
- tableModel
The model informing the delegate of the event.
Declared In
SCTableViewModel.htableViewModelSearchBarShouldBeginEditing:
Asks the delegate if editing should begin in the search bar.
- (BOOL)tableViewModelSearchBarShouldBeginEditing:(SCArrayOfItemsModel *)tableModelParameters
- tableModel
The model informing the delegate of the event.
Return Value
Return YES if an editing session should be initiated, otherwise, NO.
Declared In
SCTableViewModel.htableViewModelShouldBeginEditing:
Return FALSE to prevent the model from entering into editing mode.
- (BOOL)tableViewModelShouldBeginEditing:(SCTableViewModel *)tableModelDiscussion
Note: For this method to get fired, the SCTableViewModel editButtonItem property must be set.
Declared In
SCTableViewModel.htableViewModelShouldEndEditing:
Return FALSE to prevent the model from exiting editing mode.
- (BOOL)tableViewModelShouldEndEditing:(SCTableViewModel *)tableModelDiscussion
Note: For this method to get fired, the SCTableViewModel editButtonItem property must be set.
Declared In
SCTableViewModel.htableViewModelWillBeginEditing:
Notifies the delegate that the table view will enter editing mode.
- (void)tableViewModelWillBeginEditing:(SCTableViewModel *)tableModelDiscussion
Note: For this method to get fired, the SCTableViewModel editButtonItem property must be set.
Declared In
SCTableViewModel.htableViewModelWillEndEditing:
Notifies the delegate that the table view will exit editing mode.
- (void)tableViewModelWillEndEditing:(SCTableViewModel *)tableModelDiscussion
Note: For this method to get fired, the SCTableViewModel editButtonItem property must be set.
Declared In
SCTableViewModel.h