Three20中的TTThumbViewController类的学习

做相册小程序的时候需要用到Three20库。网上的教程真心少，果然还是要看源代码……

因为本人英语水平极差，变量或者方法设置成自解释的名称也几乎看不懂，所以还是多加点注释好了。留给自己看，如果也能顺便帮到其他人就更好了。

这个文件在Thee20/src/Three20UI/Sources 文件夹下。

我是看一点往上补一点的……如果这文章真的有人看的话，不要心急哈~

涉及到的一些相关文件有：

TTImageViewController

TTPhotoView

TTThumbsTableCell

还有若干

#import "Three20UI/TTThumbsViewController.h"// UI#import "Three20UI/TTNavigator.h"#import "Three20UI/TTThumbsDataSource.h"#import "Three20UI/TTThumbsTableViewCell.h"#import "Three20UI/TTPhoto.h"#import "Three20UI/TTPhotoSource.h"#import "Three20UI/TTPhotoViewController.h"#import "Three20UI/UIViewAdditions.h"// UINavigator#import "Three20UINavigator/TTGlobalNavigatorMetrics.h"// UICommon#import "Three20UICommon/TTGlobalUICommon.h"#import "Three20UICommon/UIViewControllerAdditions.h"// Style#import "Three20Style/TTGlobalStyle.h"#import "Three20Style/TTStyleSheet.h"// Core#import "Three20Core/TTGlobalCoreLocale.h"#import "Three20Core/TTGlobalCoreRects.h"#import "Three20Core/TTCorePreprocessorMacros.h"// 相片缩略图的格子高度。过小会导致图片显示不全，过大会使图片间留很多空白。static CGFloat kThumbnailRowHeight = 79;/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////@implementation TTThumbsViewController@synthesize delegate    = _delegate;@synthesize photoSource = _photoSource;///////////////////////////////////////////////////////////////////////////////////////////////////- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];if (self) {self.statusBarStyle = UIStatusBarStyleBlackTranslucent;// 将statusBar设为黑色透明。self.navigationBarStyle = UIBarStyleBlackTranslucent;// 将导航栏设置为黑色透明self.navigationBarTintColor = nil;// 将导航栏背景色设为nilself.wantsFullScreenLayout = YES;// 全屏布局。略不懂，待研究。self.hidesBottomBarWhenPushed = YES;// 隐藏TabBar。没用过，不了解。}//1. 如果仅仅使用TTThumbsViewController的话，那么用完了要手动将状态栏导航栏等等的颜色变为原配置。//2. 为了让图片缩略图滚动的时候有那种“还没到头”的感觉，所以要把XX栏都设置成透明的。return self;}///////////////////////////////////////////////////////////////////////////////////////////////////// 起始我还不大明白delegate是什么意思⋯⋯待研究。- (id)initWithDelegate:(id<TTThumbsViewControllerDelegate>)delegate {self = [self initWithNibName:nil bundle:nil];if (self) {self.delegate = delegate;}return self;}///////////////////////////////////////////////////////////////////////////////////////////////////// 这个也不大懂。- (id)initWithQuery:(NSDictionary*)query {id<TTThumbsViewControllerDelegate> delegate = [query objectForKey:@"delegate"];if (nil != delegate) {self = [self initWithDelegate:delegate];} else {self = [self initWithNibName:nil bundle:nil];}return self;}///////////////////////////////////////////////////////////////////////////////////////////////////- (id)init {self = [self initWithNibName:nil bundle:nil];if (self) {}return self;}///////////////////////////////////////////////////////////////////////////////////////////////////- (void)dealloc {[_photoSource.delegates removeObject:self];TT_RELEASE_SAFELY(_photoSource);[super dealloc];}//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#pragma mark -#pragma mark Private///////////////////////////////////////////////////////////////////////////////////////////////////// 暂停加载缩略图// 在viewDidDisapper里面用到。// 大概涉及到TTThumbsDataSource类和TTThumbsTableViewCell类// 如果photoSource里面有照片，那么就申请新格子- (void)suspendLoadingThumbnails:(BOOL)suspended {if (_photoSource.maxPhotoIndex >= 0) {NSArray* cells = _tableView.visibleCells;for (int i = 0; i < cells.count; ++i) {TTThumbsTableViewCell* cell = [cells objectAtIndex:i];if ([cell isKindOfClass:[TTThumbsTableViewCell class]]) {[cell suspendLoading:suspended];}}}}///////////////////////////////////////////////////////////////////////////////////////////////////// 在自身的loadView里面会调用到。- (void)updateTableLayout {self.tableView.contentInset = UIEdgeInsetsMake(TTBarsHeight()+4, 0, 0, 0);self.tableView.scrollIndicatorInsets = UIEdgeInsetsMake(TTBarsHeight(), 0, 0, 0);}///////////////////////////////////////////////////////////////////////////////////////////////////// 不知道在哪用到了这个，所以也不知道干嘛用- (NSString*)URLForPhoto:(id<TTPhoto>)photo {if ([photo respondsToSelector:@selector(URLValueWithName:)]) {return [photo URLValueWithName:@"TTPhotoViewController"];} else {return nil;}}//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#pragma mark -#pragma mark UIViewController///////////////////////////////////////////////////////////////////////////////////////////////////- (void)loadView {//最上面的RowHeigt就是在这里用的。对tableView进行一些初始化操作。[super loadView];self.tableView.rowHeight = kThumbnailRowHeight;//设置行高// 设置自动调整大小。方法是在UIView里面。self.tableView.autoresizingMask =UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;// TTSTULEVAR看起来像是一个全局的设定。易于统一风格吧。self.tableView.backgroundColor = TTSTYLEVAR(backgroundColor);// 貌似是cell的分割风格。没发现none和singleLine的区别self.tableView.separatorStyle = UITableViewCellSeparatorStyleNone;[self updateTableLayout];}///////////////////////////////////////////////////////////////////////////////////////////////////- (void)viewDidAppear:(BOOL)animated {[super viewDidAppear:animated];[self suspendLoadingThumbnails:NO];}///////////////////////////////////////////////////////////////////////////////////////////////////- (void)viewDidDisappear:(BOOL)animated {[self suspendLoadingThumbnails:YES];[super viewDidDisappear:animated];}///////////////////////////////////////////////////////////////////////////////////////////////////- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation {return TTIsSupportedOrientation(interfaceOrientation);}///////////////////////////////////////////////////////////////////////////////////////////////////- (void)didRotateFromInterfaceOrientation:(UIInterfaceOrientation)fromInterfaceOrientation {[self updateTableLayout];[self.tableView reloadData];}/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#pragma mark -#pragma mark UIViewController (TTCategory)///////////////////////////////////////////////////////////////////////////////////////////////////- (BOOL)persistView:(NSMutableDictionary*)state {NSString* delegate = [[TTNavigator navigator] pathForObject:_delegate];if (delegate) {[state setObject:delegate forKey:@"delegate"];}return [super persistView:state];}///////////////////////////////////////////////////////////////////////////////////////////////////- (void)restoreView:(NSDictionary*)state {[super restoreView:state];NSString* delegate = [state objectForKey:@"delegate"];if (delegate) {self.delegate = [[TTNavigator navigator] objectForPath:delegate];}}///////////////////////////////////////////////////////////////////////////////////////////////////// 这里似乎是设置导航栏上的两个按钮// 但我还是不明白为什么右边的按钮可以在被Photo调用的时候出现，而左边的只有直接打开Thumbs的时候才有。- (void)setDelegate:(id<TTThumbsViewControllerDelegate>)delegate {_delegate = delegate;if (_delegate) {self.navigationItem.leftBarButtonItem =[[[UIBarButtonItem alloc] initWithCustomView:[[[UIView alloc] init]  autorelease]]autorelease];self.navigationItem.rightBarButtonItem =[[[UIBarButtonItem alloc] initWithTitle:TTLocalizedString(@"Done", @"")  style:UIBarButtonItemStyleBordered target:self action:@selector(removeFromSupercontroller)] autorelease];}}//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#pragma mark -#pragma mark TTModelViewController///////////////////////////////////////////////////////////////////////////////////////////////////- (void)didRefreshModel {[super didRefreshModel];self.title = _photoSource.title;}//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#pragma mark -#pragma mark TTTableViewController///////////////////////////////////////////////////////////////////////////////////////////////////// 不懂- (CGRect)rectForOverlayView {return TTRectContract(CGRectOffset([super rectForOverlayView], 0, TTBarsHeight()-_tableView.top),  0, TTBarsHeight());}//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#pragma mark -#pragma mark TTThumbsTableViewCellDelegate/////////////////////////////////////////////////////////////////////////////////////////////////////没看完。大概是这样：如果URL里有图片就显示，没有的话，就显示一张photo。目测是“找不到图片”的那张- (void)thumbsTableViewCell:(TTThumbsTableViewCell*)cell didSelectPhoto:(id<TTPhoto>)photo {[_delegate thumbsViewController:self didSelectPhoto:photo];BOOL shouldNavigate = YES;if ([_delegate respondsToSelector:@selector(thumbsViewController:shouldNavigateToPhoto:)]) {shouldNavigate = [_delegate thumbsViewController:self shouldNavigateToPhoto:photo];}if (shouldNavigate) {NSString* URL = [self URLForPhoto:photo];if (URL) {TTOpenURLFromView(URL, self.view);} else {TTPhotoViewController* controller = [self createPhotoViewController];controller.centerPhoto = photo;[self.navigationController pushViewController:controller animated:YES];}}}//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#pragma mark -#pragma mark Public///////////////////////////////////////////////////////////////////////////////////////////////////// 设置图像源。- (void)setPhotoSource:(id<TTPhotoSource>)photoSource {if (photoSource != _photoSource) {[_photoSource release];_photoSource = [photoSource retain];self.title = _photoSource.title;self.dataSource = [self createDataSource];}}///////////////////////////////////////////////////////////////////////////////////////////////////- (TTPhotoViewController*)createPhotoViewController {return [[[TTPhotoViewController alloc] init] autorelease];}///////////////////////////////////////////////////////////////////////////////////////////////////- (id<TTTableViewDataSource>)createDataSource {return [[[TTThumbsDataSource alloc] initWithPhotoSource:_photoSource delegate:self] autorelease];}@end