UITableView - 学习笔记

• UITableView有两种样式：

[[UITableView alloc] initWithFrame:view.bounds style:UITableViewStylePlain];  
[[UITableView alloc] initWithFrame:view.bounds style:UITableViewStyleGrouped];  

• UITableView的结构：
  UITableView由头部，尾部，和中间一连串的单元格组成，UITableView的头部由tableHeaderView属性设置，尾部由tableFooterView属性设置，中间的行高可通过rowHeight属性设置

    _listArray = [[UIFont familyNames] retain];//获取所有字体名称
    
    _tableView = [[UITableView alloc] initWithFrame:view.bounds style:UITableViewStylePlain];
    // 设置数据源
    _tableView.dataSource = self;
    // 设置代理
    _tableView.delegate = self;
    // 设置表视图cell的高度，统一的高度
    _tableView.rowHeight = 70;    // 默认44px
    // 设置表视图的背景
    UIImageView *backgroundView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"IMG_0410"]];
    _tableView.backgroundView = backgroundView;
    [backgroundView release];
    // 设置表视图的颜色
//    _tableView.backgroundColor = [UIColor yellowColor];
    // 设置表视图的分割线的颜色
//    _tableView.separatorColor = [UIColor purpleColor];
    // 设置表视图的分割线的风格
    _tableView.separatorStyle = UITableViewCellSeparatorStyleSingleLine;
    // 设置表视图的头部视图(headView 添加子视图)
    UIView *headerView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 320, 80)];
    headerView.backgroundColor = [UIColor redColor];
    // 添加子视图
    UILabel *headText = [[UILabel alloc] initWithFrame:CGRectMake(60, 0, 200, 80)];
    headText.text = @"天晴朗,天晴朗天晴朗天晴朗!";
    headText.numberOfLines = 0;
    [headerView addSubview:headText];
    [headText release];
    _tableView.tableHeaderView = headerView; //设置头部
    [headerView release];
    // 设置表视图的尾部视图(footerView 添加子视图)    
    UIView *footerView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 320, 80)];
    footerView.backgroundColor = [UIColor yellowColor];
    _tableView.tableFooterView = footerView;  //设置尾部
    [footerView release];

• UITableView的一些常用属性：

  //设置UITableView分割线风格
  @property(nonatomic) UITableViewCellSeparatorStyle separatorStyle; 
  //设置UITableView分割线颜色，默认为标准灰色
  @property(nonatomic,retain) UIColor               *separatorColor;  
  //设置UITableView的头部
  @property(nonatomic,retain) UIView *tableHeaderView; 
  //设置UITableView的尾部
  @property(nonatomic,retain) UIView *tableFooterView; 
  //设置UITableView的Cell的高度
  @property (nonatomic)          CGFloat                     rowHeight;
  //设置UITableView种section的头部的高度
  @property (nonatomic)          CGFloat                     sectionHeaderHeight;
  //设置UITableView种section的尾部的高度
  @property (nonatomic)          CGFloat                     sectionFooterHeight;
  //设置UITableView的背景
  @property(nonatomic, readwrite, retain) UIView *backgroundView   NS_AVAILABLE_IOS(3_2);
  //设置UITableView是否可编辑，默认为no，不可编辑
  @property(nonatomic,getter=isEditing) BOOL editing; 
  - (void)setEditing:(BOOL)editing animated:(BOOL)animated;//方法带有动画效果
  

//当UITableView不在编辑时，cell是否可以选中，默认为yes
@property(nonatomic) BOOL allowsSelection NS_AVAILABLE_IOS(3_0);
//当UITableView在编辑时，cell是否可以选中，默认为no
@property(nonatomic) BOOL allowsSelectionDuringEditing;
//当UITableView不在编辑时，cell是否可以选中多个，默认为no
@property(nonatomic) BOOL allowsMultipleSelection NS_AVAILABLE_IOS(5_0);
//当UITableView在编辑时，cell是否可以选中多个，默认为no
@property(nonatomic) BOOL allowsMultipleSelectionDuringEditing NS_AVAILABLE_IOS(5_0);

- UITableView的一些常用方法：

//整体刷新UITableView

• (void)reloadData;

//指定一个cell，返回一个NSIndexPath，如果cell没有，返回nil

• (NSIndexPath *)indexPathForCell:(UITableViewCell *)cell;
  //指定一个范围，返回一组NSIndexPath，如果rect无效，返回nil
• (NSArray *)indexPathsForRowsInRect:(CGRect)rect;
  //指定一个NSIndexPath，返回一个cell
• (UITableViewCell *)cellForRowAtIndexPath:(NSIndexPath *)indexPath;
  //返回所有显示的cell
• (NSArray *)visibleCells;
  //返回所有显示的cell的NSIndexPath
• (NSArray *)indexPathsForVisibleRows;

- UITableView的一些编辑方法：

