iOS UIKit：TableView之单元格配置（2）

      Table View是UITableView类的实例对象，其是使用节（section）来描述信息的一种滚动列表。但与普通的表格不同，tableView只有一行，且只能在垂直方向进行滚动。tableView由多个section组成，而section又由行（row）组成，也可将行称为单元格（cell）。Cell是UITableViewCell类的实例对象。

1 UITableViewCell

      Table View使用UITableViewCell对象来绘制可视化的row，从而用户看到的table view其实是一个个cell对象。

1.1 Cell结构

Table view是由一行行的单元格组成，即UITableViewCell对象组成。而UITableViewCell也是一个复合结构，内部由许多部分组成的，如表 41所示是其内部主要的成员属性。

表 41 UITableViewCell主要属性

属性名	类型	描述
imageView	UIImageView	UITableViewCell有4种类型的样式，若是Basic和Subtitle类型，则会显示该属性的图像。
textLabel	UILabel	此内容为cell的标题，若要修改显示的内容，可以修改textLabel属性的text属性值。
contentView	UIView	Cell的内容视图，可以在上面添加多个子view，如可以使用UIView的addSubview方法添加子view对象。
backgroundView	UIView	整个Cell的背景视图，可以通过UITableViewCell的setBackgroundView方法修改。
accessoryType	UITableViewCellAccessoryType	Cell定义了3种附加的视图，可以指定显示的类型，默认不显示任何类型。
accessoryView	UIView	Cell定义了3种附加的视图，用户还可以自定义显示的view，即通过UITableViewCell的setAccessoryView方法修改附加视图，若自定义的内容，则忽略accessoryType属性的内容。
reuseIdentifier	NSString	可重复使用UITableViewCell对象的标识符
detailTextLabel	UILabel	如果存在附加的详细内容，则显示subtitle内容
editingAccessoryType	UITableViewCellAccessoryType	tableView进入编辑模式时，cell右边附加视图的显示样式。
editingAccessoryView	UIView	Cell定义了3种进入编辑模式时的附加视图，用户还可以自定义显示的view，即通过UITableViewCell的setEditingAccessoryView方法修改附加视图，若自定义的内容，则忽略editingAccessoryType属性的内容。

 

1.1.1 默认模型

      如表 41所示，UITableViewCell对象由多个部分组成，随着不同的类型，其显示的内容也不一样，图 41是一般的显示结构。

图 41 Parts of a table view cell

 

1.1.2 编辑模型

      当table view进入编辑模型时，UITableViewCell对象显示的内容也不一样，如图 42所示是进入编辑模型的显示内容。

图 42 Parts of a table-view cell in editing mode

1.1.3 重复使用

      若在storyboard中给table view cell定义了标识符，UITableView对象将其存储在内置的队列中，使其可以重复使用该单元格。当table view向data source对象请求cell对象时，可以通过该UITableView对象的dequeueReusableCellWithIdentifier:方法获取cell对象，即在data source方法返回之前设置cell的内容和样式。从而提高table view的性能。

      如下例子：首先获取storyboard中定义的table view cell，若不存在则创建一个Subtitle样式的UITableViewCell对象，接着修改单元格的内容。

 1 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
 2     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"MyIdentifier"];
 3     if (cell == nil) {
 4         cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:@"MyIdentifier"];
 5         cell.selectionStyle = UITableViewCellSelectionStyleNone;
 6     }
 7     NSDictionary *item = (NSDictionary *)[self.content objectAtIndex:indexPath.row];
 8     cell.textLabel.text = [item objectForKey:@"mainTitleKey"];
 9     cell.detailTextLabel.text = [item objectForKey:@"secondaryTitleKey"];
10     NSString *path = [[NSBundle mainBundle] pathForResource:[item objectForKey:@"imageKey"] ofType:@"png"];
11     UIImage *theImage = [UIImage imageWithContentsOfFile:path];
12     cell.imageView.image = theImage;
13     return cell;
14 }

      若未在storyboard中给table view cell定义标识符，并希望提高table view的性能，则也可以先通过UITableView对象的registerClass:forCellReuseIdentifier:方法注册一个cell对象。

1.2 自定义单元格

      UITableViewCell预定义了4种标准类型的单元格，若仍不能满足要求，用户可以自定义cell的内容，具体说就是修改UITableViewCell对象的属性，特别是contentView和accessoryView两个属性。目前有Program和storyboard两种方式。

1.2.1 storyboard方式

1.2.1.1 Dynamic

      这种方式是在storyboard中创建一个dynamic类型的table view，并修改cell的contentView的内容，从而在data source中返回storyboard中创建的UITableViewCell对象。可按如下步骤实现：

      a) 在画布中，创建一个UITableView对象，并创建UITableViewCell对象，同时设置其Identifier值；

       b) 选中UITableView对象，并在Attributes inspector的Content上下文中选择"Dynamic Prototypes"选项；

       c) 选中UITableViewCell对象，并在Attributes inspector的Style上下文中选择"Custom"选项；

       d) 选中UITableViewCell对象，并从库中拖入自定义的控件到其Content View中，可以加入一些布局约束。

       e) 在data source方法中，获取UITableViewCell定义的对象，从而返回UITableViewCell对象。

1.2.1.2 Static

      这方式与dynamic方式类似，其在storyboard中创建一个static类型的table view。由于static方式只能应用于库中的table view controller控件，并且无需实现data source，所以需要在Attributes inspector中指定有多少个section；然后即可在UITableViewCell的Content View中拖入喜欢的控件了。

 

