内容の保証はできません。


/System/Library/frameWorks/UIKit.framework

クラス UITableViewCell

NSObject
  |
  +--UIResponder
      |
      +--UIView
          |
          +--UITableViewCell

概要

UITableViewCellクラスはUITableViewオブジェクトに表示されるセルの属性と挙動を定義します。

UITableViewCellオブジェクト(またはテーブルセル)は、選択状態や編集状態の管理・アクセサリビューの制御・コントロールやセルの背景の再整理・コンテンツのインデントを行うメソッドやプロパティを実装しています。また、ターゲットオブジェクトと詳細を開示するボタンの持つアクションセレクタを関連付けるためのプロパティもあります。さらに、セルコンテンツ、特にテキストやイメージの設定・管理を行うためのプロパティも含まれています。

UITableViewオブジェクトを拡張する場合は、標準的な2つの方法があります。様々なフォーマットやサイズの文字列やイメージを持つ複数のセルを作成するために、セルのコンテンツビューを取得して(contentViewプロパティ)、サブビューを追加することができます。また、UITableViewCellのサブクラスにアプリケーションが必要としているセルの特性や特定の行動を取得させる事もできます。

タスク

インスタンスの作成

– initWithStyle:reuseIdentifier: 3.0b以降
– initWithFrame:reuseIdentifier: 3.0b以降では非推奨

セルの再利用

reuseIdentifier property
– prepareForReuse

セルコンテンツのテキストの管理

textLabel property 3.0b以降
detailTextLabel property 3.0b以降
text property 3.0b以降では非推奨
font property 3.0b以降では非推奨
textAlignment property 3.0b以降では非推奨
textColor property 3.0b以降では非推奨
selectedTextColor property 3.0b以降では非推奨
lineBreakMode property 3.0b以降では非推奨

セルコンテンツのイメージの管理

imageView property 3.0b以降
image property 3.0b以降では非推奨
selectedImage property 3.0b以降では非推奨

セルオブジェクトのビューへのアクセス

contentView property
backgroundView property
selectedBackgroundView property

アクセサリビューの管理

accessoryView property
accessoryType property
editingAccessoryType property 3.0b以降
editingAccessoryView property 3.0b以降
hidesAccessoryWhenEditing property 3.0b以降では非推奨

セルの選択とハイライトの管理

selected property
selectionStyle property
– setSelected:animated:
highlighted property 3.0b以降
– setHighlighted:animated: 3.0b以降

セルの編集

editing property
– setEditing:animated:
editingStyle property
showingDeleteConfirmation property
showsReorderControl property

状態遷移の調整

– willTransitionToState: 3.0b以降
– didTransitionToState: 3.0b以降

コンテンツのインデントの管理

indentationLevel property
indentationWidth property
shouldIndentWhileEditing property

ターゲット・アクションの管理

target property 3.0b以降では非推奨
editAction property 3.0b以降では非推奨
accessoryAction property 3.0b以降では非推奨

プロパティ

accessoryAction

ユーザがアクセサリビューをタップした時に呼び出されるアクションメッセージを定義するセレクター。

@property(nonatomic) SEL accessoryAction

accessoryType

標準時のアクセサリビューのタイプ。

@property(nonatomic) UITableViewCellAccessoryType accessoryType

accessoryView

一般的にコントロールとして使用されるセルの右側にあるビュー。

@property(nonatomic, retain) UIView *accessoryView

backgroundView

セルの背景として使用されるビュー。

@property(nonatomic, retain) UIView *backgroundView

contentView

セルオブジェクトのコンテンツビューを返す。(読み取りのみ)

@property(nonatomic, readonly, retain) UIView *contentView

detailTextLabel

テーブルセルの補助ラベルを存在するなら返す。(読み取りのみ)

@property(nonatomic, readonly, retain) UILabel *detailTextLabel

editAction

ユーザが追加または削除ボタンを押した時に呼び出されるアクションメッセージを定義するセレクター。

@property(nonatomic) SEL editAction

editing

セルが編集状態にあるかどうかを返す。

@property(nonatomic, getter=isEditing) BOOL editing

editingAccessoryType

テーブルビューが編集状態にあるときのアクセサリビューのタイプ。

@property(nonatomic) UITableViewCellAccessoryType editingAccessoryType

editingAccessoryView

編集モード時に一般的にコントロールとして使用されるセルの右側にあるビュー。