//插入一个cell到指定的indexPaths位置，指定一个动画效果

• (void)insertRowsAtIndexPaths:(NSArray *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation;
  //删除indexPaths位置的cell，指定一个动画效果
• (void)deleteRowsAtIndexPaths:(NSArray *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation;
  //刷新indexPaths位置的cell，指定一个动画效果（tableView的局部刷新， 一般用于cell的位置不改变，又不想刷新整个tableView时）
• (void)reloadRowsAtIndexPaths:(NSArray *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation NS_AVAILABLE_IOS(3_0);
  //移动indexPaths位置的cell，指定一个动画效果
• (void)moveRowAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath NS_AVAILABLE_IOS(5_0);

- UITableView数据源方法

//UITableView有多少个组

• (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView{
  return 1;//默认为1
  }
  //UITableView每组有多少条数据
• (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section;
  {
  return [_listArray count];
  }

//创建一个cell

• (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
  {
  static NSString *cellIdentifier = @"cell";
  UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier];
  if (cell == nil) {
  cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:cellIdentifier] autorelease];
  //cell的四种样式
  //UITableViewCellStyleDefault, 只显示图片和标题
  //UITableViewCellStyleValue1, 显示图片，标题和子标题（子标题在右边）
  //UITableViewCellStyleValue2, 标题和子标题
  //UITableViewCellStyleSubtitle 显示图片，标题和子标题（子标题在下边）

  }
  // 指向其中一行
  // cell.textLabel.text = [self.listArray objectAtIndex:indexPath.row];//设置cell的标题
  cell.textLabel.textColor = [UIColor redColor];//设置标题字体颜色
  cell.textLabel.font = [UIFont fontWithName:fontName size:18];//设置标题字体大小
  cell.imageView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@""]];//设置cell的图片
  cell.detailTextLabel = @"detailTextLabel"// 设置cell的子标题
  return cell;
  }

//设置组头部的文字

• (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section;
  //设置组尾部的文字
• (NSString *)tableView:(UITableView *)tableView titleForFooterInSection:(NSInteger)section;

//指定cell是否可编辑

• (BOOL)tableView:(UITableView *)tableView canEditRowAtIndexPath:(NSIndexPath *)indexPath;
  //指定cell是否可移动
• (BOOL)tableView:(UITableView *)tableView canMoveRowAtIndexPath:(NSIndexPath *)indexPath;
  //提交编辑操作，重写此方法，自动实现cell左滑动删除功能
• (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath;
  // 移动cell
• (void)tableView:(UITableView *)tableView moveRowAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath;

//右边索引显示的内容

• (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView
  {
  return _keyArray;
  }
  // 点击右边索引跳转到哪个index位置
• (NSInteger)tableView:(UITableView *)tableView sectionForSectionIndexTitle:(NSString *)title atIndex:(NSInteger)index
  {
  return index;
  }

- UITalbeView常用的代理方法：

//cell的行高

• (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath;
  //组头部的高度
• (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section;
  //组尾部的高度
• (CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section;
  //自定义组头部视图，此方法和数据源中设置头部标题的方法只能实现一个
• (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section; // custom view for header. will be adjusted to default or specified header height
  //自定义组尾部视图，此方法和数据源中设置尾部标题的方法只能实现一个
• (UIView *)tableView:(UITableView *)tableView viewForFooterInSection:(NSInteger)section;
  //点击cell时调用
• (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath;
  //取消点击cell时调用
• (void)tableView:(UITableView *)tableView didDeselectRowAtIndexPath:(NSIndexPath *)indexPath NS_AVAILABLE_IOS(3_0);

- UITableViewCell的一些辅助功能：

//sell的选中样式
cell.selectionStyle = UITableViewCellSelectionStyleBlue;

//如果想选中后取消，在didSelectRowAtIndexPath方法中调用
[tableView deselectRowAtIndexPath:indexPath animated:YES];或
[self performSelector:@selector(deselectRowAtIndexPath:animated:) withObject:indexPath afterDelay:.5];

//如果想在cell的右边出现选中状态或箭头可以设置下面的属性
cell.accessoryType = UITableViewCellAccessoryCheckmark;

//cell根据文字的多少自适应高度

• (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath
  {
  // wrong UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath];
  NSString *text = [_listArray objectAtIndex:indexPath.row];
  //320为文字显示的宽度，高度1000是随便写的，会自动根据文字的大小和宽度计算出高度
  CGSize size = [text sizeWithFont:[UIFont systemFontOfSize:14] constrainedToSize:CGSizeMake(320, 1000)];
  // +20是为了让每个cell之间有些间隔
  return size.height+20;
  }

  //这样写在IOS7.0以后 TableViewCell的分割线就不会往右挫15个像素点了
  UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:SimpleTableIdentifier];
  [tableViewsetSeparatorInset:UIEdgeInsetsMake(0,0,0,0)];