iPhoneアプリ開発の虎の巻
HOME > UITableViewCell

UITableViewCell

UITableViewCellクラスは、テーブル(UITableView)表示する時、1つ1つのセルを管理するクラスです。

UITableViewCellのクラス階層

NSObjectUIResponderUIView ↑ UITableViewCell

生成

// スタイルを指定した生成例
static NSString *CellIdentifier = @"Cell";
UITableViewCell *cell =
    [[UITableViewCell alloc] initWithStyle:スタイル名 reuseIdentifier:CellIdentifier];

// 空のセル生成例
static NSString *CellIdentifier = @"Cell";
UITableViewCell *cell =
    [[UITableViewCell alloc] initWithFrame:CGRectZero reuseIdentifier:CellIdentifier];

※サイズに関しては、サイズ指定のCGRect欄をご覧ください。

【スタイルの種類】
スタイル名 説明
UITableViewCellStyleDefault 画像(左)と主テキスト(右)があるセル
UITableViewCellStyleValue1 主テキスト(左)とサブテキスト(右)があるセル
UITableViewCellStyleValue2 サブテキスト(左)と主テキスト(右)があるセル
UITableViewCellStyleSubtitle 画像(左)と主テキスト(右上)とサブテキスト(右下)があるセル

UITableViewCellのプロパティ

【UITableViewCellの主要プロパティ】
プロパティ名/型 読専 説明
textLabel.text
NSString
テキストを設定する
(例)cell.textLabel.text = @"ほげ";
textLabel.textColor
UIColor
テキストの色を設定する
(例)cell.textLabel.textColor = [UIColor blueColor];
textLabel.font
UIFont
フォントを設定する
(例)cell.textLabel.font =
  [UIFont systemFontOfSize:[UIFont systemFontSize]];
textLabel.textAlignment
(UITextAlignment)
横揃えを設定する
 中央寄せ: UITextAlignmentCenter
 左寄せ: UITextAlignmentLeft
 右寄せ: UITextAlignmentRight
(例)cell.textLabel.textAlignment = UITextAlignmentCenter;
detailTextLabel.text
NSString
テキストを設定する
(例)cell.detailTextLabel.text = @"ほげ";
detailTextLabel.textColor
UIColor
テキストの色を設定する
(例)cell.detailTextLabel.textColor = [UIColor blueColor];
detailTextLabel.font
UIFont
フォントを設定する
(例)cell.detailTextLabel.font =
  [UIFont systemFontOfSize:[UIFont systemFontSize]];
detailTextLabel.textAlignment
(UITextAlignment)
横揃えを設定する
 中央寄せ: UITextAlignmentCenter
 左寄せ: UITextAlignmentLeft
 右寄せ: UITextAlignmentRight
(例)cell.detailTextLabel.textAlignment = UITextAlignmentCenter;
imageView.image
UIImage
画像を設定する
(例)cell.imageView.image =
     [UIImage imageNamed:@"hoge.png"];
accessoryType
(UITableViewCellAccessoryType)
アクセサリの設定
UITableViewCellAccessoryDisclosureIndicator:
  DisclosureIndicator
UITableViewCellAccessoryDetailDisclosureButton:
  DetailDisclosureButton
UITableViewCellAccessoryCheckmark:
  Checkmark
UITableViewCellAccessoryNone:
  なし
(例)cell.accessoryType = UITableViewCellAccessoryNone;
selectionStyle
(UITableViewCellSelectionStyle)
セル選択時の色の設定
UITableViewCellSelectionStyleBlue:青
UITableViewCellSelectionStyleGray:灰
UITableViewCellSelectionStyleNone:なし
(例)cell.selectionStyle = UITableViewCellSelectionStyleGray;

主要なプロパティのみ掲載しています。
 上記「UITableViewCellのクラス階層」にあるクラスのプロパティも使用できます。

UITableViewCell例文

// テーブルビューセル例文
static NSString *CellIdentifier = @"Cell";
UITableViewCell *cell =
    [tableView dequeueReusableCellWithIdentifier:CellIdentifier];

if(cell == nil){
  cell = [[UITableViewCell alloc]
      initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier];
  cell.textLabel.textColor = [UIColor blueColor];
  cell.accessoryType = UITableViewCellAccessoryDetailDisclosureButton;
  cell.selectionStyle = UITableViewCellSelectionStyleGray;
}

cell.textLabel.text = @"ほげ";
//セルの背景を青色にする
cell.contentView.backgroundColor = [UIColor blueColor];
totop