OutlineView

在mac開發(fā)中,常常需要用類似列表的結(jié)構(gòu)來展示數(shù)據(jù),最好還有層級,類似于樹,比如族譜、菜單等層級結(jié)構(gòu)數(shù)據(jù)。這個時候NSTableView已經(jīng)不能夠很好的滿足我們了,NSOutlineView則給我們提供了更好的選擇。

NSOutlineView是NSTableView的子類,但是他比NSTableView多了分組的功能,使用層級的數(shù)據(jù)結(jié)構(gòu)。

現(xiàn)在NSOutlineView的教程還不是很多,不夠全面,大多都是使用Storyboard/xib開發(fā),下面以一個Demo為例介紹純代碼實現(xiàn)使用NSOutlineView顯示層級數(shù)據(jù)結(jié)構(gòu)的過程。

首先創(chuàng)建一個OS X項目工程,創(chuàng)建一個NSViewController,在ViewController中添加NSOutlineView對象(outlineView)并實現(xiàn)NSOutlineViewDataSource和NSOutlineViewDelegate相應(yīng)的方法。

第一步,我們需要初始化outlineView并設(shè)置相關(guān)屬性。

(需要注意的是,outlineView必須放在scrollView上才可以顯示,所以我們在初始化outlineView的時候,需要將outlineView作為scrollView的documentView展示。)

、、、

NSTableColumn *tableColumn = [[NSTableColumn alloc] init];

tableColumn.resizingMask = NSTableColumnAutoresizingMask;

NSOutlineView *outlineView = [[NSOutlineView alloc] init];

outlineView.allowsColumnResizing = YES;

outlineView.headerView = nil;

outlineView.columnAutoresizingStyle = NSTableViewFirstColumnOnlyAutoresizingStyle;

outlineView.usesAlternatingRowBackgroundColors = YES;//背景顏色的交替,一行白色,一行灰色。

[outlineView addTableColumn:tableColumn];

NSScrollView *scrollView = [[NSScrollView alloc] init];

scrollView.documentView = outlineView;

scrollView.hasVerticalScroller = YES;

scrollView.autohidesScrollers = YES;

self.view = scrollView;

、、、

另外需要注意的一點是,我們需要實現(xiàn)loadView方法。

第二步,我們需要準(zhǔn)備好用于展示的數(shù)據(jù)。

如果在項目中,數(shù)據(jù)可以通過model的形式從外部直接傳過來,demo里我們就直接初始化。這里需要注意,outlinView需要的數(shù)據(jù)是一種類型的(父子節(jié)點數(shù)據(jù)是同種類型)。

-(void)initData {

//第一級根節(jié)點

_dataModel? = [[OutlineViewDataModel alloc] init];

_dataModel.name = @"root";

//2級節(jié)點

OutlineViewDataModel *level1Node = [[OutlineViewDataModel alloc]init];

level1Node.name = @"節(jié)點1";

OutlineViewDataModel *level2Node = [[OutlineViewDataModel alloc]init];

level2Node.name = @"節(jié)點2";

OutlineViewDataModel *level3Node = [[OutlineViewDataModel alloc]init];

level3Node.name = @"節(jié)點3";

//1

OutlineViewDataModel *level11Node = [[OutlineViewDataModel alloc]init];

level11Node.name = @"節(jié)點1-1";

OutlineViewDataModel *level12Node = [[OutlineViewDataModel alloc]init];

level12Node.name = @"節(jié)點1-2";

OutlineViewDataModel *level111Node = [[OutlineViewDataModel alloc]init];

level111Node.name = @"節(jié)點1-1-1";

OutlineViewDataModel *level112Node = [[OutlineViewDataModel alloc]init];

level112Node.name = @"節(jié)點1-1-2";

level11Node.childNodes = @[level111Node,level112Node];

level1Node.childNodes = @[level11Node,level12Node];

//2

OutlineViewDataModel *level21Node = [[OutlineViewDataModel alloc]init];

level21Node.name = @"節(jié)點2-1";

OutlineViewDataModel *level22Node = [[OutlineViewDataModel alloc]init];

level22Node.name = @"節(jié)點2-2";

level2Node.childNodes = @[level21Node,level22Node];

//3

OutlineViewDataModel *level31Node = [[OutlineViewDataModel alloc]init];

level31Node.name = @"節(jié)點3-1";

OutlineViewDataModel *level311Node = [[OutlineViewDataModel alloc]init];

level311Node.name = @"節(jié)點3-1-1";

OutlineViewDataModel *level312Node = [[OutlineViewDataModel alloc]init];

level312Node.name = @"節(jié)點3-1-2";

level31Node.childNodes = @[level311Node,level312Node];

level3Node.childNodes = @[level31Node];

_dataModel.childNodes = @[level1Node,level2Node,level3Node];

}

其中model的數(shù)據(jù)結(jié)構(gòu):

@property(nonatomic, strong) NSString *name;

@property(nonatomic, strong) NSArray *childNodes;

第三步,根據(jù)需要自定義NSTableCellView。

除了自定義布局和樣式,還需要在自定義的cellview中實現(xiàn)數(shù)據(jù)的展示:

//? OutlineItemCellView.m

-(void)setObjectValue:(id)objectValue {

? ? [super setObjectValue:objectValue];

? ? if (self.objectValue) {

? ? ? ? if ([self.objectValue isKindOfClass:[OutlineViewDataModel class]]) {

? ? ? ? ? ? OutlineViewDataModel *model = (OutlineViewDataModel *)self.objectValue;

? ? ? ? ? ? [self updateControlsForDataObject:model.name];

? ? ? ? }

? ? }

}

