iOS开发中UIPopoverController的使用详解

时间:2022-08-24 10:13:17

一、简单介绍

1.什么是uipopovercontroller

是ipad开发中常见的一种控制器(在iphone上不允许使用)

跟其他控制器不一样的是,它直接继承自nsobject,并非继承自uiviewcontroller

它只占用部分屏幕空间来呈现信息,而且显示在屏幕的最前面

iOS开发中UIPopoverController的使用详解

2.使用步骤

要想显示一个uipopovercontroller,需要经过下列步骤

(1)设置内容控制器

  由于uipopovercontroller直接继承自nsobject,不具备可视化的能力。因此uipopovercontroller上面的内容必须由另外一个继承自uiviewcontroller的控制器来提供,这个控制器称为“内容控制器”

 (2)设置内容的尺寸

  显示出来占据多少屏幕空间

(3)显示,即从哪个地方冒出来

 

二、具体的步骤

代码示例:

新建一个ipad项目,编写如下代码: 

新建一个继承自uitableview的控制器,让其作为popovercontroller的内容控制器。

iOS开发中UIPopoverController的使用详解

yymenuviewcontroller.m文件

复制代码 代码如下:


//
//  yymenuviewcontroller.m
//  01-popovercontroller简单介绍
//
//  created by apple on 14-8-17.
//  copyright (c) 2014年 yangyong. all rights reserved.
//

 

#import "yymenuviewcontroller.h"

@interface yymenuviewcontroller ()
@property(nonatomic,strong)nsarray *menus;
@end

 

复制代码 代码如下:


@implementation yymenuviewcontroller

 

-(nsarray *)menus
{
    if (_menus==nil) {
        _menus=@[@"列表1",@"列表2",@"列表3",@"列表4"];
    }
 return _menus;
}
- (void)viewdidload
{
    [super viewdidload];
}

-(nsinteger)numberofsectionsintableview:(uitableview *)tableview
{
    return 1;
}
-(nsinteger)tableview:(uitableview *)tableview numberofrowsinsection:(nsinteger)section
{
    return self.menus.count;
}
-(uitableviewcell *)tableview:(uitableview *)tableview cellforrowatindexpath:(nsindexpath *)indexpath
{
    static nsstring *id=@"id";
    uitableviewcell *cell=[tableview dequeuereusablecellwithidentifier:id];
    if (cell==nil) {
        cell=[[uitableviewcell alloc]initwithstyle:uitableviewcellstyledefault reuseidentifier:id];
    }
   
    cell.textlabel.text=self.menus[indexpath.row];
    return cell;
}

@end

 

复制代码 代码如下:


yyviewcontroller.m文件
//
//  yyviewcontroller.m
//  01-popovercontroller简单介绍
//
//  created by apple on 14-8-17.
//  copyright (c) 2014年 yangyong. all rights reserved.
//

 

#import "yyviewcontroller.h"
#import "yymenuviewcontroller.h"

@interface yyviewcontroller ()
@property(nonatomic,strong)uipopovercontroller *popover;
@end

@implementation yyviewcontroller

- (void)viewdidload
{
    [super viewdidload];
}

-(void)touchesbegan:(nsset *)touches withevent:(uievent *)event
{
    //1.新建一个内容控制器
    yymenuviewcontroller *menuvc=[[yymenuviewcontroller alloc]init];
   
    //2.新建一个popovercontroller,并设置其内容控制器
    self.popover=[[uipopovercontroller alloc]initwithcontentviewcontroller:menuvc];
   
    //3.设置尺寸
    self.popover.popovercontentsize=cgsizemake(300, 200);
   
    //4.显示
    [self.popover presentpopoverfrombarbuttonitem:self.navigationitem.leftbarbuttonitem permittedarrowdirections:uipopoverarrowdirectionany animated:yes];
}
@end


实现效果如下图:

 

iOS开发中UIPopoverController的使用详解

说明:在storyboard中添加了导航控制器,并添加了两个按钮。

iOS开发中UIPopoverController的使用详解

三、常见报错

在popover的使用过程中,经常会遇到这个错误

复制代码 代码如下:

  -[uipopovercontroller dealloc] reached while popover is still visible.


错误的大体意思是:popover在仍旧可见的时候被销毁了(调用了dealloc)

 

从错误可以得出的结论

  当popover仍旧可见的时候,不准销毁popover对象

  在销毁popover对象之前,一定先让popover消失(不可见)  

如:在上述代码中,如果不适用全局变量popover,那么将会出现上面的错误。

四、设置尺寸
提示:不建议,像下面这样吧popover的宽度和高度写死。

复制代码 代码如下:

