一、簡單介紹
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,可以參考