へびにっき

メモリ警告によってViewが破棄された場合、UITableViewのスクロール位置はリセットされてしまう。再度Viewが読み込まれたときに元の位置に戻すには、破棄される直前のスクロール位置を覚えておく必要がある。だいたい次のようなコードになる：

ScrollTestViewController.h

#import <UIKit/UIKit.h>
 
/* UITableViewControllerではなくUIViewControllerを使っている理由は後述 */
@interface ScrollTestViewController :
UIViewController<UITableViewDataSource, UITableViewDelegate> {
 
    /* UITableViewはIBOutletでretainする想定 */
    UITableView *_tableView;
 
    /* Viewが破棄される直前のスクロール位置 */
    CGPoint lastScrollOffset;
}
@property (nonatomic, retain) IBOutlet UITableView *tableView;
 
@end

ScrollTestViewController.m

@implementation ScrollTestViewController
 
@synthesize tableView = _tableView;
 
- (void)viewDidLoad {
    [super viewDidLoad];
 
    /*
     reloadDataでデータを読み込んだ後に
     記録されているスクロール位置を復帰
     初期化直後は{0,0}で初期化されているので影響はない
    */
    [_tableView reloadData];
    [_tableView setContentOffset:lastScrollOffset];
}
 
- (void)viewDidUnload {
    [super viewDidUnload];
 
    /*
     スクロール位置を記録した後でUITableViewを破棄する
     viewDidUnloadが呼ばれた時点でメインのViewは既に破棄されているが、
     Controllerがretainしているサブビューはまだ生きているというのがポイント
    */
    lastScrollOffset = [_tableView contentOffset];
    self.tableView = nil;
}
 
- (void) dealloc {
    self.tableView = nil;
    [super dealloc];
}
 
/*
...
その他、UIViewControllerでUITableViewを使うためには
viewWillAppearで選択を解除する処理などが必要だが
本題には関係ないので省略
...
*/
 
@end

ここでUITableViewControllerを使ってしまうと、UITableViewが破棄されるタイミングや再読み込みされるタイミングを制御できなくなるので、記憶するのも元に戻すのも難しくなる。例えばUITableViewのreloadDataをオーバーライドする必要があったりするらしい。

参考: iPhone 画面切り替え時、あらかじめテーブルビューを目的の位置にスクロールさせとく技

iOSとMac OS Xとで結論が異なる。OS X開発経験者が書いた書籍やWebサイトはこの違いを考慮していない場合があるので注意が必要。

……

IBOutletの宣言はインスタンス変数にもプロパティにも書くことができる。

@interface IBOutletTestAppDelegate : NSObject <UIApplicationDelegate> {
    UILabel *_retainLabel;
    UILabel *_assignLabel;
    IBOutlet UILabel *_variableLabel;
}
 
@property (nonatomic, retain) IBOutlet UILabel *retainLabel;
@property (nonatomic, assign) IBOutlet UILabel *assignLabel;
@end

iOSの場合、IBOutletをどちらに書いても、アウトレットの接続は常にNSObject(NSKeyValueCoding)の setValue:forKey: メソッドを使って行われる。このメソッドは(1)まず対応するプロパティのsetterを探して、(2)見つからない場合はインスタンス変数に代入してretainカウントを1増やす。よってassignプロパティを使うのでない限り、アウトレットで接続した変数は常にreleaseしなければならない。

この動作は setValue:forKey: をオーバーライドしてみれば確認できる。

- (void)setValue:(id)value forKey:(NSString *)key
{
    //retainのプロパティとインスタンス変数の場合は
    //retainCountが1増える
    NSLog(@"[before setValue] %@ %d", key, [value retainCount]);
    [super setValue:value forKey:key];
    NSLog(@"[aflter setValue] %@ %d", key, [value retainCount]);
}

ただしAppleが提供するGuideでは常にプロパティを使うことを推奨している（Memory Management Programming Guideの『Memory Management of Nib Objects』など）。プロパティを使うことでretain/assignのポリシーが明確にできるし、retain/assignどちらの場合もviewを破棄する際にはnilを代入するだけで良い。特にretainの場合はreleaseとnil代入の操作を一度にできるので便利である。

……

Nibファイルによるオブジェクトの生成と、生成されたオブジェクトのretain状況についてはResource Programming Guideの『The Nib Object Life Cycle』にまとめられている。これを読むとOS Xの方が（GCを使わない場合）状況が複雑だということがわかる。

簡単にまとめると

iOSの場合