//1.新建一个内容控制器
    yymenuviewcontroller *menuvc=[[yymenuviewcontroller alloc]init];
   
    //2.新建一个popovercontroller,并设置其内容控制器
    self.popover=[[uipopovercontroller alloc]initwithcontentviewcontroller:menuvc];
   
    //3.设置尺寸
    self.popover.popovercontentsize=cgsizemake(300, 200);
   
    //4.显示
    [self.popover presentpopoverfrombarbuttonitem:self.navigationitem.leftbarbuttonitem permittedarrowdirections:uipopoverarrowdirectionany animated:yes];


更好的设计是:popover的尺寸应该由内部控制器的内容所决定。

 

内容控制器可以自行设置自己在popover中显示的尺寸,其中有两种方法:

(1)在ios 7之前  @property (nonatomic,readwrite) cgsize contentsizeforviewinpopover;

(2)从ios 7开始  @property (nonatomic) cgsize preferredcontentsize;

  以上属性都是uiviewcontroller的

复制代码 代码如下:

-(nsarray *)menus
{
    if (_menus==nil) {
        _menus=@[@"列表1",@"列表2",@"列表3",@"列表4",@"列表4",@"列表4",@"列表4",@"列表4",@"列表4",@"列表4",@"列表1",@"列表2",@"列表1",@"列表2"];
    }
 return _menus;
}
- (void)viewdidload
{
    [super viewdidload];
   
    //设置控制器将来在popover中的尺寸
    cgfloat maxh=min(480,self.menus.count*44);
    //ios7以前的设置
//    self.contentsizeforviewinpopover=cgsizemake(150, maxh);
    //ios7以后
    self.preferredcontentsize=cgsizemake(150, maxh);
   
}


效果:

 

iOS开发中UIPopoverController的使用详解

关于min(a,b)的说明,最终的大小取决于b,但是最大不能超过a,如果超过a那么值就等于a。

 

五、设置显示的位置

1.设置显示的位置有2种方法

(1)围绕着一个uibarbuttonitem显示(箭头指定那个uibarbuttonitem)

复制代码 代码如下:

- (void)presentpopoverfrombarbuttonitem:(uibarbuttonitem *)item permittedarrowdirections:(uipopoverarrowdirection)arrowdirections animated:(bool)animated;


item :围绕着哪个uibarbuttonitem显示

 

arrowdirections :箭头的方向

animated :是否通过动画显示出来

 

(2)围绕着某一块特定区域显示(箭头指定那块特定区域)

复制代码 代码如下:

- (void)presentpopoverfromrect:(cgrect)rect inview:(uiview *)view permittedarrowdirections:(uipopoverarrowdirection)arrowdirections animated:(bool)animated;


rect :指定箭头所指区域的矩形框范围(位置和尺寸),以view的左上角为坐标原点

 

view :rect参数是以view的左上角为坐标原点(0,0)

arrowdirections :箭头的方向

animated :是否通过动画显示出来

rect和view参数如下:

iOS开发中UIPopoverController的使用详解

相关代码:

复制代码 代码如下:


//
//  yyviewcontroller.m
//  01-popovercontroller简单介绍
//
//  created by apple on 14-8-17.
//  copyright (c) 2014年 yangyong. all rights reserved.
//

 

#import "yyviewcontroller.h"
#import "yymenuviewcontroller.h"

@interface yyviewcontroller ()<uipopovercontrollerdelegate>
@property(nonatomic,strong)uipopovercontroller *popover;
- (ibaction)buttonclick:(uibutton *)sender;
@end

 

复制代码 代码如下:


@implementation yyviewcontroller

 

- (void)viewdidload
{
    [super viewdidload];
}

-(void)showpopoverfromitem
{
    //1.新建一个内容控制器
    yymenuviewcontroller *menuvc=[[yymenuviewcontroller alloc]init];
   
    //2.新建一个popovercontroller,并设置其内容控制器
    self.popover=[[uipopovercontroller alloc]initwithcontentviewcontroller:menuvc];
   
    //3.设置尺寸
    //    self.popover.popovercontentsize=cgsizemake(300, 200);
   
    //4.显示
    [self.popover presentpopoverfrombarbuttonitem:self.navigationitem.leftbarbuttonitem permittedarrowdirections:uipopoverarrowdirectionany animated:yes];
   
    //5.设置代理
    self.popover.delegate=self;
}
-(void)touchesbegan:(nsset *)touches withevent:(uievent *)event
{
   
}

