zoukankan      html  css  js  c++  java
  • PDF文件的加载及展示

    项目需要显示PDF文件,于是遍寻了网络,发现的方法以下几种:

    1.使用UIWebView加载,没啥说的,根据文件路径,网络或者本地皆可,创建一个NSURLRequest,然后用webView加载就可以了,但仅仅能显示文件,很low;

    2.使用UIDocumentInteractionController或QLPreviewController进行预览——依然可以很方便的查看PDF文档,还有些系统自带的方法和功能,但是这依旧不是我要的。

    3.使用第三方—— Reader(vfr) ,功能很强大,可配置性高,远远超出了我需要的范畴,不能更完美了。然而,就在我高高兴兴的准备把它加入项目的时候,才发现这货不能加载网络上的PDF资源--|||于是我尝试把网络文件下载到了本地,写入了沙盒cache目录,然后还是不能加载……使劲的找了一下,似乎应该写到沙盒的doc目录,于是又把文件下载到了doc目录,然后依旧不能加载%><%好吧,只好自己动手了。(有兄弟姐妹成功使用过,万望指教)

    4.自己写,当然这也是这篇文章要写的,功能包含:获取网络/本地PDF文件并显示,可以实现放大或缩小显示的效果。

    以下上货:

    项目思路(这很重要,只抄代码自然是能实现功能的,但是……):

    第一步,自然是获取pdf资源。Bundle中的资源就不说了,如果你的PDF文件都是存在于Bundle中的,那么使用 Reader(vfr) 是最好的了,我们这里只说网络和本地资源(好吧,本地资源和网络资源的区别很简单的说就在于他们的url地址不同,所以,我们只说网络资源吧,本地资源,对应替换url地址就好了)

    下方的方法会通过一个url字符串,返回一个CGPDFDocumentRef格式的数据,你可能看到这不是一个OC方法的写法,是的,它不是。

    CGPDFDocumentRef   test(NSString*urlString) {
    NSURL*url = [NSURLURLWithString:urlString];//将传入的字符串转化为一个NSURL地址
    CFURLRefrefURL = (__bridge_retainedCFURLRef)url;//将的到的NSURL转化为CFURLRefrefURL备用
    CGPDFDocumentRefdocument =CGPDFDocumentCreateWithURL(refURL);//通过CFURLRefrefURL获取文件内容
    CFRelease(refURL);//过河拆桥,释放使用完毕的CFURLRefrefURL,这个东西并不接受自动内存管理,所以要手动释放
    if(document) {
    return  document;//返回获取到的数据
    }else{
    return   NULL; //如果没获取到数据,则返回NULL,当然,你可以在这里添加一些打印日志,方便你发现问题
    }
    }
    

    第二步,将获取到的数据显示出来,好吧,这里就不是一句话能搞定的了,我们需要细说。

    首先,我们获取到的PDF资源十有八九不仅仅是一页,而是很多页,所以肯定不可能在同一个视图上显示。那么我们就需要单独的获取到PDF资源数据中某一页的数据,别慌,系统有专门的函数;然后我们大概还需要知道这个PDF资源一共有多少页,别慌,这个系统也有专门的函数,我们会在用到的时候说明。

    其次,获取到某一页的数据后,我们还要把它展示到一个view上面,最后很多个view 的集合就是我们需要展示的所有东西了。

    所以,我们需要自定义一个view,然后传入我们通过上面方法已经获取到的CGPDFDocumentRef数据和需要显示的页数,让这个view来展示对应页数的PDF文件内容。(为什么需要一个view,因为这里会用到 Quartz 2D绘图,需要重写view的- (void)drawRect:(CGRect)rect方法来实现PDF文件内容的绘制)

    那么下一步自然是新建一个view,继承自UIView,这里我取名为RiderPDFView,以下为.h文件内容:

    #import <UIKit/UIKit.h>
    @interface  RiderPDFView :UIView
    //写一个方法,通过Frame、已经获取到的CGPDFDocumentRef文件和需要显示的PDF文件的页码,来创建一个显示PDF文件内容的视图
    - (instancetype)initWithFrame:(CGRect)frame documentRef:(CGPDFDocumentRef)docRef andPageNum:(int)page;
    @end
    

    然后是自定义的视图中.m文件的内容

    #import "RiderPDFView.h"
    @interface  RiderPDFView() {
    CGPDFDocumentRef  documentRef;//用它来记录传递进来的PDF资源数据
    int  pageNum;//记录需要显示页码
    }
    @end
    @implementation  RiderPDFView
    //这个方法就不多说了……
    - (instancetype)initWithFrame:(CGRect)frame documentRef:(CGPDFDocumentRef)docRef andPageNum:(int)page {
    self= [superinitWithFrame:frame];
    documentRef= docRef;
    pageNum= page;
    self.backgroundColor= [UIColorwhiteColor];
    returnself;
    }
    //重写- (void)drawRect:(CGRect)rect方法
    - (void)drawRect:(CGRect)rect {
    [selfdrawPDFIncontext:UIGraphicsGetCurrentContext()];//将当前的上下文环境传递到方法中,用于绘图
    }
    //- (void)drawRect:(CGRect)rect具体的内容
    - (void)drawPDFIncontext:(CGContextRef)context {
    CGContextTranslateCTM(context,0.0,self.frame.size.height);
    CGContextScaleCTM(context,1.0, -1.0);
    //上面两句是对环境做一个仿射变换,如果不执行上面两句那么绘制出来的PDF文件会呈倒置效果,第二句的作用是使图形呈正立显示,第一句是调整图形的位置,如不执行绘制的图形会不在视图可见范围内
    CGPDFPageRef  pageRef =CGPDFDocumentGetPage(documentRef,pageNum);//获取需要绘制的页码的数据。两个参数,第一个数传递进来的PDF资源数据,第二个是传递进来的需要显示的页码
    CGContextSaveGState(context);//记录当前绘制环境,防止多次绘画
    CGAffineTransform  pdfTransForm =CGPDFPageGetDrawingTransform(pageRef,kCGPDFCropBox,self.bounds,0,true);//创建一个仿射变换的参数给函数。第一个参数是对应页数据;第二个参数是个枚举值,我每个都试了一下,貌似没什么区别……但是网上看的资料都用的我当前这个,所以就用这个了;第三个参数,是图形绘制的区域,我设置的是当前视图整个区域,如果有需要,自然是可以修改的;第四个是旋转的度数,这里不需要旋转了,所以设置为0;第5个,传递true,会保持长宽比
    CGContextConcatCTM(context, pdfTransForm);//把创建的仿射变换参数和上下文环境联系起来
    CGContextDrawPDFPage(context, pageRef);//把得到的指定页的PDF数据绘制到视图上
    CGContextRestoreGState(context);//恢复图形状态
    }
    

    以上就是自定义的view中所有需要的东西,这里我们已经完成了PDF文件的绘制。接下来就是如何更好的展示得到的视图了。

    因为得到的PDF文件可能字体很小,特别是在iPhone上面,所以你大概必不可少的需要给他添加一个放大、缩小的功能,不然直接用webVie加载不就好了,干嘛还做这么多事情。

    说到放大缩小,我第一时间想到的就是用UISCrollView来做,用它可比自定义捏合手势方便多了。

    我首先用了UISCrollView嵌套UISCrollView的方法,一个UISCrollView中嵌套三个UISCrollView,目的倒是达到了,但是代码量和逻辑处理都太多,而且就在做成功的那一刻,我想起了,还有个东西叫UIColectionView……于是果断弃暗投明,使用UICollectionView重做了一次,内存占用减少了1/2,所以我们这里使用UICollectionView来完成功能。你基本没用过UICollectionView?别慌,简单的要死。

    为了达成我们放大缩小的功能,我们需要自定义一个UICollectionViewCell,那么我们新建一个类,继承自UICollectionViewCell,这里我命名为CollectionViewCell,以下是它.h文件中的内容:

    #import <UIKit/UIKit.h>
    @class  CollectionViewCell;
    @protocol  collectionCellDelegate
    @optional
    - (void)collectioncellTaped:(CollectionViewCell*)cell;
    @end
    //上面是一个代理协议,某个CollectionViewCell被单击时候的回调,你可能是需要的,也可能不需要
    @interface  CollectionViewCell :UICollectionViewCell
    @property(nonatomic,strong) UIScrollView *contentScrollView; //用于实现缩放功能的UISCrollView
    @property(nonatomic,strong) UIView *showView;//这个就是现实PDF文件内容的视图
    @property(nonatomic,weak)id <collectionCellDelegate> cellTapDelegate;//代理
    @end
    

    然后是它.m文件中的内容

    #import "CollectionViewCell.h"
    #import "RiderPDFView.h"
    @interface CollectionViewCell()<UIScrollViewDelegate>//遵守UISCrollViewDelegate协议,这样才能实现缩放
    @end
    @implementation CollectionViewCell
    //重写init方法
    - (instancetype)initWithFrame:(CGRect)frame {
    if(self= [superinitWithFrame:frame]) {
    _contentScrollView= [[UIScrollView alloc]initWithFrame:self.bounds];//初始化_contentScrollView
    _contentScrollView.contentSize= frame.size;//设置_contentScrollView的内容尺寸
    _contentScrollView.minimumZoomScale=0.5;//设置最小缩放比例
    _contentScrollView.maximumZoomScale=2.5;//设置最大的缩放比例
    _contentScrollView.delegate=self;//设置代理
    [self.contentView addSubview:_contentScrollView];//将_contentScrollView添加到CollectionViewCell中
    UITapGestureRecognizer *tapGes = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(cellClicked)];//创建手势
    [self addGestureRecognizer: tapGes];//添加手势到CollectionViewCell上
    }
    returnself;
    }
    //这是scrollView的代理方法,实现后才能通过scrollView实现缩放
    - (UIView*)viewForZoomingInScrollView:(UIScrollView*)scrollView {
    for(UIView*view in scrollView.subviews) {
    if([view isKindOfClass:[RiderPDFView class]]) {
    return view;//返回需要被缩放的视图
    }
    }
    returnnil;
    }
    //重写set方法
    - (void)setShowView:(UIView*)showView {
    for(UIView*tempView in _contentScrollView.subviews) {
    [tempView removeFromSuperview];//移除_contentScrollView中的所有视图
    }
    _showView= showView;赋值
    [_contentScrollView addSubview:showView];//将需要显示的视图添加到_contentScrollView上
    }
    //tap事件
    - (void)cellClicked {
    if([self.cellTapDelegaterespondsToSelector:@selector(collectioncellTaped:)]) {
    [self.cellTapDelegatecollectioncellTaped:self];
    }
    }
    

    以上已完成了所有的准备工作,接下来就是在一个视图控制器中完整的展示获得的PDF文件了,下面是一个ViewController.m中的内容:

    #import "ViewController.h"
    #import "CollectionViewCell.h"//导入自定义的CollectionViewCell
    #import "RiderPDFView.h"//导入展示PDF文件内容的View
    @interface ViewController()<UICollectionViewDelegate,UICollectionViewDataSource,UICollectionViewDelegateFlowLayout,UIScrollViewDelegate,collectionCellDelegate>//遵守协议
    {
    UICollectionView *testCollectionView; //展示用的CollectionView
    CGPDFDocumentRef _docRef; 需要获取的PDF资源文件
    }
    @property(nonatomic,strong)NSMutableArray*dataArray;//存数据的数组
    @property(nonatomic,assign)int totalPage;//一共有多少页
    @end
    @implementationViewController
    - (void)viewDidLoad {
    [superviewDidLoad];
    _docRef=test(@"http://teaching.csse.uwa.edu.au/units/CITS4401/practicals/James1_files/SPMP1.pdf");//通过test函数获取PDF文件资源,test函数的实现为我们最上面的方法,当然下面又写了一遍
    [self getDataArrayValue];//获取需要展示的数据
    UICollectionViewFlowLayout*layout = [[UICollectionViewFlowLayout alloc]init];//UICollectionView需要在创建的时候传入一个布局参数,故在创建它之前,先创建一个布局,这里使用系统的布局就好
    layout.itemSize=self.view.frame.size;//设置CollectionView中每个item及集合视图中每单个元素的大小,我们每个视图使用一页来显示,所以设置为当前视图的大小
    [layout setScrollDirection:UICollectionViewScrollDirectionHorizontal];//设置滑动方向为水平方向,也可以设置为竖直方向
    layout.minimumLineSpacing=0;//设置item之间最下行距
    layout.minimumInteritemSpacing=0;//设置item之间最小间距
    testCollectionView= [[UICollectionView alloc]initWithFrame:self.view.bounds collectionViewLayout:layout];//创建一个集合视图,设置其大小为当前view的大小,布局为上面我们创建的布局
    testCollectionView.pagingEnabled=YES;//设置集合视图一页一页的翻动
    [testCollectionView registerClass:[CollectionViewCell class]forCellWithReuseIdentifier:@"test"];//为集合视图注册单元格
    testCollectionView.delegate=self;//设置代理
    testCollectionView.dataSource=self;//设置数据源
    [self.view addSubview:testCollectionView];//将集合视图添加到当前视图上
    }
    - (void)didReceiveMemoryWarning {
    [superdidReceiveMemoryWarning];
    }
    //通过地址字符串获取PDF资源
    CGPDFDocumentReftest(NSString*fileName) {
    NSURL*url = [NSURLURLWithString:fileName];
    CFURLRefrefURL = (__bridge_retainedCFURLRef)url;
    CGPDFDocumentRefdocument =CGPDFDocumentCreateWithURL(refURL);
    CFRelease(refURL);
    if(document) {
    returndocument;
    }else{
    returnNULL;
    }
    }
    //获取所有需要显示的PDF页面
    - (void)getDataArrayValue {
    size_t totalPages =CGPDFDocumentGetNumberOfPages(_docRef);//获取总页数
    self.totalPage= (int)totalPages;//给全局变量赋值
    NSMutableArray*arr = [NSMutableArray new];
    //通过循环创建需要显示的PDF页面,并把这些页面添加到数组中
    for(inti =1; i <= totalPages; i++) {
    RiderPDFView *view = [[RiderPDFView alloc]initWithFrame:CGRectMake(0,0,self.view.frame.size.width,self.view.frame.size.height) documentRef: _docRef andPageNum:i];
    [arr addObject:view];
    }
    self.dataArray= arr;//给数据数组赋值
    }
    //返回集合视图共有几个分区
    - (NSInteger)numberOfSectionsInCollectionView:(UICollectionView*)collectionView {
    return1;
    }
    //返回集合视图中一共有多少个元素——自然是总页数
    - (NSInteger)collectionView:(UICollectionView*)collectionView numberOfItemsInSection:(NSInteger)section {
    return self.totalPage;
    }
    //复用、返回cell
    - (UICollectionViewCell*)collectionView:(UICollectionView*)collectionView cellForItemAtIndexPath:(NSIndexPath*)indexPath {
    CollectionViewCell*cell = [collectionViewdequeueReusableCellWithReuseIdentifier:@"test"forIndexPath:indexPath];
    cell.cellTapDelegate=self;//设置tap事件代理
    cell.showView=self.dataArray[indexPath.row];//赋值,设置每个item中显示的内容
    returncell;
    }
    //当集合视图的item被点击后触发的事件,根据个人需求写
    - (void)collectioncellTaped:(CollectionViewCell*)cell {
    NSLog(@"我点了咋的?");
    }
    //集合视图继承自scrollView,所以可以用scrollView 的代理事件,这里的功能是当某个item不在当前视图中显示的时候,将它的缩放比例还原
    - (void)scrollViewDidEndDecelerating:(UIScrollView*)scrollView {
    for(UIView *view in testCollectionView.subviews) {
    if([view isKindOfClass:[CollectionViewCell class]]) {
    CollectionViewCell*cell = (CollectionViewCell*)view;
    [cell.contentScrollViewsetZoomScale:1.0];
    }
    }
    }
    @end
    

    然后……然后就没有然后了,功能实现了,如果还需要其它功能,可以再此基础上添加

  • 相关阅读:
    javascript Date format(js日期格式化)
    给上传文件的input控件“美容”
    判断json数据是否为空
    C#实现SQL数据库备份与恢复
    jquery读取html5的data-属性
    PowerDesigner使用教程
    PowerDesigner使用教程|使用方法
    [转][南京米联ZYNQ深入浅出]第二季更新完毕课程共计16节课
    DefWindowProc是一个会产生消息的函数
    BeginPaint 和 GetDC 的一个区别
  • 原文地址:https://www.cnblogs.com/xiaoxiaoyublogs/p/5969924.html
Copyright © 2011-2022 走看看