UISplitViewController - iPad分屏视图控制器

UISplitViewController - 分屏视图控制器

概述

UISplitViewController 是一个容器vc, 展现一个 master-detail(主－详（从）)界面。 
主视图改变会驱动从视图的改变。两个视图可用同时展现，也能够只显示一个。当建立app界面的时候，UISplitViewController一般是root vc ,它没有本身的元素可展现，它展现的是它的子vc,可经过属viewControllers来设置。

主要属性及方法

preferredDisplayMode: UISplitViewControllerDisplayMode －分隔视图的指望展现方式 
经过此属性来设置splitViewController的展现方式。splitViewController会尽力以你设置的方式展现，若是没有足够的空间，会用一个不一样类型的界面展现。改变此属性，splitViewController将动态的改变如今的展现模式。 
支持四中展现模式：

enum UISplitViewControllerDisplayMode : Int {
    //自适应模式,splitViewController会为可用空间选用合适的展现视图方式，在ipad的竖直方向会用.PrimaryOverlay模式展现视图，在iPad水平方向将会用.AllVisible 模式展现。
    case Automatic
    //主视图隐藏
    case PrimaryHidden
    //主详视图都显示
    case AllVisible
    //主视图部分覆盖详细视图
    case PrimaryOverlay
}

 

• diplayModeButtonItem: UIBarButtonItem － 改变分隔视图显示模式的按钮

若是想显示的更改分隔视图的显示模式，那么在界面中应该包含这个按钮。点击此按钮,经过deletage的方法 
targetDisplayModeForActionInSplitViewController:最后返回的值来改变分隔视图的显示模式。

 func targetDisplayModeForActionInSplitViewController(svc: UISplitViewController)    -> UISplitViewControllerDisplayMode {
        return UISplitViewControllerDisplayMode.Automatic
    }

 

 

presentsWithGesture: Bool - 指定一个隐藏的视图控制器是否可使用一个滑动手势来呈现和退出。

此属性针对iphone6s plus横屏及ipad有效，便是针对 size class 为（w:Regular）或则（height：Regular）的状况。当它的属性为true的时候，splitViewController 会添加一个手势识别器，经过delegete的方法targetDisplayModeForActionInSplitViewController返回的显示模式，来改变splitViewController的当前显示模式。若是设置为false则手势无效。

self.presentsWithGesture = true
    self.delegate = self

    //代理方法，手势滑动改变显示模式
    func targetDisplayModeForActionInSplitViewController(svc: UISplitViewController) -> UISplitViewControllerDisplayMode {

        //返回此模式，主从视图同时显示，滑动手势无效。
        return UISplitViewControllerDisplayMode.AllVisible
        //主视图隐藏，隐藏以后iPad没法再显示，iphone6s plus转到横屏，不受此属性约束，能够再显        示。
        return UISplitViewControllerDisplayMode.PrimaryHidden

        //主视图覆盖从视图
        return UISplitViewControllerDisplayMode.PrimaryOverlay
        //根据设备尺寸和类型自适应
        return UISplitViewControllerDisplayMode.Automatic
    }

 

 

•  

禁用手势的状况以下： 

viewControllers: [ UIViewController ] - 管理的视图控制器

当分隔视图界面展开的时候，此属性包括两个vc，当它折叠的时候，此属性包含一个vc。 数组中第一个元素称为 
primary（或 master）vc, 若是第二个元素呈现，那么它称为secondary（或 detail）vc。 
能够用此属性初始化splitViewController，但当splitViewController已经显示的时候，最好用　showDetailViewController:sender:或者showViewController:sender:来设置子vc。

 override func viewDidAppear(animated: Bool) {
        super.viewDidAppear(animated)
        //从 storyboard初始化一个vc
        let vc  = storyboard?.instantiateViewControllerWithIdentifier("detailVC") as! DetailViewController
        vc.selectedIndex = 400

        self.showDetailViewController(vc, sender: self )
    }

 

 

– showDetailViewController:sender: － 显示详细视图 
此方法会调用delegate的方法 splitViewController:showDetailViewController:sender:,给delegate一个显示vc的机会。若是delegate不想显示，那么 splitViewController会向前发送消息到将要被替换的vc，看看这个vc有什么要作的。例如：导航控制器会把vc放入它的导航栈中。若是没有任何对象想显示vc,那么splitViewController按照以下方法安排vc的显示:

• 在水平正常环境（w:Regular), vc做为detail vc展现。
• 在水平紧凑环境（w:Compact）,vc以modally方式展现。

delegate: UISplitViewControllerDelegate? － 代理

协议定义了一个方法可让你管理一个拆分视图界面的变化。使用此协议的方法来响应当前显示模式和当前界面方向的变化。当拆分视图界面折叠和展开时，或当一个新的视图控制器被添加到界面时，您还可使用这些方法来适当地配置子视图控制器。

主要方法以下：

//当视图转换到折叠模式，一般只显示主视图，经过此方法能够定制主视图。    
fun primaryViewControllerForCollapsingSplitViewController(splitViewController: UISplitViewController) -> UIViewController? {

        return nil
    }

    //视图转换为折叠模式，可用实现此方法为主视图进行一些处理，或者尝试把详细视图的内容包含进新的折叠视图。此方法会回后，splitViewController会把详细视图vc从 ‘viewControllers’ 属性中移除。
    返回false表示splitViewController采用默认的方式尝试在折叠视图中包含 ‘detail vc’,同时也会调用 master vc 的方法‘collapseSecondaryViewController:forSplitViewController：’对 ‘detail vc’对内容作一些处理，大部分控制器什么也不作，但当是‘UINavigationController’对时候会把
 ‘detail vc’放入到导航堆栈中。 返回true，表示什么也不作。

    func splitViewController(splitViewController: UISplitViewController, collapseSecondaryViewController secondaryViewController: UIViewController, ontoPrimaryViewController primaryViewController: UIViewController) -> Bool {


        return true
    }

    //当从水平紧凑变为水平正常模式时，调用此方法返回主控制器用来显示，可用返回特定的vc，若是返回nil将使用当前的主控制器。
    func primaryViewControllerForExpandingSplitViewController(splitViewController: UISplitViewController) -> UIViewController? {

        return nil
    }
   //为拆分视图返回详细视图控制器，若是返回为nil，splitViewController将会调用主控制的方法：
   separateSecondaryViewControllerForSplitViewController：来返回一个合适的vc，大部分控制器默认什么也不作，但当是UINavigationController的时候会返回导航栈顶端的元素。

    func splitViewController(splitViewController: UISplitViewController, separateSecondaryViewControllerFromPrimaryViewController primaryViewController: UIViewController) -> UIViewController? {

        return nil

    }