iOS開發中UIPopoverController的使用詳解_IOS

一、簡單介紹

1.什麼是UIPopoverController

是iPad開發中常見的一種控制器（在iPhone上不允許使用）

跟其他控制器不一樣的是，它直接繼承自NSObject，並非繼承自UIViewController

它只佔用部分螢幕空間來呈現資訊，而且顯示在螢幕的最前面

2.使用步驟

要想顯示一個UIPopoverController，需要經過下列步驟

（1）設定內容控制器

　　由於UIPopoverController直接繼承自NSObject，不具備可視化的能力。因此UIPopoverController上面的內容必須由另外一個繼承自UIViewController的控制器來提供，這個控制器稱為“內容控制器”

 （2）設定內容的尺寸

　　顯示出來佔據多少螢幕空間

（3）顯示，即從哪個地方冒出來

 

二、具體的步驟

程式碼範例：

建立一個ipad項目，編寫如下代碼：　

建立一個繼承自UITableView的控制器，讓其作為popoverController的內容控制器。

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

實現效果如下圖：

說明：在storyboard中添加了導航控制器，並添加了兩個按鈕。

三、常見報錯

在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);
   
}

效果：

關於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參數如下：

相關代碼：

複製代碼 代碼如下:

//
//  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

介面效果：（部分）

關於frame座標計算的圖示：

下面兩者是等價的：

即如果想讓箭頭指向某一個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，可以參考