#pragma mark-代理方法
//popovercontroller消失的时候调用
-(void)popovercontrollerdiddismisspopover:(uipopovercontroller *)popovercontroller
{
}
//popovercontroller的位置改变的时候调用(如竖屏变横屏)
-(void)popovercontroller:(uipopovercontroller *)popovercontroller willrepositionpopovertorect:(inout cgrect *)rect inview:(inout uiview *__autoreleasing *)view
{
   
}
//用来决定用户点击了蒙版后,popovercontroller是否可以dismiss,返回yes代表可以,返回no代表不可以
-(bool)popovercontrollershoulddismisspopover:(uipopovercontroller *)popovercontroller
{
    return no;
}
- (ibaction)buttonclick:(uibutton *)sender {
   
    //1.新建一个popovercontroller并设置其内容控制器
    yymenuviewcontroller *menuvc=[[yymenuviewcontroller alloc]init];
    self.popover=[[uipopovercontroller alloc]initwithcontentviewcontroller:menuvc];
   
    //2.显示
    //2.1第一种方式
//    [self.popover presentpopoverfrombarbuttonitem:<#(uibarbuttonitem *)#> permittedarrowdirections:<#(uipopoverarrowdirection)#> animated:<#(bool)#>];
    //2.2第二种方式
    [self.popover presentpopoverfromrect:sender.bounds inview:sender permittedarrowdirections:uipopoverarrowdirectionany animated:yes];
    //说明:popover会指向sender.bounds这一块矩形框,这块矩形框以sender的左上角为坐标原点
    //注意:注意sender.frame和sender.bounds的区别
   
}
@end


界面效果:(部分)

 

iOS开发中UIPopoverController的使用详解

关于frame坐标计算的图示:

iOS开发中UIPopoverController的使用详解

下面两者是等价的:

iOS开发中UIPopoverController的使用详解

即如果想让箭头指向某一个uiview的做法有2种做法,比如指向一个button

方法1

复制代码 代码如下:

  [popover presentpopoverfromrect:button.bounds inview:button permittedarrowdirections:uipopoverarrowdirectiondown animated:yes];


方法2

复制代码 代码如下:

  [popover presentpopoverfromrect:button.frame inview:button.superview permittedarrowdirections:uipopoverarrowdirectiondown animated:yes];


六、设置代理

 

代理对象

复制代码 代码如下:

  @property (nonatomic, assign) id <uipopovercontrollerdelegate> delegate;


是否可见

复制代码 代码如下:

  @property (nonatomic, readonly, getter=ispopovervisible) bool popovervisible;


箭头方向

复制代码 代码如下:

  @property (nonatomic, readonly) uipopoverarrowdirection popoverarrowdirection;


关闭popover(让popover消失)

复制代码 代码如下:

  - (void)dismisspopoveranimated:(bool)animated;


代码说明:

复制代码 代码如下:


.......
  //5.设置代理
    self.popover.delegate=self;
}

 

#pragma mark-代理方法
//popovercontroller消失的时候调用
-(void)popovercontrollerdiddismisspopover:(uipopovercontroller *)popovercontroller
{
}
//popovercontroller的位置改变的时候调用(如竖屏变横屏)
-(void)popovercontroller:(uipopovercontroller *)popovercontroller willrepositionpopovertorect:(inout cgrect *)rect inview:(inout uiview *__autoreleasing *)view
{
   
}
//用来决定用户点击了蒙版后,popovercontroller是否可以dismiss,返回yes代表可以,返回no代表不可以
-(bool)popovercontrollershoulddismisspopover:(uipopovercontroller *)popovercontroller
{
    return no;
}


七、防止点击uipopovercontroller区域外消失

 

默认情况下

只要uipopovercontroller显示在屏幕上,uipopovercontroller背后的所有控件默认是不能跟用户进行正常交互的

点击uipopovercontroller区域外的控件,uipopovercontroller默认会消失

 

要想点击uipopovercontroller区域外的控件时不让uipopovercontroller消失,解决办法是设置passthroughviews属性

复制代码 代码如下:

@property (nonatomic, copy) nsarray *passthroughviews;


这个属性是设置当uipopovercontroller显示出来时,哪些控件可以继续跟用户进行正常交互。这样的话,点击区域外的控件就不会让uipopovercontroller消失了

 

代码示例:

复制代码 代码如下:

- (ibaction)buttonclick:(uibutton *)sender {
   
    //1.新建一个popovercontroller并设置其内容控制器
    yymenuviewcontroller *menuvc=[[yymenuviewcontroller alloc]init];
    self.popover=[[uipopovercontroller alloc]initwithcontentviewcontroller:menuvc];
   
    //设置过滤掉一些控件
    self.popover.passthroughviews=@[self.switchview];
   
    //2.显示
    //2.1第一种方式
//    [self.popover presentpopoverfrombarbuttonitem:<#(uibarbuttonitem *)#> permittedarrowdirections:<#(uipopoverarrowdirection)#> animated:<#(bool)#>];
    //2.2第二种方式
//    [self.popover presentpopoverfromrect:sender.bounds inview:sender permittedarrowdirections:uipopoverarrowdirectionany animated:yes];
    [self.popover presentpopoverfromrect:sender.frame inview:sender.superview permittedarrowdirections:uipopoverarrowdirectionany animated:yes];
    //说明:popover会指向sender.bounds这一块矩形框,这块矩形框以sender的左上角为坐标原点
    //注意:注意sender.frame和sender.bounds的区别
   
}


补充:

 

uipopovercontroller这个类是只能用在ipad中的

要想在iphone中实现popover效果,必须得自定义view,可以参考