《iOS 6高级开发手册（第4版）》——2.5节秘诀：Quick Look预览控制器

本节书摘来自异步社区《iOS 6高级开发手册（第4版）》一书中的第2章，第2.5节秘诀：Quick Look预览控制器，作者 【美】Erica Sadun，更多章节内容可以访问云栖社区“异步社区”公众号查看

2.5　秘诀：Quick Look预览控制器
iOS 6高级开发手册（第4版）
Quick Look预览控制器类允许用户预览许多文档类型。这个控制器支持文本、图像、PDF、RTF、iWork文件、Microsoft Office文档（Office 97及更高版本，包括doc、ppt、xls等）和逗号分隔的值（comma-separated value，csv）文件。你提供一种受支持的文件类型，Quick Look控制器将为用户显示它。集成的系统提供的活动视图控制器有助于共享预览的文档，如图2-6所示。

Quick Look控制器以模态方式展示，并且显示用户点按了动作按钮之后的屏幕。Quick Look控制器可以处理广泛的文档类型，使用户能够先查看文件内容，然后再决定要应用于它们的动作。大多数Quick Look类型都支持Mail（邮件）和Print（打印），其中许多类型支持Copy（复制），图像文件甚至提供了更多的选项

可以推送或展示预览控制器。控制器能够适应这两种情形，与导航栈和模态表示协同工作。秘诀2-5演示了两种方法。

2.5.1 实现Quick Look
Quick Look支持需要几个简单的步骤。

(1) 在主控制器类中声明QLPreviewControllerDataSource协议。

(2) 实现numberOfPreviewItemsInPreviewController:和previewController:previewItemAtIndex:数据源方法。其中第一个方法返回要预览的项目计数；第二个方法则返回索引所引用的预览项目。

(3) 预览项目必须遵守QLPreviewItem协议，该协议包含两个必需的属性：预览标题和项目URL。秘诀2-5创建了一个符合要求的QuickItem类，该类实现了一个绝对最低限度的方法，用于支持数据源。

在满足了所有这些要求之后，代码将准备好创建一个新的预览控制器，设置它的数据源，然后展示或推送它。

秘诀2-5 Quick Look

@interface QuickItem : NSObject <QLPreviewItem>
@property (nonatomic, strong) NSString *path;
@property (readonly) NSString *previewItemTitle;
@property (readonly) NSURL *previewItemURL;
@end

@implementation QuickItem

// Title for preview item
- (NSString *) previewItemTitle
{
    return [_path lastPathComponent];
}

// URL for preview item
- (NSURL *) previewItemURL
{
    return [NSURL fileURLWithPath:_path];
}
@end

#define FILE_PATH [NSHomeDirectory() \
    stringByAppendingPathComponent:@"Documents/PDFSample.pdf"]

@interface TestBedViewController : UIViewController
<QLPreviewControllerDataSource>
@end

@implementation TestBedViewController
- (NSInteger) numberOfPreviewItemsInPreviewController:
    (QLPreviewController *) controller
{
    return 1;
}
- (id <QLPreviewItem>) previewController:
    (QLPreviewController *) controller
previewItemAtIndex: (NSInteger) index;
{
    QuickItem *item = [[QuickItem alloc] init];
    item.path = FILE_PATH;
    return item;
}
// Push onto navigation stack
- (void) push
{
    QLPreviewController *controller =
        [[QLPreviewController alloc] init];
    controller.dataSource = self;
        [self.navigationController
    pushViewController:controller animated:YES];
}

// Use modal presentation
- (void) present
{
    QLPreviewController *controller =
        [[QLPreviewController alloc] init];
    controller.dataSource = self;
    [self presentViewController:controller
        animated:YES completion:nil];
}

- (void) loadView
{
    self.view.backgroundColor = [UIColor whiteColor];

    self.navigationItem.rightBarButtonItem =
        BARBUTTON(@"Push", @selector(push));
    self.navigationItem.leftBarButtonItem =
        BARBUTTON(@"Present", @selector(present));
}
@end