1.2.2 Program方式

      也可以通过程序的方式自定义cell，即可向UITableViewCell对象contentView属性中添加子view对象，从而实现自定义的效果，即调用contentView属性的addSubview方法添加子view对象。

      如下所示往每个单元格中添加一张图片：

 1 -(UITableViewCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
 2 {
 3     static NSString *CellIdentifier = @"myCell";
 4     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];
 5     if(nil == cell)
 6     {
 7         cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier];
 8     }
 9     UIImage * image = [UIImage imageNamed:@"cellBackground"];
10     UIImageView *backView = [[UIImageView alloc] initWithImage:image];
11 
12     [cell.contentView addSubview:backView];
13     return cell;
14 }

注意：

       若往contentView属性中添加子view时，不应该把子view对象设置为透明状态。因为若子view为透明时，在table view滚动时将需花费比较大的资源消耗。

1.2.3 扩展附加视图

      cell的附加视图也可以自定义，只需修改UITableViewCell对象的accessoryView属性即可。虽然accessoryView属性也是UIView类型，但与修改contentView属性不同，而是替换掉原来的accessoryView属性值，即直接赋值。

      如下所示，将每个单元格的附加视图替换为一个label对象：

 1 -(UITableViewCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
 2 {
 3     UILabel * mainLabel = [[UILabel alloc] initWithFrame:CGRectMake(0.0, 0.0, 50.0, 15.0)];
 4     mainLabel.text = @"hello";
 5 
 6     static NSString *CellIdentifier = @"myCell";
 7     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];
 8     if(nil == cell)
 9     {
10         cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier];
11     }
12  
13     cell.accessoryView = mainLabel;
14     return cell;
15 }

 

2 选中管理

2.1 响应

2.1.1 基本响应

      当用户点击table view的row时，那么UIKit会自动调用UITableViewDelegate对象的tableView:didSelectRowAtIndexPath:方法，从而用户可以通过实现该方法来响应用户的点击操作。同时当该方法返回后，会照常执行一些动作，如segue操作。

      如下所示在用户点击时，将一个新的view controller推入Navigation栈中：

 - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
2 {
3     [tableView deselectRowAtIndexPath:indexPath animated:NO];
4     BATTrailsViewController *trailsController = [[BATTrailsViewController alloc] initWithStyle:UITableViewStylePlain];
5     trailsController.selectedRegion = [regions objectAtIndex:indexPath.row];
6     [[self navigationController] pushViewController:trailsController animated:YES]; 
7 }

注意：

      若row中有一个accessory view，并且为Detail或Detail Disclose类型的，则当用户点击row时将不会调用tableView:didSelectRowAtIndexPath:方法，而是调用tableView:accessoryButtonTappedForRowWithIndexPath: 方法。

2.1.2 自定义cell

      当用户（软件工程师）自定义了cell的内容，并且指定了自定义控件的响应方法。那么当用户点击了cell的自定义控件，则不会响应到didSelectRowAtIndexPath方法，而是响应到控件定义的响应方法中。

      如下所示，在附加view中自定义了一个UISwitch控件，并指定相应的响应方法：

 1 - (UITableViewCell *)tableView:(UITableView *)tv cellForRowAtIndexPath:(NSIndexPath *)indexPath {
 2     UITableViewCell *cell = [tv dequeueReusableCellWithIdentifier:@"CellWithSwitch"];
 3     if (cell == nil) {
 4         cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"CellWithSwitch"];
 5         cell.selectionStyle = UITableViewCellSelectionStyleNone;
 6         cell.textLabel.font = [UIFont systemFontOfSize:14];
 7     }
 8     UISwitch *switchObj = [[UISwitch alloc] initWithFrame:CGRectMake(1.0, 1.0, 20.0, 20.0)];
 9     switchObj.on = YES;
10     [switchObj addTarget:self action:@selector(toggleSoundEffects:) forControlEvents:(UIControlEventValueChanged | UIControlEventTouchDragInside)];
11     cell.accessoryView = switchObj;
12     
13     cell.textLabel.text = @"Sound Effects";
14     return cell;
15 }
16 
17 - (void)toggleSoundEffects:(id)sender {
18     [self.soundEffectsOn = [(UISwitch *)sender isOn];
19      [self reset];
20 }

2.2 Program选择和滚动

      可以手动滚动和选择table view中的某行到一个位置（上、中和下），UITableView提供的如下三个方法：

 1 -(void)selectRowAtIndexPath:(NSIndexPath*)indexPath
                   
 2                    animated:(BOOL)animated
              
 3                scrollPosition:(UITableViewScrollPosition)scrollPosition
 4 - (void)scrollToRowAtIndexPath:(NSIndexPath *)indexPath
             
 5               atScrollPosition:(UITableViewScrollPosition)scrollPosition
                     
 6                       animated:(BOOL)animated
 7 - (void)scrollToNearestSelectedRowAtScrollPosition:(UITableViewScrollPosition)scrollPosition
           
 8                                           animated:(BOOL)animated
 9 上述三个方法参数的语义为：
10                       indexPath：为table view行的路径为NSIndexPath类型，注意不是整数啊；
11                       scrollPosition：为滚动的位置，有顶部、中部、底部三个位置；
12                       animated：为是否动画滚动。

 

      如下所示，当用户点击某行时，将当前的下一行滚动到顶部：

 - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
2 {
3     NSIndexPath *scrollIndexPath;
4     scrollIndexPath = [NSIndexPath indexPathForRow:indexPath.row inSection:indexPath.section +1];
5   
6     [tableView selectRowAtIndexPath:scrollIndexPath animated:YES scrollPosition:UITableViewScrollPositionTop]; 
7 }

 

3 参考文献

      [1] Table View Programming Guide for IOS