给OutlineView的条目添加图标

给OutlineView添加图标，图片其实是一个自定义NSTextFieldCell的过程。

在OutlineView里每一个item都有一个Item数据结构，一个item对应一个cell,这个数据结构仅仅与一个item关联，是无法显示的。我们可以根据这个数据结构来传给 cell一个objectValue,这个objectValue由OutlineViewDataSource传递到cell里，作为cell的一个数据成员。

通常情况下一个cell是一个NSTextField实例。它的objectValue是一个NSString.自定义一个cell当然也是可以用原先的objectValue,因为我们需要根据这个objectValue来重绘这个cell所以我们一般会重新构造这个objectValue.

关键代码如下：

定义ObjectValue:

1. @interface NSIconTextCellValueObject : NSObject 
2. <NSCopying> 
3.  
4. @property (copy) NSString * textValue; 
5. @property (retain) NSImage * p_w_picpathValue; 
6.  
7. @end 
8.  
9. @implementation NSIconTextCellValueObject 
10.  
11. @synthesize textValue = _textValue; 
12. @synthesize p_w_picpathValue = _p_w_picpathValue; 
13.  
14. -(id)copyWithZone:(NSZone *)zone 
15. { 
16.     NSIconTextCellValueObject* valueObject = [[NSIconTextCellValueObject alloc]init]; 
17.     valueObject.textValue = self.textValue; 
18.     valueObject.p_w_picpathValue = self.p_w_picpathValue; 
19.     return valueObject; 
20. } 
21.  
22. -(void)dealloc 
23. { 
24.     self.textValue = nil; 
25.     self.p_w_picpathValue = nil; 
26. } 
27.  
28. @end 

在NSTextFieldView的子类里实现重构objectValue:

1. -(void)setObjectValue:(id<NSCopying>)obj 
2. { 
3.     NSIconTextCellValueObject * value = (NSIconTextCellValueObject*)obj; 
4.     self.icon = value.p_w_picpathValue; 
5.     [super setObjectValue:value.textValue]; 
6. } 
7.  
8. -(id)objectValue 
9. { 
10.     NSIconTextCellValueObject * value = [[[NSIconTextCellValueObject alloc] init] autorelease]; 
11.     value.textValue = [super objectValue]; 
12.     value.p_w_picpathValue = self.icon; 
13.     return value; 
14. } 

这样，原先的textField部分就可以像父类一样显示。

顺便一提的是：一个OutlineView刷新的话实际是重用的一个cell,所以这个cell是必须得实现NSCopying协议的。

1. -(id)copyWithZone:(NSZone *)zone 
2. { 
3.     NSIconTextCell * cell = (NSIconTextCell*)[super copyWithZone:zone]; 
4.     cell.icon = [self.icon retain]; 
5.     return cell; 
6. } 

最后，再看看DataSource里怎么构造的objectValue,这个objectValue会自动传入到cell里。我这里只是用xml作测试的。这样理解起来应该很简单了。

1. -(id)outlineView:(NSOutlineView *)outlineView objectValueForTableColumn:(NSTableColumn *)tableColumn byItem:(id)item 
2. { 
3.     NSIconTextCellValueObject * valueObject = [[[NSIconTextCellValueObject alloc] init] autorelease]; 
4.     NSXMLElement * ele = (NSXMLElement*)item; 
5.     if ([ele childAtIndex:0].childCount > 1)  
6.     { 
7.         valueObject.p_w_picpathValue = self.folderImage; 
8.     } 
9.     else 
10.     { 
11.         valueObject.p_w_picpathValue = self.fileImage; 
12.     } 
13.     valueObject.textValue = ele.name; 
14.     return valueObject; 
15. } 

没有提供源代码，主要是因为官方已经有样例代码了，我在这里修改了它的代码，主要是修改了objectValue这一块。以理解objectValue的来龙去脉。以便更好的使用它。