HMDT - Logic and Intuition -

Application Kit - NSCell

NSCell とは

Keywords: NSCell

Cocoa には、たくさんの GUI のコントローラになる部品があるよね。たとえばボタン（NSButton）、たとえばスライダー（NSSlider）、たとえばテキストフィールド（NSTextField）。こいつらを実際に作るには、ユーザからの入力を受け付けて、画面にコントローラを描いて、適当なオブジェクトにメッセージを送る、っていう処理が必要になるよな。このうち、画面に描く、っていう部分を担当するのが NSCell クラスだ。残りの部分（ユーザからの入力を受け付ける、と、メッセージを送る）は、NSControl っていうクラスが担当する。別の言い方をすると、NSCell がコントローラの見栄えを、NSControl がコントローラの動作を担当すると言えるんだ。

さて、NSCell の成り立ちは上のような感じだけど、その役割には 2 つの側面がある。まず、軽量な描画オブジェクトっていう役割。普通、画面になにか描くときは NSView を使うじゃない。だけど、NSView って重いでしょ？ここでいう重いって意味は、インスタンスのメモリサイズがでかい、って意味と、responder chain に入れられたり View の親子関係があったりして関係が複雑、っていうこと。それに対して、NSCell は NSObject から直接継承しているし、インスタンス変数もそんなにないから、軽量なんだ。

もう 1 つは、コントローラの値を保持するオブジェクトという役割。たとえばラジオボタンなら、On か Off、または On か Off か Mixed っていう値をとるでしょ。それを保持しておくのが NSButtonCell なんだ。

Application Kit - NSCell

NSCell のサブクラス

Keywords: NSCell subclass

Cocoa で実装されている NSCell のサブクラスを抜き出してみた。自前の NSCell を作るときは、これを見てどこから継承するか考えるといいかも。

• NSCell
• NSActionCell
• NSButtonCell
• NSMenuItemCell
• NSPopUpButtonCell
• NSFormCell
• NSSliderCell
• NSStepperCell
• NSTextFieldCell
• NSComboBoxCell
• NSSecureTextFieldCell
• NSTableHeaderCell
• NSBrowserCell
• NSImageCell
• NSTextAttachmentCell

Application Kit - NSCell

NSCell が保持する値

Keywords: object value, cell states, image, represented object

セルには、値を持たせておくことができるんだ。それが、セルの役割の 1 つだからね。NSCell では、4 通りの値を持たせておくことができる。

• object value
• cell state
• image
• represented object

順に見ていこう。

◇ object value

object value が、メインになるものだ。基本的に、セルはこの値を表示することになる。たとえば、NSFormCell は、NSString 型の object value を表示するんだ。ここにアクセスするには、以下のメソッドを使う。

- (id <NSCopying>)objectValue;
- (void)setObjectValue:(id <NSCopying>)obj;
- (NSString *)stringValue;
- (void)setStringValue:(NSString *)aString;
- (int)intValue;
- (void)setIntValue:(int)anInt;
- (float)floatValue;
- (void)setFloatValue:(float)aFloat;
- (double)doubleValue;
- (void)setDoubleValue:(double)aDouble;

NSString や int や double やら好きな型でアクセスできる。でも、NSCell は一度に 1 つしか保持できないから気をつけてくれ。

◇ cell state

次に cell state は、ラジオボタンなんかで使われる。state には、on、off の 2 つの state を持つものと、on、off、mixed の 3 つの state を持つものがある。アクセスするには、以下のメソッドを使う。

- (int)state;
- (void)setState:(int)value;
- (void)setAllowsMixedState:(BOOL)flag;
- (BOOL)allowsMixedState;
- (int)nextState;
- (void)setNextState;

◇ image

次は image。NSCell は image を、別に、保持しておくことができる。アクセスするには、以下のメソッドを使う。

- (NSImage *)image;
- (void)setImage:(NSImage *)image;

ちょっと混乱するけど、これを使って保持する image は、object value とは別のものになるんだ。ヘッダを見ると、こんな感じになってる。

@interface NSCell : NSObject <NSCopying, NSCoding>
{
    /*All instance variables are private*/
    id _contents;
    _CFlags _cFlags;
@private
    // This variable should *only* be accessed 
    // through the following methods:
    // setImage:, image, setFont:, and font
    id _support;
    ...

}

つまり、NSCell には _contents と _support というフィールドがある。_contents の方が object value を保持しておくもので、_support の方は image か font を保持しておくものだ。だから、1 つのセルに、たとえば、テキストと画像の両方を持たせておくことができる。ただ、疑問なのは、image と font を両方同時に持つことはできないのか？だとしたら、ちょっと不便。

◇ represented object

最後、represented object。これは、ドキュメントによると、NSCell が表すオブジェクトのこと。アクセスするには、以下のメソッドを使う。

- (id)representedObject;
- (void)setRepresentedObject:(id)anObject;

この値は、セルの挙動とは関係ないので、デベロッパが好きに使えるらしい。気をつけてほしいのは、object value とごっちゃにしないでくれ、っていうことだ。object value は、セルが、自分を表示するために使われる値。それに対して represented object は、セルとは関係なく、情報の保存場所として使える値なんだ。

- (void)drawInteriorWithFrame:(NSRect)cellFrame 
                inView:(NSView *)controlView;
- (void)drawWithFrame:(NSRect)cellFrame 
                inView:(NSView *)controlView;

- (NSImage *)image;
- (void)setImage:(NSImage *)image;
- (NSString *)stringValue;
- (void)setStringValue:(NSString *)aString;

- (void)drawInteriorWithFrame:(NSRect)cellFrame 
                inView:(NSView*)controlView
{
    NSString* path;
    NSRect    pathRect;
    
    NSImage*  iconImage;
    NSSize    iconSize;
    NSPoint   iconPoint;
    
    // 画像を描く
    iconImage = [self image];
    iconSize = NSZeroSize;
    iconPoint.x = cellFrame.origin.x;
    iconPoint.y = cellFrame.origin.y;
    
    if(iconImage) {
        iconSize.width = ICON_SIZE_WIDTH;
        iconSize.height = ICON_SIZE_HEIGHT;
        iconPoint.x += MARGIN_X;
        
        if([controlView isFlipped]) {
            iconPoint.y += iconSize.height;
        }
        
        [iconImage setSize:iconSize];
        [iconImage compositeToPoint:iconPoint 
                operation:NSCompositeSourceOver];
    }
    
    // テキストを描く
    path = [self stringValue];
    pathRect.origin.x = cellFrame.origin.x + MARGIN_X;
    if(iconSize.width > 0) {
        pathRect.origin.x += iconSize.width + MARGIN_X;
    }
    pathRect.origin.y = cellFrame.origin.y;
    pathRect.size.width = cellFrame.size.width 
                - (pathRect.origin.x - cellFrame.origin.x);
    pathRect.size.height = cellFrame.size.height;
    
    if(path) {
        [path drawInRect:pathRect withAttributes:nil];
    }
}

- (void)setAttributedStringValue:(NSAttributedString *)obj;

- (void)tableView:(NSTableView *)tableView 
        willDisplayCell:(id)cell 
        forTableColumn:(NSTableColumn *)tableColumn 
        row:(int)row
{
    NSMutableAttributedString* attrStr;
    NSRange range = {0, 0};
    
    attrStr = [[NSMutableAttributedString alloc] 
            initWithString:[cell objectValue]];
    [attrStr autorelease];
    range.length = [attrStr length];
    [attrStr addAttribute:NSFontAttributeName 
            value:_font range:range];
    
    [cell setAttributedStringValue:attrStr];
}

back to top content