• 生成されたオブジェクトは全てautorelease済みである
• アウトレットの接続は setValue:forKey: メソッドで行われる

OS X（GCなし）の場合

• 生成されたオブジェクトは、トップレベルのオブジェクトを除いてautorelease済みである。
• アウトレットの接続は、(1)まずset{OutletName}:というメソッドを探して、(2)見つからない場合はインスタンス変数にretainカウントを増やさずに代入される

OS X（GCなし）の場合、トップレベルのオブジェクとそれ以外のオブジェクトとで扱いが異なるので、一貫したポリシーを立てるのが難しくなっている。もしretainのプロパティを使った場合、トップレベルのオブジェクトは2回releaseしなければならない。もしインスタンス変数に直接代入した場合、トップレベルのオブジェクトに限りreleaseしなければならない。

External Objectを使うことで、Nibファイル外のオブジェクトに対してIBOutletで接続できる。ちなみにこの機能はMac OS Xでは使用できず、iOSでのみ使える。

……

たとえばあるカスタムビューからモデルのインスタンスを参照したいとする。このビューでは常にモデルの状態を反映した表示を行いたいので、インスタンス変数にモデルへの参照を保持しておきたい。

ビューの生成・初期化をプログラム中で行うなら、initWithModel:のような初期化子を用意しておけば済む。しかしビューをNibファイルから生成する場合は初期化時にモデルを参照することができない（モデルは普通Nibファイルで生成しないので）。仕方がないのでモデルのインスタンスだけはUIViewControllerのviewDidLoadでビューに代入して、専用の初期化メソッドを呼び出すなどするしかない。これは非常に面倒だし忘れやすい。

- (void)viewDidLoad
{
    [super viewDidLoad];
 
    //プロパティに代入してから表示を更新。面倒くさい
    _customView.model = _model;
    [_customView update];
 }

そこでExternal Objectの出番である。このオブジェクトはNibファイル外の既成のオブジェクトに対するPlaceholderとして機能する。ちょうど自由な名前をつけられる「File’s Owner」だと考えれば良い。

使い方は次のようになる。まずカスタムビューの.hファイルで、モデルに対するOutletを設定しておく。

@interface CustomView : UITableViewCell
{
    Model *_model;
}
 
@property (nonatomic, retain) IBOutlet Model *model;

モデルを使った初期化処理は、その他の初期化処理と同じくawakeFromNibの中に書くことができる。

- (void)awakeFromNib
{
    [super awakeFromNib];
 
    //モデルのデータを使って表示を初期化する
    _textField.text = _model.name;
}

続いてxibファイルを開いてExternal Objectの設定を行う。Libraryの中から「External Object」を選んでObjectsの欄にドラッグアンドドロップすると、Placeholdersの欄にオブジェクトが追加される。

追加されたオブジェクトを選択してIdentity inspectorを開き、「Custom Class」の中でモデルクラスのクラス名を指定する。

次にAttributes inspectorを開き、Identityの欄にxibファイル中で一意な識別子を設定する。この識別子が実際のオブジェクトを割り当てる際のキーになる。

あとは通常のOutlet接続と同じ操作で、カスタムビューのOutletプロパティからPlaceholders内のモデルに対して接続を行っておく。

これでxibファイルの準備ができたので、あとはNib読み込みの際にExternal Objectとして参照されるオブジェクトの実体を指定する。これにはNSBundleクラスの loadNibNamed:owner:options: メソッドの UINibExternalObjects オプションを使う。

Nibファイルの読み込みはUIViewControllerのloadViewメソッで行うのが良いだろう。以下のサンプルコードではコントローラがモデルのインスタンスを変数 _model に保持しており、xibファイル内でExternal Objectには Model というidentityを割り当てたと想定している。YourNibFileNameは読み込むNibの名称。

- (void)loadView
{
    NSArray *topLevelObjs = nil;
    NSDictionary *proxies = [NSDictionary dictionaryWithObject:_model forKey:@"Model"];
    NSDictionary *options = [NSDictionary dictionaryWithObject:proxies forKey:UINibExternalObjects];
    topLevelObjs = [[NSBundle mainBundle] loadNibNamed:@"YourNibFileName" owner:self options:options];
 
    if ([topLevelObjs count] == 0) {
        NSLog(@"Warning! Could not load nib file.\n");
        return;
    }
}

これによって特別な初期化操作をしなくても、Nibファイル内のカスタムビューとコントローラとで一つのモデルのインスタンスを共有することができる。

参考: Resource Programming Guide