@property(nonatomic, retain) UIView *editingAccessoryView

editingStyle

セルの編集スタイル。(読み取りのみ)

@property(nonatomic, readonly) UITableViewCellEditingStyle editingStyle

font

タイトルのフォント。

@property(nonatomic, retain) UIFont *font

hidesAccessoryWhenEditing

セルが編集されている時アクセサリビューが非表示にされるかどうかを決定する。

@property(nonatomic) BOOL hidesAccessoryWhenEditing

highlighted

セルがハイライトされているかどうかを示す。

@property(nonatomic, getter=isHighlighted) BOOL highlighted

image

セルのコンテンツとして使用されるイメージ。

@property(nonatomic, retain) UIImage *image

imageView

テーブルセルのイメージビューを返す。(読み取りのみ)

property(nonatomic, readonly, retain) UIImageView *imageView

indentationLevel

インデントレベルを調整する。

@property(nonatomic) NSInteger indentationLevel

indentationWidth

セルコンテンツのインデントの幅。
デフォルトのへこみ幅の値は10.0

@property(nonatomic) CGFloat indentationWidth

lineBreakMode

セルのテキストのラッピングまたは切り詰めを行うモード。

@property(nonatomic) UILineBreakMode lineBreakMode

reuseIdentifier

再利用可能なセルを識別するために使用される文字列。

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

selected

セルが選択されているかどうかを示す。

@property(nonatomic, getter=isSelected) BOOL selected

selectedBackgroundView

セルが選択されている時にその背景として使用されるビュー。

@property(nonatomic, retain) UIView *selectedBackgroundView

selectedImage

セルが選択された時のセルコンテンツを使用するためのイメージ。

@property(nonatomic, retain) UIImage *selectedImage

selectedTextColor

セルが選択された時のタイトルテキストの色。

@property(nonatomic, retain) UIColor *selectedTextColor

selectionStyle

セルを選択しているときのスタイル。

@property(nonatomic) UITableViewCellSelectionStyle selectionStyle

shouldIndentWhileEditing

テーブルビューが編集モードに入った時、インデントされたセルの背景を制御するかどうかを示す。

@property(nonatomic) BOOL shouldIndentWhileEditing

showingDeleteConfirmation

セルが現在、削除 確認ボタンを表示しているかどうかを返す。(読み取りのみ)

@property(nonatomic, readonly) BOOL showingDeleteConfirmation

showsReorderControl

セルが並べ換えコントロールを表示するかどうかを決定する。

@property(nonatomic) BOOL showsReorderControl

target

アクションメッセージを返すためのターゲットオブジェクト。

@property(nonatomic, assign) id target

text

セルのテキスト

@property(nonatomic, copy) NSString *text

textAlignment

セルのテキストの整列の仕方を指定する定数。

@property(nonatomic) UITextAlignment textAlignment

textColor

タイトルテキストの色。

@property(nonatomic, retain) UIColor *textColor

textLabel

テーブルセルのメインのテキストコンテンツに使用されるラベルを返す。

@property(nonatomic, readonly, retain) UILabel *textLabel

インスタンスメソッド

didTransitionToState:

セルの指定された状態で状態遷移した直後にセルによって呼び出される。

- (void)didTransitionToState:(UITableViewCellStateMask)state

initWithFrame:reuseIdentifier:

テーブルセルオブジェクトを初期化して返す。

- (id)initWithFrame:(CGRect)frame reuseIdentifier:(NSString *)reuseIdentifier

initWithStyle:reuseIdentifier:

状態と再利用識別子でテーブルセルを初期化して返す。

- (id)initWithStyle:(UITableViewCellStyle)stylereuseIdentifier:(NSString *)reuseIdentifier

prepareForReuse

テーブルビューのデリゲートによって再利用するために再利用可能なセルを用意する。

- (void)prepareForReuse

setEditing:animated:

レシーバを編集モードの状態にする。または編集モードから抜け出す。

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

setHighlighted:animated:

セルのハイライト状態を設定する。オプションでそのハイライト時のアニメーションの有無を指定できる。

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

setSelected:animated:

セルの選択状態を設定する。オプションでそのハイライト時のアニメーションの有無を指定できる。

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

willTransitionToState:

セルが指定された状態で状態遷移に入る直前に呼び出される処理。

- (void)willTransitionToState:(UITableViewCellStateMask)state


トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2011-06-06 (月) 15:35:00 (2357d)