UITableViewCell

一、简介

<<继承关系:UITableViewCell --> UIView -->UIResponder-->NSObject

格式为

1--> 设置UITableViewCell选中的样式(属性的作用)

typedef NS_ENUM(NSInteger, UITableViewCellSelectionStyle) {

    UITableViewCellSelectionStyleNone,

    UITableViewCellSelectionStyleBlue,

    UITableViewCellSelectionStyleGray,

    UITableViewCellSelectionStyleDefault NS_ENUM_AVAILABLE_IOS(7_0)

};(如果属性有枚举类型的话,这里会有枚举类型说明)

tableViewCell.selectionStyle = UITableViewCellSelectionStyleDefault;(这是具体的例子)

@property (nonatomic) UITableViewCellSelectionStyle selectionStyle; // default is UITableViewCellSelectionStyleDefault.(这是属性的说明)

二、UITableViewCell的初始化方法(属性的顺序与苹果API一致)

1-->初始化UITableViewCell

cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1reuseIdentifier:cellIdentifier];//初始化方法,一般都是复用的时候调用

- (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(nullable NSString *)reuseIdentifier NS_AVAILABLE_IOS(3_0) NS_DESIGNATED_INITIALIZER;

2-->初始化UITableViewCell

- (instancetype)initWithCoder:(NSCoder*)coder{

self= [superinitWithCoder:coder];

if(self) {

NSLog(@"%s %@",__func__,NSStringFromCGRect(self.frame));

 }

returnself;

}

- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder NS_DESIGNATED_INITIALIZER;

三、UITableViewCell的属性

1-->设置UITableViewCell的图片

tableViewCell .imageView.image = image;

@property (nonatomic, readonly, strong, nullable) UIImageView *imageView NS_AVAILABLE_IOS(3_0); // 默认是空,如有需要,将创建图像视图,图片视图,风格允许时才会创建

2、设置UITableViewCell的标题

tableViewCell .textLabel.text = self.yearArr[indexPath.row];

@property (nonatomic, readonly, strong, nullable) UILabel *textLabel NS_AVAILABLE_IOS(3_0); //默认是空,如有需要,将创建标题视图。

3、设置UITableViewCell的副标题

tableViewCell .detailTextLabel.text = self.groups[indexPath.section].teams[indexPath.row].name;

@property (nonatomic, readonly, strong, nullable) UILabel *detailTextLabel NS_AVAILABLE_IOS(3_0);//默认是空,如有需要,将创建文本视图。

4、UITableViewCell的容纳视图

cell.contentView.backgroundColor = [UIColor yellowColor];

@property (nonatomic, readonly, strong) UIView *contentView;//容纳视图,任何cell的子视图都应该添加在这个上面

5、UITableViewCell的背景视图

cell.backgroundView.backgroundColor=[UIColor redColor];

@property (nonatomic, strong, nullable) UIView *backgroundView;//自定义未选择下cell的背景

6、UITableViewCell的选中状态下的背景视图

 cell.selectedBackgroundView.backgroundColor=[UIColor redColor];

@property (nonatomic, strong, nullable) UIView *selectedBackgroundView;//自定义未选择下cell的背景

备注:1、cell的backgroundView优先级>backgroundColor 

            2、backGroundView为cell的最底层,而selectedBackgroundView则相反,位于最顶层。 也就是说,如果你在cell上(一般会在其contentView)堆放了如何的不透明的view,则backGroundView都会被覆盖,而selectedBackgroundView在选中的情况下会覆盖你在cell中堆放的view。

           3、默认情况下,backgroundView和selectedBackgroundView在UITableViewStylePlain下的为空, UITableViewStyleGrouped下为非空。

7、UITableViewCell的多选选中时的背景视图

  cell.multipleSelectionBackgroundView.backgroundColor=[UIColor redColor];

@property (nonatomic, strong, nullable) UIView *multipleSelectionBackgroundView NS_AVAILABLE_IOS(5_0);

8、cell的标识符

static NSString *CellIdentifier = @"TimeLineViewCell";

TimeLineViewCell *cell = (TimeLineViewCell*)[tableView dequeueReusableCellWithIdentifier:CellIdentifier];

if(cell==nil){

    cell = [[TimeLineViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"CellIdentifier11"];

}//添加复用标示

@property (nonatomic, readonly, copy, nullable) NSString *reuseIdentifier;

9、当被重用的cell将要显示时触发

-(void)prepareForReuse

{

  [super prepareForResuse];//必须要加

    for(UIView *viewin _imgViews.subviews) {

        if(view.tag >0&& ([view isKindOfClass:[UIImageViewclass]]||[view isKindOfClass:[UILabelclass]])) {

            [view removeFromSuperview];

        }

    }

}

- (void)prepareForReuse  NS_REQUIRES_SUPER;

备注:

    1、当被重用的cell将要显示时,会调用这个方法,这个方法最大的用武之地是当你自定义的cell上面有图片时,如果产生了重用,图片可能会错乱(当图片来自异步下载时及其明显),这时我们可以重写这个方法把内容抹掉。

    2、在tableView调用dequeueReusableCellWithIdentifier:之前调用,如果要重载则必须调用[super prepareForReuse];

10、设置UITableViewCell选中时的样式

typedef NS_ENUM(NSInteger, UITableViewCellSelectionStyle) {

    UITableViewCellSelectionStyleNone,//无

    UITableViewCellSelectionStyleBlue,//蓝色

    UITableViewCellSelectionStyleGray,//灰色

    UITableViewCellSelectionStyleDefault//默认 为蓝色NS_ENUM_AVAILABLE_IOS(7_0)

};

tableViewCell.selectionStyle = UITableViewCellSelectionStyleDefault;

@property (nonatomic) UITableViewCellSelectionStyle selectionStyle; // 默认UITableViewCellSelectionStyleDefault.

11、设置UITableViewCell是否选中状态

tableViewCell.selected=YES;

@property (nonatomic, getter=isSelected) BOOL selected;//设置选定的状态(标题、图像、背景)。默认是NO,没有动画

12、设置cell是否高亮状态

 tableViewCell.highlighted=YES;

@property (nonatomic, getter=isHighlighted) BOOL      highlighted;  //设置突出显示的状态(标题、图像、背景)。默认是NO ,没有动画

13、与上面的两个属性对应,只不过加了动画

- (void)setSelected:(BOOL)selected animated:(BOOL)animated { [supersetSelected:selected animated:animated];

 _unreadBadge.backgroundColor = [UIColorredColor];

}

- (void)setSelected:(BOOL)selected animated:(BOOL)animated; 

- (void)setHighlighted:(BOOL)highlighted animated:(BOOL)animated { [supersetHighlighted:highlighted animated:animated];

 _unreadBadge.backgroundColor = [UIColorredColor];

}

- (void)setHighlighted:(BOOL)highlighted animated:(BOOL)animated; 

参见:点击UITableViewCell发生了什么?

14、获取cell的编辑状态

typedef NS_ENUM(NSInteger, UITableViewCellEditingStyle) {

    UITableViewCellEditingStyleNone,//无编辑

    UITableViewCellEditingStyleDelete,//删除编辑

    UITableViewCellEditingStyleInsert//插入编辑

};

    switch (cell.editingStyle) {

        case UITableViewCellEditingStyleNone:

            break;

        case UITableViewCellEditingStyleDelete:

            break;

        case UITableViewCellEditingStyleInsert:

            break;

        default:

            break;

    }

@property (nonatomic, readonly) UITableViewCellEditingStyle editingStyle; //只读属性

15、设置是否显示cell自带的自动排序控件

cell.showsReorderControl = YES;//启用编辑模式需要设置为yes  

@property (nonatomic) BOOL showsReorderControl; // 默认是 NO

注意:要让cell实现拖动排序的功能,除了上面设置为YES,还需实现代理中的如下方法:

-(BOOL)tableView:(UITableView *)tableView canMoveRowAtIndexPath:(NSIndexPath *)indexPath{

 return YES;

}

-(void)tableView:(UITableView *)tableView moveRowAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath{


}

16、设置编辑状态下是否显示缩进

cell.shouldIndentWhileEditing=YES;//开启缩进

@property (nonatomic) BOOL shouldIndentWhileEditing;//默认是yes。这与下面的缩进级别无关。

17、设置附件视图的风格(cell最右侧显示的视图) 

typedef NS_ENUM(NSInteger, UITableViewCellAccessoryType) {

 UITableViewCellAccessoryNone, 

 // 没有视图    

UITableViewCellAccessoryDisclosureIndicator,  

 // cell右侧显示一个灰色箭头   

 UITableViewCellAccessoryDetailDisclosureButton, 

// 显示详情符号和灰色箭头    

UITableViewCellAccessoryCheckmark,  

 // cell右侧显示蓝色对号    

UITableViewCellAccessoryDetailButton 

 // cell右侧显示一个详情符号

};

cell.accessoryType=UITableViewCellAccessoryNone;

@property (nonatomic) UITableViewCellAccessoryType accessoryType; //默认是UITableViewCellAccessoryNone。用于设置标准类型。

18、UITableViewCell的附件视图

 cell.accessoryView= button; 

@property (nonatomic, strong, nullable) UIView *accessoryView; //如果设置,则使用自定义视图。忽略accessoryType

参见:UITableViewCell设置accessoryType,子视图适配问题

19、设置UITableViewCell的cell编辑时的附件视图风格

typedef NS_ENUM(NSInteger, UITableViewCellAccessoryType) {

 UITableViewCellAccessoryNone, 

 // 没有视图    

UITableViewCellAccessoryDisclosureIndicator,  

 // cell右侧显示一个灰色箭头   

 UITableViewCellAccessoryDetailDisclosureButton, 

// 显示详情符号和灰色箭头    

UITableViewCellAccessoryCheckmark,  

 // cell右侧显示蓝色对号    

UITableViewCellAccessoryDetailButton 

 // cell右侧显示一个详情符号

};

cell.editingAccessoryType=UITableViewCellAccessoryNone;

@property (nonatomic) UITableViewCellAccessoryType editingAccessoryType; //默认是UITableViewCellAccessoryNone。用于设置标准类型。

20、设置cell编辑时的附件视图

 cell.editingAccessoryView= button; 

@property (nonatomic, strong, nullable) UIView *editingAccessoryView; //如果设置,则使用自定义视图。忽略accessoryType

21、设置内容区域的缩进级别

 cell.indentationLevel =3;

@property (nonatomic) NSInteger indentationLevel; // 调整内容缩进。默认是0

22、设置每个级别的缩进宽度

cell.indentationWidth =5;//缩进距离为3*5=15 默认的宽度为10

@property (nonatomic) CGFloat indentationWidth; // 每个级别的宽度。默认的是10.0

23、设置分割线的偏移量

tableView.separatorInset = UIEdgeInsetsMake(0, 0, 0, 0)

@property (nonatomic) UIEdgeInsets separatorInset;

24、设置是否编辑状态(无动画)

cell.editing=YES;

@property (nonatomic, getter=isEditing) BOOL editing; 

25、设置是否编辑状态(可以设置动画)

- (void)setEditing:(BOOL)editing animated:(BOOL)animated{

 [supersetEditing:editing animated:animated];

 [self.tableView setEditing:editing animated:animated];

self.editButtonItem.title = editing ?@"完成":@"编辑";

}

- (void)setEditing:(BOOL)editing animated:(BOOL)animated;

26、返回是否目前正在显示删除按钮

    if (self.showingDeleteConfirmation )

{

                   [self.layer removeAllAnimations];

                    break;

 }

@property(nonatomic, readonly) BOOL showingDeleteConfirmation;// 只显示“删除”按钮,只读属性

27、设置UITableViewCell的聚焦类型

typedef NS_ENUM(NSInteger, UITableViewCellFocusStyle) {

    UITableViewCellFocusStyleDefault,

    UITableViewCellFocusStyleCustom

} NS_ENUM_AVAILABLE_IOS(9_0);

cell.focusStyle=UITableViewCellFocusStyleDefault;

@property (nonatomic) UITableViewCellFocusStyle focusStyle NS_AVAILABLE_IOS(9_0) UI_APPEARANCE_SELECTOR;默认值是UITableViewCellFocusStyleDefault

28、cell状态将要转换时调用的函数,可以在子类中重写

typedef NS_OPTIONS(NSUInteger, UITableViewCellStateMask) {

    UITableViewCellStateDefaultMask                     = 0,//默认状态    UITableViewCellStateShowingEditControlMask          = 1 << 0,//编辑状态    UITableViewCellStateShowingDeleteConfirmationMask   = 1 << 1//确认删除状态

};

-(void)willTransitionToState:(UITableViewCellStateMask)state{

    [super willTransitionToState:state];

}

- (void)willTransitionToState:(UITableViewCellStateMask)state;/当cell的状态变为编辑时,uitableview内部会自动调用该方法,重写该方法可以改变cell的布局

29、cell状态已经转换时调用的函数,可以在子类中重写

typedef NS_OPTIONS(NSUInteger, UITableViewCellStateMask) {

    UITableViewCellStateDefaultMask                     = 0,//默认状态    UITableViewCellStateShowingEditControlMask          = 1 << 0,//编辑状态    UITableViewCellStateShowingDeleteConfirmationMask   = 1 << 1//确认删除状态

};

-(void)didTransitionToState:(UITableViewCellStateMask)state{

    [super didTransitionToState:state];

}

- (void)didTransitionToState:(UITableViewCellStateMask)state NS_AVAILABLE_IOS(3_0);//当cell的状态变为编辑时,uitableview内部会自动调用该方法,重写该方法可以改变cell的布局

30、通知UITableViewCell拖动状态发生了变化

- (void)dragStateDidChange:(UITableViewCellDragState)dragState{

    [super dragStateDidChange:dragState];

}

- (void)dragStateDidChange:(UITableViewCellDragState)dragState API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(tvos, watchos);

31、设置用户在被拖动时是否可以与单元交互

cell.userInteractionEnabledWhileDragging=YES;

@property (nonatomic) BOOL userInteractionEnabledWhileDragging API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(tvos, watchos);//默认是NO

参考

ios tableView那些事 (五) 给tableview设置缩进级别

iOS开发经验总结

iOS中UITableViewCell使用详解

你可能感兴趣的:(UITableViewCell)