-(void)updateControlsForDataObject:(NSString *)name {

? ? self.textField.stringValue = name;

? ? self.textField.textColor = [NSColor whiteColor];

}

第四步,根據(jù)需要自定義NSTableHeaderCell。

類似于NSTableCellView,自定義樣式和數(shù)據(jù)展示即可。

第五步,在viewController中實現(xiàn)NSOutlineViewDataSource和NSOutlineViewDelegate的方法。

下面介紹一下幾個NSOutlineViewDataSource方法,根據(jù)需要選擇性實現(xiàn):

1.每一層級節(jié)點包含的下一級節(jié)點的數(shù)量。

-(NSInteger)outlineView:(NSOutlineView *)outlineView numberOfChildrenOfItem:(id)item {

? ? //當(dāng)item為空時表示根節(jié)點.

? ? if (item != nil && [item isKindOfClass:[OutlineViewDataModel class]]) {

? ? ? ? return ((OutlineViewDataModel *)item).childNodes.count;

? ? }

? ? return _dataModel.childNodes.count;

}

2.每一層級節(jié)點的模型對象為item時,根據(jù)item獲取子節(jié)點模型。item為nil空時表示獲取頂級節(jié)點模型。

-(id)outlineView:(NSOutlineView *)outlineView child:(NSInteger)index ofItem:(id)item {

? ? if(!item) {

? ? ? ? return _dataModel.childNodes[index];

? ? }else {

? ? ? ? OutlineViewDataModel *model = item;

? ? ? ? return model.childNodes[index];

? ? }

}

3.節(jié)點是否可以打開/關(guān)閉。

-(BOOL)outlineView:(NSOutlineView *)outlineView isItemExpandable:(id)item {

? ? //count 大于0表示有子節(jié)點,需要允許Expandable

? ? if(!item) {

? ? ? ? return [_dataModel.childNodes count]>0 ;

? ? }else {

? ? ? ? OutlineViewDataModel *model = item;

? ? ? ? return [model.childNodes count]>0;

? ? }

}

4.設(shè)置每個數(shù)據(jù)載體對應(yīng)的具體數(shù)據(jù),根據(jù)節(jié)點模型對象item,更新節(jié)點視圖。

-(id)outlineView:(NSOutlineView *)outlineView objectValueForTableColumn:(NSTableColumn *)tableColumn byItem:(id)item {

? ? //? ? return ([item isKindOfClass:OutlineViewDataModel.class] ? [item name] : item);

? ? return item;

}

這個地方用于向自定義的cellView傳遞數(shù)據(jù),如果return item.name,則那邊接收到的“self.objectValue”就是item.name。

5.展開的節(jié)點是否自動保存

-(id)outlineView:(NSOutlineView *)outlineView itemForPersistentObject:(id)object ;

6.自定義row

-(NSTableRowView *)outlineView:(NSOutlineView *)outlineView rowViewForItem:(id)item ;

下面是NSOutlineViewDelegate的幾個方法:

1.根據(jù)tableColumn定義的cell的唯一標(biāo)示identifier,調(diào)用makeViewWithIdentifier創(chuàng)建result視圖,更新item模型中數(shù)據(jù)到result視圖元素中。

-(NSView *)outlineView:(NSOutlineView *)outlineView viewForTableColumn:(NSTableColumn *)tableColumn item:(id)item {

? ? OutlineItemCellView *cellView = [outlineView makeViewWithIdentifier:@"cellView" owner:nil];

? ? if (cellView == nil) {

? ? ? ? cellView = [[OutlineItemCellView alloc] init];

? ? ? ? cellView.identifier = @"cellView";

? ? }

? ? return cellView;

}

這里需要注意cellView一開始要復(fù)用是沒有的,所以要初始化一下。storyboard實現(xiàn)outlineView不需要這個操作,所以純代碼實現(xiàn)的時候容易忽略這點。

2.是否繪制“組行”樣式

-(BOOL)outlineView:(NSOutlineView *)outlineView isGroupItem:(id)item {

? ? if (item && [item isKindOfClass:OutlineViewDataModel.class] && ((OutlineViewDataModel *)item).childNodes) {

? ? ? ? return true;

? ? }else {

? ? ? ? return false;

? ? }

}

3.設(shè)置每一行的高度

-(CGFloat)outlineView:(NSOutlineView *)outlineView heightOfRowByItem:(id)item ;

4.獲取到選擇節(jié)點后的通知

-(void)outlineViewSelectionDidChange:(NSNotification *)notification ;

這里可以獲取點擊節(jié)點的相關(guān)信息,根據(jù)需要作出相應(yīng)處理。比如打印節(jié)點name:

NSOutlineView *treeView = notification.object;

NSInteger row = [treeView selectedRow];

OutlineViewDataModel*model = (OutlineViewDataModel*)[treeView itemAtRow:row];

NSLog(@"name = %@",model.name);

以上五步完成之后,運(yùn)行程序大概是這個樣子:

圖1

如果我們想要自定義每行的背景色以及點擊高亮色,該怎么做呢?

在OutlineItemCellView中設(shè)置背景色?那效果是這樣的...

圖2

因為箭頭那部分并不屬于cellView,cellView的下面還有一層rowView。

這個時候我們需要自定義NSTableRowView,在OutlineRowView中設(shè)置相應(yīng)樣式處理,并在ViewController中實現(xiàn) (NSTableRowView *)outlineView:(NSOutlineView *)outlineView rowViewForItem:(id)item方法,效果如下:

圖3
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容