SCImagePickerCell Class Reference
| Inherits from | SCCustomCell : SCTableViewCell : UITableViewCell |
| Conforms to | SCViewControllerDelegate UIActionSheetDelegate UIImagePickerControllerDelegate UINavigationControllerDelegate UIScrollViewDelegate |
| Declared in | SCTableViewCell.h |
Overview
This class functions as a cell that provides the end-user with an automatically generated detail view of type UIImagePickerController to pick an image with. As soon as the image is picked, it will be saved to the Documents folder using either an auto generated name from the current time stamp, or a name provided through SCTableViewModelDelegate or the cell’s actions. The bound property of this cell must be of type NSString, and will be bound to the name of the selected image. Once an image is selected, tapping an SCImagePickerCell will display the image in a detail view. To select a different image, the table view must be put in edit mode (make sure UITableView’s allowsSelectionDuringEditing property is TRUE). Alternatively, make sure that displayClearImageButtonInDetailView property is TRUE, and the user will be able to tap a “Clear Image” button to clear the selected image.
Tasks
Creation and Initialization
Configuration
-
customImageViewproperty -
imagePickerControllerproperty -
selectedImageproperty -
placeholderImageNameproperty -
placeholderImageTitleproperty -
displayImageNameAsCellTextproperty -
askForSourceTypeproperty -
clearImageButtonproperty -
displayClearImageButtonInDetailViewproperty -
autoPositionClearImageButtonproperty -
textLabelFrameproperty -
imageViewFrameproperty -
pinchZoomScrollViewproperty -
selectedImageNameproperty -
– resetClearImageButtonStyles
Internal Methods (should only be used by the framework or when subclassing)
Properties
askForSourceType
If TRUE, the user will be asked for the source type, otherwise, the source type will be determined from imagePickerController’s sourceType property. Default: TRUE.
@property (nonatomic) BOOL askForSourceTypeDiscussion
Note: If the device has no camera, setting this to TRUE automatically sets the sourceType to UIImagePickerControllerSourceTypePhotoLibrary.
Declared In
SCTableViewCell.hautoPositionClearImageButton
If TRUE, clearImageButton will be automatically positioned in the cell’s detail view. Default: TRUE.
@property (nonatomic) BOOL autoPositionClearImageButtonDeclared In
SCTableViewCell.hclearImageButton
A button that clears the currently selected image when tapped. Feel free to customize the default look and feel of this button.
@property (nonatomic, readonly) UIButton *clearImageButtonDeclared In
SCTableViewCell.hcustomImageView
Set to a custom image view to use instead of the cell’s default imageView control.
@property (nonatomic, strong) IBOutlet UIImageView *customImageViewDeclared In
SCTableViewCell.hdisplayClearImageButtonInDetailView
If TRUE, clearImageButton will be displayed in the cell’s detail view. Default: TRUE.
@property (nonatomic) BOOL displayClearImageButtonInDetailViewDeclared In
SCTableViewCell.hdisplayImageNameAsCellText
If TRUE, the selected image name will be displayed in the cell’s textLabel. Default: TRUE.
@property (nonatomic) BOOL displayImageNameAsCellTextDeclared In
SCTableViewCell.himagePickerController
The UIImagePickerController associated with the cell. Even though this property is readonly, feel free to customize any of the controller’s relevant properties.
@property (nonatomic, readonly) UIImagePickerController *imagePickerControllerDeclared In
SCTableViewCell.himageViewFrame
Set this property to customize the placement of the cell’s imageView.
@property (nonatomic, readwrite) CGRect imageViewFrameDeclared In
SCTableViewCell.hpinchZoomScrollView
The scroll view used to support pinch zoom on the detail view displayed image. This property is typically used to set values for ‘maximumZoomScale’.
@property (nonatomic, strong, readonly) UIScrollView *pinchZoomScrollViewDeclared In
SCTableViewCell.hplaceholderImageName
The name for an image in the documents folder that will be used as a placeholder if no image is selected.
@property (nonatomic, copy) NSString *placeholderImageNameDeclared In
SCTableViewCell.hplaceholderImageTitle
The title for the image specified in the placeholderImageName property.
@property (nonatomic, copy) NSString *placeholderImageTitleDeclared In
SCTableViewCell.hselectedImage
The selected image. Returns nil if no image is selected.
@property (nonatomic, readonly) UIImage *selectedImageDeclared In
SCTableViewCell.hClass Methods
cellWithText:boundObject:imageNamePropertyName:
Allocates and returns an initialized SCImagePickerCell given cell text, bound object, and a bound property name.
+ (instancetype)cellWithText:(NSString *)cellText boundObject:(NSObject *)object imageNamePropertyName:(NSString *)propertyNameParameters
- 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 cell’s selected image name. Property must be a readwrite property of type NSString.
Declared In
SCTableViewCell.hInstance Methods
didTapClearImageButton
Gets called when the ‘Clear’ button is tapped.
- (void)didTapClearImageButtonDeclared In
SCTableViewCell.hinitWithText:boundObject:imageNamePropertyName:
Returns an initialized SCImagePickerCell given cell text, bound object, and a bound property name.
- (instancetype)initWithText:(NSString *)cellText boundObject:(NSObject *)object imageNamePropertyName:(NSString *)propertyNameParameters
- 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 cell’s selected image name. Property must be a readwrite property of type NSString.
Declared In
SCTableViewCell.hloadImageFromPath:
Method responsible for loading image from the given path.
- (UIImage *)loadImageFromPath:(NSString *)imagePathDeclared In
SCTableViewCell.hresetClearImageButtonStyles
Resets the clearImageButton default layer styles such as corneRadius and borderWidth.
- (void)resetClearImageButtonStylesDeclared In
SCTableViewCell.h