iPad开发 - UIPopoverController控制器

iPad简介

什么是iPad
一款苹果公司于2010年发布的平板电脑
定位介于苹果的智能手机iPhone和笔记本电脑产品之间
跟iPhone一样，搭载的是iOS操作系统

iPad的市场情况
截止至2013年10月23日，iPad已经累计销售1.7亿台
在平板市场的占有率高达81%

iPhone和iPad开发的区别

iPhone是手机，iPad、iPad Mini是平板电脑

iPhone和iPad开发的区别
屏幕的尺寸 \分辨率
UI元素的排布 \设计
键盘
API
屏幕方向的支持
… …

屏幕的尺寸 \分辨率

在iOS开发中，只需要关注以下几种情况
iPhone
3.5 inch：320 x 480
4.0 inch：320 x 568
iPad、iPad Mini
9.7 inch、7.9 inch：768 x 1024

屏幕方向的支持

iPhone支持3个方向

iPad支持4个方向

开发细节

设备支持的应用程序
iPhone上只能运行iPhone程序
iPad上能够运行iPhone \ iPad程序

开发过程
iPhone和iPad开发的流程是一致的
在iPhone开发中学到的所有知识基本都能用在iPad上

UIPopoverController

什么是UIPopoverController
是iPad开发中常见的一种控制器（在iPhone上不允许使用）
跟其他控制器不一样的是，它直接继承自NSObject，并非继承自UIViewController
它只占用部分屏幕空间来呈现信息，而且显示在屏幕的最前面

要想显示一个UIPopoverController，需要经过下列步骤
设置内容控制器
由于UIPopoverController直接继承自NSObject，不具备可视化的能力
因此UIPopoverController上面的内容必须由另外一个继承自UIViewController的控制器来提供，这个控制器称为“内容控制器”

设置内容的尺寸
显示出来占据多少屏幕空间

设置显示的位置
从哪个地方冒出来

设置内容控制器

设置内容控制器有3种方法

//在初始化UIPopoverController的时候传入一个内容控制器
- (id)initWithContentViewController:(UIViewController *)viewController;

@property (nonatomic, retain) UIViewController *contentViewController;

- (void)setContentViewController:(UIViewController *)viewController animated:(BOOL)animated;

//以上方法和属性都是UIPopoverController的

设置内容的尺寸

设置内容的尺寸有2种方法

@property (nonatomic) CGSize popoverContentSize;

- (void)setPopoverContentSize:(CGSize)size animated:(BOOL)animated;

//以上方法和属性都是UIPopoverController的

设置显示的位置

设置显示的位置有2种方法
//围绕着一个UIBarButtonItem显示（箭头指定那个UIBarButtonItem）
- (void)presentPopoverFromBarButtonItem:(UIBarButtonItem *)item permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections animated:(BOOL)animated;
//item ：围绕着哪个UIBarButtonItem显示
//arrowDirections ：箭头的方向
//animated ：是否通过动画显示出来

//围绕着某一块特定区域显示（箭头指定那块特定区域）
- (void)presentPopoverFromRect:(CGRect)rect inView:(UIView *)view permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections animated:(BOOL)animated;
//rect ：指定箭头所指区域的矩形框范围（位置和尺寸）
//view ：rect参数是以view的左上角为坐标原点（0，0）
//arrowDirections ：箭头的方向
//animated ：是否通过动画显示出来

//如果想让箭头指向某一个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];

rect和view参数

常见报错

在popover的使用过程中，经常会遇到这个错误
-[UIPopoverController dealloc] reached while popover is still visible.
错误的大体意思是：popover在仍旧可见的时候被销毁了（调用了dealloc）

从错误可以得出的结论
当popover仍旧可见的时候，不准销毁popover对象
在销毁popover对象之前，一定先让popover消失（不可见）

通过内容控制器设置内容尺寸

//内容控制器可以自行设置自己在popover中显示的尺寸
在iOS 7之前
@property (nonatomic,readwrite) CGSize contentSizeForViewInPopover;

从iOS 7开始
@property (nonatomic) CGSize preferredContentSize;
以上属性都是UIViewController的

常用属性

代理对象
@property (nonatomic, assign) id <UIPopoverControllerDelegate> delegate;

是否可见
@property (nonatomic, readonly, getter=isPopoverVisible) BOOL popoverVisible;

箭头方向
@property (nonatomic, readonly) UIPopoverArrowDirection popoverArrowDirection;

关闭popover（让popover消失）
- (void)dismissPopoverAnimated:(BOOL)animated;

防止点击UIPopoverController区域外消失

默认情况下
只要UIPopoverController显示在屏幕上，UIPopoverController背后的所有控件默认是不能跟用户进行正常交互的
点击UIPopoverController区域外的控件，UIPopoverController默认会消失

要想点击UIPopoverController区域外的控件时不让UIPopoverController消失，解决办法是设置passthroughViews属性
@property (nonatomic, copy) NSArray *passthroughViews;
这个属性是设置当UIPopoverController显示出来时，哪些控件可以继续跟用户进行正常交互。这样的话，点击区域外的控件就不会让UIPopoverController消失了

如何iPhone中实现popover的效果

UIPopoverController这个类是只能用在iPad中的

要想在iPhone中实现popover效果，必须得自定义view，可以参考
http://code4app.com/ios/Popover-View-in-iPhone/4fa931bd06f6e78d0f000000
http://code4app.com/ios/Popup-Menu/512231ac6803fa9e08000000

