您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 開發中 UIPopoverController 的使用詳解

編輯:iOS 相關教學

一、簡單介紹

1. 什麼是 UIPopoverController

它是 iPad 開發中常見的一種控制器(在 iPhone 上並不允許使用)。與其他控制器不同的是,它直接繼承自 NSObject,而非 UIViewController,只佔用部分螢幕空間來呈現資訊,並且顯示在畫面最上層。

2. 使用步驟

要顯示一個 UIPopoverController,需要經過下列步驟:

(1)設定內容控制器:由於它直接繼承自 NSObject、本身不具備可視化能力,因此上面的內容必須由另一個繼承自 UIViewController 的控制器提供,這個控制器稱為「內容控制器」。

(2)設定內容尺寸:決定顯示時佔據多少螢幕空間。

(3)顯示:決定從哪個位置冒出來。

二、具體步驟

新建一個 iPad 專案。先建立一個繼承自 UITableViewController 的控制器,作為 popover 的內容控制器。

YYMenuViewController.m

#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

#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. 建立 popover 並設定其內容控制器
    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 的寬高寫死:

self.popover.popoverContentSize = CGSizeMake(300, 200);

更好的設計是:popover 的尺寸應由內部控制器的內容來決定。內容控制器可以自行設定自己在 popover 中的顯示尺寸,有兩種方法:

(1)iOS 7 之前:@property (nonatomic, readwrite) CGSize contentSizeForViewInPopover;

(2)iOS 7 起:@property (nonatomic) CGSize preferredContentSize;

以上屬性都屬於 UIViewController。範例如下:

- (void)viewDidLoad
{
    [super viewDidLoad];

    // 設定控制器將來在 popover 中的尺寸
    CGFloat maxH = MIN(480, self.menus.count * 44);
    // iOS 7 以後
    self.preferredContentSize = CGSizeMake(150, maxH);
}

效果如下:

關於 MIN(A, B):最終大小取決於 B,但最大不超過 A,一旦超過 A 則等於 A。

五、設定顯示位置

設定顯示位置有兩種方法:

(1)環繞一個 UIBarButtonItem 顯示(箭頭指向該 UIBarButtonItem):

- (void)presentPopoverFromBarButtonItem:(UIBarButtonItem *)item
                 permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections
                                 animated:(BOOL)animated;

(2)環繞某一塊特定區域顯示(箭頭指向該區域):

- (void)presentPopoverFromRect:(CGRect)rect
                        inView:(UIView *)view
      permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections
                      animated:(BOOL)animated;

其中 rect 以 view 的左上角為座標原點。

相關程式碼:

#import "YYViewController.h"
#import "YYMenuViewController.h"

@interface YYViewController () <UIPopoverControllerDelegate>
@property (nonatomic, strong) UIPopoverController *popover;
- (IBAction)buttonClick:(UIButton *)sender;
@end

@implementation YYViewController

- (void)showPopoverFromItem
{
    YYMenuViewController *menuVc = [[YYMenuViewController alloc] init];
    self.popover = [[UIPopoverController alloc] initWithContentViewController:menuVc];
    [self.popover presentPopoverFromBarButtonItem:self.navigationItem.leftBarButtonItem
                             permittedArrowDirections:UIPopoverArrowDirectionAny
                                             animated:YES];
    self.popover.delegate = self;
}

#pragma mark - 代理方法
// popover 消失時呼叫
- (void)popoverControllerDidDismissPopover:(UIPopoverController *)popoverController
{
}
// popover 位置改變時呼叫(如豎屏變橫屏)
- (void)popoverController:(UIPopoverController *)popoverController
willRepositionPopoverToRect:(inout CGRect *)rect
                  inView:(inout UIView *__autoreleasing *)view
{
}
// 決定使用者點擊蒙版後 popover 是否可以 dismiss
- (BOOL)popoverControllerShouldDismissPopover:(UIPopoverController *)popoverController
{
    return NO;
}

- (IBAction)buttonClick:(UIButton *)sender {
    YYMenuViewController *menuVc = [[YYMenuViewController alloc] init];
    self.popover = [[UIPopoverController alloc] initWithContentViewController:menuVc];
    // 注意 sender.frame 與 sender.bounds 的區別
    [self.popover presentPopoverFromRect:sender.bounds inView:sender
                    permittedArrowDirections:UIPopoverArrowDirectionAny
                                    animated:YES];
}
@end

部分界面效果:

以下兩種寫法是等價的,也就是說,若讓箭頭指向某個 UIView(例如一個 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;
- (void)dismissPopoverAnimated:(BOOL)animated;

七、防止點擊 popover 區域外時消失

預設情況下,只要 popover 顯示在螢幕上,其背後的所有控制項都無法正常與使用者互動,點擊區域外的控制項時 popover 會預設消失。若想讓點擊區域外時不消失,可以設定 passthroughViews 屬性:

@property (nonatomic, copy) NSArray *passthroughViews;

這個屬性用來指定 popover 顯示時哪些控制項仍可正常互動,如此點擊區域外的控制項便不會讓 popover 消失。

- (IBAction)buttonClick:(UIButton *)sender {
    YYMenuViewController *menuVc = [[YYMenuViewController alloc] init];
    self.popover = [[UIPopoverController alloc] initWithContentViewController:menuVc];

    // 設定過濾掉一些控制項
    self.popover.passthroughViews = @[self.switchview];

    [self.popover presentPopoverFromRect:sender.frame inView:sender.superview
                    permittedArrowDirections:UIPopoverArrowDirectionAny
                                    animated:YES];
}

補充:UIPopoverController 這個類別只能用在 iPad 上。若想在手機上實現類似 popover 的效果,必須自訂 view。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved