关闭

2016.08.29 QLPreviewController相关

132人阅读 评论(0) 收藏 举报

大老师语录

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

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


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刷新当前数据源,否则因为单例的关系,默认会展示上次的数据源。


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

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:398次
    • 积分:41
    • 等级:
    • 排名:千里之外
    • 原创:3篇
    • 转载:0篇
    • 译文:1篇
    • 评论:0条
    文章存档