UIPopoverController实例

@interface ViewController ()
- (IBAction)popMenu:(id)item;
@property (nonatomic, strong) UIPopoverController *popover;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

}

// -[UIPopoverController dealloc] reached while popover is still visible.
// 当popover还在显示的时候,它就挂了
// 不允许popover还在显示的时候挂掉
// popover必须在消失的时候挂掉

/**
 *  弹出Popover菜单
 */
- (IBAction)popMenu:(id)item {
    // 0.内容
    HMMenuViewController *menu = [[HMMenuViewController alloc] init];

    // 1.创建一个UIPopover
    UIPopoverController *popover = [[UIPopoverController alloc] initWithContentViewController:[[UINavigationController alloc] initWithRootViewController:menu]];

    // 2.设置尺寸
//    popover.popoverContentSize = CGSizeMake(320, 44 * 5);

    // 3.从哪里显示出来 --> 指向item
    [popover presentPopoverFromBarButtonItem:item permittedArrowDirections:UIPopoverArrowDirectionAny animated:YES];

    self.popover = popover;
}
@end

@interface MenuViewController ()
@property (nonatomic, strong) NSArray *titles;
@end

@implementation MenuViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    self.titles = @[@"设置", @"清除缓存", @"退出", @"基本信息"];
    self.title = @"菜单";
    self.view.backgroundColor = [UIColor blueColor];

    CGFloat w = 320;
    CGFloat h = self.titles.count * 44;
    self.preferredContentSize = CGSizeMake(w, h);
//    self.contentSizeForViewInPopover = CGSizeMake(w, h);
}

#pragma mark - Table view data source
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return self.titles.count;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    static NSString *ID = @"cell";
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];
    if (!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:ID];
    }

    cell.textLabel.text = self.titles[indexPath.row];

    return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
    UIViewController *vc = [[UIViewController alloc] init];
    vc.view.backgroundColor = [UIColor redColor];
    [self.navigationController pushViewController:vc animated:YES];
}

@end

UIPopoverController其他用法

@interface ViewController () <ColorsViewControllerDelegate, UIPopoverControllerDelegate>
- (IBAction)buttonClick:(UIButton *)btn;
@property (nonatomic, weak) UIButton *colorButton;
@property (nonatomic, strong) UIPopoverController *popover;
@property (weak, nonatomic) IBOutlet UIButton *greenButton;

- (IBAction)greenButtonClick;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

}

- (IBAction)greenButtonClick {
    NSLog(@"greenButtonClick");
}

- (IBAction)buttonClick:(UIButton *)btn {
    // 0.内容
    HMColorsViewController *colors = [[HMColorsViewController alloc] init];
    colors.delegate = self;

    // 1.创建
    self.popover = [[UIPopoverController alloc] initWithContentViewController:colors];
    self.popover.delegate = self;

     //2.显示
    [self.popover presentPopoverFromRect:CGRectMake(150, 150, 100, 100) inView:btn.superview permittedArrowDirections:UIPopoverArrowDirectionAny animated:YES];
    [self.popover presentPopoverFromRect:CGRectMake(924, 668, 100, 100) inView:btn.superview permittedArrowDirections:UIPopoverArrowDirectionAny animated:YES];
    [self.popover presentPopoverFromRect:btn.bounds inView:btn permittedArrowDirections:UIPopoverArrowDirectionAny animated:YES];
    [self.popover presentPopoverFromRect:btn.frame inView:btn.superview permittedArrowDirections:UIPopoverArrowDirectionAny animated:YES];

    // 3.设置哪里控件在popover显示出来的时候,仍旧可以跟用户进行交互
    self.popover.passthroughViews = @[self.greenButton];

    self.colorButton = btn;
}

#pragma mark - 颜色选择代理
- (void)colorsViewController:(HMColorsViewController *)vc didSelectColor:(UIColor *)color
{
    self.colorButton.backgroundColor = color;

    // 关闭popover
    [self.popover dismissPopoverAnimated:YES];
}

#pragma mark - popover的代理
- (void)popoverControllerDidDismissPopover:(UIPopoverController *)popoverController
{
//    NSLog(@"popover销毁了");
}
@end

#import <UIKit/UIKit.h>
@class ColorsViewController;

@protocol ColorsViewControllerDelegate <NSObject>

@optional
- (void)colorsViewController:(ColorsViewController *)vc didSelectColor:(UIColor *)color;
@end

@interface ColorsViewController : UITableViewController
@property (nonatomic, weak) id<ColorsViewControllerDelegate> delegate;
@end

@implementation ColorsViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    self.tableView.separatorStyle = UITableViewCellSeparatorStyleNone;
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

#pragma mark - Table view data source
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return 30;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    static NSString *ID = @"cell";
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];
    if (!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:ID];
        cell.selectionStyle = UITableViewCellSelectionStyleNone;
    }

    cell.backgroundColor = [UIColor colorWithRed:arc4random_uniform(255)/255.0 green:arc4random_uniform(255)/255.0 blue:arc4random_uniform(255)/255.0 alpha:1.0];

    return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
    if ([self.delegate respondsToSelector:@selector(colorsViewController:didSelectColor:)]) {
        UIColor *color = [tableView cellForRowAtIndexPath:indexPath].backgroundColor;
        [self.delegate colorsViewController:self didSelectColor:color];
    }
}
@end