2016.08.29 QLPreviewController相关

大老师语录

“人是不会改变的。若真要改变的话，那只有一种方法。”

“只有反复经历惨痛的遭遇，在内心刻下无法抹去的伤痕，通过伤痛产生的回避本能，条件反射地改变自己的行为。”

QLPreviewController是苹果系统自带的一个可供预览文件的控件，在工程中做邮件附件预览时用到，在这简单总结下用法。

首先要介绍的是QLPreviewItem，可以理解为是QLPreviewController展示的内容item，苹果对其进行了封装，我们看到的是扩充的QLPreviewItem协议。

QLPreviewItem内主要有两个属性，分别是：

@property(readonly, nonnull, nonatomic) NSURL * previewItemURL;

和

@property(readonly, nullable, nonatomic) NSString * previewItemTitle;

值得强调的是，previewItemURL是@required属性，previewItemTitle是@optional，即要展示对应内容的previewItemURL必需有值。

而且官方给previewItemURL的注释是：

 * @discussion The URL must be a file URL. 

最开始使用的时候给了个非本地文件URL，导致崩溃，这也是个坑需要注意，默认展示的仅能是本地文件路径对应的URL，如果URL对应的文件路径不存在，则展示一个空页面。

回到QLPreviewController，QLPreviewController主要有以下几个属性：

@property NSInteger currentPreviewItemIndex;<span style="font-family: Arial, Helvetica, sans-serif;">	</span>

@property(readonly, nullable) id <QLPreviewItem> currentPreviewItem;

currentPreviewItemIndex对应当前展示内容第几页，currentPreviewItem对应当前展示的QLPreviewItem。

QLPreviewController对应的主要方法有：

- (void)reloadData;

- (void)refreshCurrentPreviewItem;

可以理解为和tableview的reloadData和reloadSection对应，根据数据源刷新展示的内容。

而同样对应的，QLPreviewController也有自己的dataSource和delegate：

@property(weak, nullable) id <QLPreviewControllerDataSource> dataSource;

@property(weak, nullable) id <QLPreviewControllerDelegate> delegate;

dataSource仅有两个方法，而且都是@required：

- (NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController *)controller;

- (id <QLPreviewItem>)previewController:(QLPreviewController *)controller previewItemAtIndex:(NSInteger)index;

delegate更多的主要是对controller展示和跳转上的控制，不过多介绍。

使用上个人是将QLPreviewController封装成单例使用，展示内容时传入对应的文件路径和要展示的controller：

- (void)showAttachmentWithPathAndViewController:(NSString *)attachmentPath
                                 viewController:(UIViewController *)viewController {
    self.attachmentPath = attachmentPath;
    [self.previewController refreshCurrentPreviewItem];
    [viewController presentViewController:self.previewController
                                 animated:YES
                               completion:nil];
}

其中需要注意的是，在展示QLPreviewController之前，需要调reloadData或者refreshCurrentPreviewItem刷新当前数据源，否则因为单例的关系，默认会展示上次的数据源。

以上，总结得并不完全，有问题欢迎指正。