1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
| Cell的初始化方法，可以设置一个风格和标识符
- (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier;
风格的枚举如下：
typedef NS_ENUM(NSInteger, UITableViewCellStyle) {
UITableViewCellStyleDefault, // 默认风格，自带标题和一个图片视图，图片在左
UITableViewCellStyleValue1, // 只有标题和副标题 副标题在右边
UITableViewCellStyleValue2, // 只有标题和副标题，副标题在左边标题的下边
UITableViewCellStyleSubtitle // 自带图片视图和主副标题，主副标题都在左边，副标题在下
};
图片视图，风格允许时才会创建
@property (nonatomic, readonly, strong) UIImageView *imageView;
标题标签
@property (nonatomic, readonly, strong) UILabel *textLabel;
副标题标签
@property (nonatomic, readonly, strong) UILabel *detailTextLabel;
容纳视图，任何cell的子视图都应该添加在这个上面
@property (nonatomic, readonly, strong) UIView *contentView;
背景视图
@property (nonatomic, strong) UIView *backgroundView;
选中状态下的背景视图
@property (nonatomic, strong) UIView *selectedBackgroundView;
多选选中时的背景视图
@property (nonatomic, strong) UIView *multipleSelectionBackgroundView;
cell的标识符
@property (nonatomic, readonly, copy) NSString *reuseIdentifier;
当被重用的cell将要显示时，会调用这个方法，这个方法最大的用武之地是当你自定义的cell上面有图片时，如果产生了重用，图片可能会错乱（当图片来自异步下载时及其明显），这时我们可以重写这个方法把内容抹掉。
- (void)prepareForReuse;
cell被选中时的风格
@property (nonatomic) UITableViewCellSelectionStyle selectionStyle;
枚举如下：
typedef NS_ENUM(NSInteger, UITableViewCellSelectionStyle) {
UITableViewCellSelectionStyleNone,//无
UITableViewCellSelectionStyleBlue,//蓝色
UITableViewCellSelectionStyleGray,//灰色
UITableViewCellSelectionStyleDefault//默认 为蓝色
};
设置cell是否选中状态
@property (nonatomic, getter=isSelected) BOOL selected;
设置cell是否高亮状态
@property (nonatomic, getter=isHighlighted) BOOL highlighted;
与上面的两个属性对应
- (void)setSelected:(BOOL)selected animated:(BOOL)animated;
- (void)setHighlighted:(BOOL)highlighted animated:(BOOL)animated;
获取cell的编辑状态
@property (nonatomic, readonly) UITableViewCellEditingStyle editingStyle;
枚举如下
typedef NS_ENUM(NSInteger, UITableViewCellEditingStyle) {
UITableViewCellEditingStyleNone,//无编辑
UITableViewCellEditingStyleDelete,//删除编辑
UITableViewCellEditingStyleInsert//插入编辑
};
设置是否显示cell自带的自动排序控件
@property (nonatomic) BOOL showsReorderControl;
注意：要让cell实现拖动排序的功能，除了上面设置为YES，还需实现代理中的如下方法：
-(BOOL)tableView:(UITableView *)tableView canMoveRowAtIndexPath:(NSIndexPath *)indexPath{
return YES;
}
-(void)tableView:(UITableView *)tableView moveRowAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath{
}
设置编辑状态下是否显示缩进
@property (nonatomic) BOOL shouldIndentWhileEditing;
设置附件视图的风格(cell最右侧显示的视图)
@property (nonatomic) UITableViewCellAccessoryType accessoryType;
枚举如下：
typedef NS_ENUM(NSInteger, UITableViewCellAccessoryType) {
UITableViewCellAccessoryNone, // 没有视图
UITableViewCellAccessoryDisclosureIndicator, // cell右侧显示一个灰色箭头
UITableViewCellAccessoryDetailDisclosureButton, // 显示详情符号和灰色箭头
UITableViewCellAccessoryCheckmark, // cell右侧显示蓝色对号
UITableViewCellAccessoryDetailButton // cell右侧显示一个详情符号
};
附件视图
@property (nonatomic, strong) UIView *accessoryView;
@property (nonatomic) UITableViewCellAccessoryType editingAccessoryType;
cell编辑时的附件视图风格
@property (nonatomic, strong) UIView *editingAccessoryView;
cell编辑时的附件视图
@property (nonatomic) NSInteger indentationLevel;
设置内容区域的缩进级别
@property (nonatomic) CGFloat indentationWidth;
设置每个级别的缩进宽度
@property (nonatomic) UIEdgeInsets separatorInset;
设置分割线的偏移量
@property (nonatomic, getter=isEditing) BOOL editing;
- (void)setEditing:(BOOL)editing animated:(BOOL)animated;
设置是否编辑状态
@property(nonatomic, readonly) BOOL showingDeleteConfirmation;
返回是否目前正在显示删除按钮
- (void)willTransitionToState:(UITableViewCellStateMask)state;
cell状态将要转换时调用的函数，可以在子类中重写
- (void)didTransitionToState:(UITableViewCellStateMask)state;
cell状态已经转换时调用的函数，可以在子类中重写，状态枚举如下：
typedef NS_OPTIONS(NSUInteger, UITableViewCellStateMask) {
UITableViewCellStateDefaultMask = 0,//默认状态
UITableViewCellStateShowingEditControlMask = 1 << 0,//编辑状态
UITableViewCellStateShowingDeleteConfirmationMask = 1 << 1//确认删除状态
};
注意：下面这些方法已经全部在IOS3.0后被废弃了，虽然还有效果，但是会被警告
设置标题
@property (nonatomic, copy) NSString *text;
设置字体
@property (nonatomic, strong) UIFont *font;
设置对其模式
@property (nonatomic) NSTextAlignment textAlignment;
设置断行模式
@property (nonatomic) NSLineBreakMode lineBreakMode;
设置字体颜色
@property (nonatomic, strong) UIColor *textColor;
设置选中状态下的字体颜色
@property (nonatomic, strong) UIColor *selectedTextColor;
设置图片
@property (nonatomic, strong) UIImage *image;
设置选中状态时的图片
@property (nonatomic, strong) UIImage *selectedImage;
设置编辑的时候是否隐藏附件视图
@property (nonatomic) BOOL hidesAccessoryWhenEditing;
|