UIViewController所有API的学习。

/*

?? ? UIViewController is a generic controller base class that manages a view.? It has methods that are called

?? ? when a view appears or disappears.

? ? ?

?? ? Subclasses can override -loadView to create their custom view hierarchy, or specify a nib name to be loaded

?? ? automatically.? This class is also a good place for delegate & datasource methods, and other controller

?? ? stuff.

?? ? */

? ?@class UIView;

? ? //1. UIViewController是管理一个view的最主要的基类，当一个view要显示或者消失的时候。UIViewController有对应方法会被调用。

子类能够重写loadView方法去创建他们自己定义的view。或者指定一个nib被自己主动载入实现。这个类也是对于代理，数据源协议方法和一些其它控制器的方法展示实现一个非常好的空间地方。

?? ?

? ?@class UINavigationItem, UIBarButtonItem, UITabBarItem;

? ? //2. UINavigationItem是放置在导航栏中的,包括.rightBarButtonItem，.leftBarButtonItem，titleView，而这三个button又能够归为UIBarButtonItem类，并通过它创建。

UITabBarItem是分栏控制器底部切换itembutton。

?? ?

? ?@class UISearchDisplayController

? ? //3. UISearchDisplayController是专门为UITableView搜索封装的一个类。

?? ?

? ?@class UIPopoverController;

? ? //4.UIPopverController是IPad特有的类，不能在iphone上使用。它负责控制Popover视图。Popover是一种暂时视图。它以“漂浮”的形式出如今视图里面。

?? ?

? ?@class UIStoryboard, UIStoryboardSegue;

? ? //5. UIStoryboard是iOS5以后新增的内容，是以故事版的形式来展示界面之间的逻辑业务关系。前端开发眼下有三种方式（纯代码，代码+xib，UIStoryboard），UIStoryboard为当中一种。

而UIStoryboardSegue—————————————————————

? ?@class UIScrollView

? ? //6. UIScrollView在UIKit中是UIScrollView类，是容器类型的视图。它有三个子类—UITextView。UITableview和UICollectionView。它们在内容超出屏幕时提供水平或垂直滚动栏。

? ?@protocol UIViewControllerTransitionCoordinator;

? ? //7.这就涉及到自己定义viewController容器转场，iOS7引入的新特性自己定义viewController转场。-----------

?? ?

? ?typedef NS_ENUM(NSInteger, UIModalTransitionStyle) {

? ? ? ? UIModalTransitionStyleCoverVertical =0,

? ? ? ? UIModalTransitionStyleFlipHorizontal,

? ? ? ? UIModalTransitionStyleCrossDissolve,

? ? ? ? UIModalTransitionStylePartialCurlNS_ENUM_AVAILABLE_IOS(3_2),

? ? };

? ? //8.UIModalTransitionStyle是弹出模态ViewController时的四种动画风格。UIModalTransitionStyleCoverVertical是从底部滑入，UIModalTransitionStyleFlipHorizontal是水平翻转。UIModalTransitionStyleCrossDissolve是交叉溶解，UIModalTransitionStylePartialCurl是翻页效果。

?? ?

? ?typedef NS_ENUM(NSInteger, UIModalPresentationStyle) {

? ? ? ? UIModalPresentationFullScreen =0,

? ? ? ? UIModalPresentationPageSheetNS_ENUM_AVAILABLE_IOS(3_2),

? ? ? ? UIModalPresentationFormSheetNS_ENUM_AVAILABLE_IOS(3_2),

? ? ? ? UIModalPresentationCurrentContextNS_ENUM_AVAILABLE_IOS(3_2),

? ? ? ? UIModalPresentationCustomNS_ENUM_AVAILABLE_IOS(7_0),

? ? ? ? UIModalPresentationOverFullScreenNS_ENUM_AVAILABLE_IOS(8_0),

? ? ? ? UIModalPresentationOverCurrentContextNS_ENUM_AVAILABLE_IOS(8_0),

? ? ? ? UIModalPresentationPopoverNS_ENUM_AVAILABLE_IOS(8_0),

? ? ? ? UIModalPresentationNoneNS_ENUM_AVAILABLE_IOS(7_0) = -1,

? ? };

? ? //9。UIModalPresentationStyle是弹出模态ViewController时弹出风格，UIModalPresentationFullScreen是弹出VC时，VC充满全屏。UIModalPresentationPageSheet是假设设备横屏，VC的显示方式则从横屏下方開始，UIModalPresentationFormSheet是VC显示都是从底部，宽度和屏幕宽度一样。UIModalPresentationCurrentContext是VC的弹出方式和VC父VC的弹出方式同样。.....UIModalPresentationNone測试时会崩溃，出错‘The specified modal presentation style doesn‘t have a corresponding presentation controller.‘-------------------------------

?? ?

? ?@protocol UIContentContainer

? ? //10.iOS8之后，加入了新的一组协议，UIViewController对这组协议提供了默认的实现，我们自己定义ViewConttroller的时候能够重写这些方法来调整视图布局。

?? ?

?? ?

? ?@property (nonatomic, readonly) CGSize preferredContentSizeNS_AVAILABLE_IOS(8_0);

? ? //11.我们能够使用preferredContentSize来设置我们期望的childViewController的界面的大小。

?? ?

?? ?

? ? - (void)preferredContentSizeDidChangeForChildContentContainer:(id )containerNS_AVAILABLE_IOS(8_0);

? ? //12.这种方法告诉当前容器viewController，我们能够在这种方法里依据新的size对界面进行调整。

? ?/*

?? ? Intended as a bridge for a view controller that does not use auto layout presenting a child that does use auto layout.

? ? ?

?? ? If the child‘s view is using auto layout and the -systemLayoutSizeFittingSize: of the view

?? ? changes, -systemLayoutFittingSizeDidChangeForChildContentContainer: will be sent to the view controller‘s parent.

?? ? */

?? ?

? ? - (void)systemLayoutFittingSizeDidChangeForChildContentContainer:(id )containerNS_AVAILABLE_IOS(8_0);

? ? //13.重写方法来调整视图布局，当在这些情况下该方法会被调用，当前viewController没有使用auto layout布局，childrenViewController的view使用了autoLayout布局childrenViewController View-systemLayoutSizeFittingSize：方法返回的值的改变（view由于内容的改变，size也出现了变化）

? ?/*

?? ? When the content container forwards viewWillTransitionToSize:withTransitionCoordinator: to its children, it will call this method to determine what size to send them.

? ? ?

?? ? If the returned size is the same as the child container‘s current size, viewWillTransitionToSize:withTransitionCoordinator: will not be called.

?? ? */

?? ?

? ? - (CGSize)sizeForChildContentContainer:(id )container withParentContainerSize:(CGSize)parentSizeNS_AVAILABLE_IOS(8_0);

? ? //14.同上，依然由于iOS8上size class概念的提出，UIViewConteroller支持了UIConntentContainer这样一组新的协议，重写这些方法能够调整视图布局，一个容器viewController能够使用这种方法设置childViewController的size，当容器viewControllerViewWillTransitionTosize：withTransitionCoordinator：被调用时（我们重写这种方法时要调用super），sizeForChildContentContainer方法将被调用。

然后我们能够把须要设置desire发送给childViewController。当我们设置的这个size和当前childViewController的size一样，那么childViewController的viewWillTransitionToSize方法将不会被调用。sizeForChildContentContainer默认的实现是返回parentSize

? ?/*

?? ? This method is called when the view controller‘s view‘s size is changed by its parent (i.e. for the root view controller when its window rotates or is resized).

?? ? If you override this method, you should either call super to propagate the change to children or manually forward the change to children.

?? ? */

? ? - (void)viewWillTransitionToSize:(CGSize)size withTransitionCoordinator:(id )coordinatorNS_AVAILABLE_IOS(8_0);

? ? //15.viewController的view的size被他的parent Controller改变时，会触发这种方法（比方rootViewController在它的window旋转的时候）我们重写这种方法时。确保要调用super来保证size改变的这条消息能够正常传递给它的views活着childViewControllers。

? ?/*

?? ? This method is called when the view controller‘s trait collection is changed by its parent.

? ? ?

?? ? If you override this method, you should either call super to propagate the change to children or manually forward the change to children.

?? ? */

?? ?

?? ?

? ? - (void)willTransitionToTraitCollection:(UITraitCollection *)newCollection withTransitionCoordinator:(id )coordinator NS_AVAILABLE_IOS(8_0);

? ? //17.当viewController的traitCollection的值将要改变时会调用这种方法。这种方法是在UITraitEnvironment协议方法traitCollectionDidChange：之前被调用。

我们在重写这种方法时候也要确保要调用super来保证消息的传递。

比方，我们能够像这样在traintCollection值改变时，对试图做对应的动画进行调整。

? ?@end

?? ?

? ? // Sometimes view controllers that are using showViewController:sender and showDetailViewController:sender: will need to know when the split view controller environment above it has changed. This notification will be posted when that happens (for example, when a split view controller is collapsing or expanding). The NSNotification‘s object will be the view controller that caused the change.

? ?UIKIT_EXTERN NSString *const UIViewControllerShowDetailTargetDidChangeNotificationNS_AVAILABLE_IOS(8_0);

? ? //18.

?? ?

? ?NS_CLASS_AVAILABLE_IOS(2_0)@interface UIViewController : UIResponder {

? ? //19.UIViewController继承自UIResponder类，并实现NSCoding（实现归档操作），UIAppearanceContainer（同意开发人员对UI控件通过定制都能够呈现各种外观），UITraitEnvironment（SizeClasses适配理念。通过内部的traitCollection属性，能够拿到对应的UITraitCollection对象。从而得知当前的SizeClass。进一步确定界面的布局），UIContentContainer协议（调整视图布局）

? ? ? ?

? ? ? ?@package

? ? //20.实例变量范围类型@package，对于framework内部相当于@protect。对于framework外部相当于@private。

? ? ? ? UIView ? ? ? ? ? *_view;

? ? //21.view成员变量

? ? ? ? UITabBarItem ? ? *_tabBarItem;

?? ? ? //22.分栏控制器的itembutton成员变量

? ? ? ? UINavigationItem *_navigationItem;

? ? ? ? //23.导航栏item成员变量

? ? ? ? NSArray? ? ? ? ? *_toolbarItems;

? ? ? ? //24.数组用来保存工具条buttonitem的成员变量

? ? ? ? NSString ? ? ? ? *_title;

? ? ? ? //25.标题title成员变量

? ? ? ? NSString ? ? ? ? *_nibName;

? ? ? ? //26.nib名称成员变量

? ? ? ? NSBundle ? ? ? ? *_nibBundle;

? ? ? ? //27.bundle成员变量

? ? ? ? UIViewController *_parentViewController;// Nonretained

? ? ? ? //28.取父viewConreoller成员变量

? ? ? ? UIViewController *_childModalViewController;

? ? ? ? //29.取子模态ViewController成员变量

? ? ? ? UIViewController *_parentModalViewController;// Nonretained

? ? ? ? //30.取父模态ViewController成员变量

? ? ? ? UIViewController *_previousRootViewController;// Nonretained

? ? ? ? //31.取上一个根previous的成员变量

? ? ? ? UIView ? ? ? ? ? *_modalTransitionView;

? ? ? ? //32.模态过渡view的成员变量

? ? ? ? UIResponder? ? *_modalPreservedFirstResponder;

? ? ? ? //33.第一个保存Responder成员变量

? ? ? ?id ? ? ? ? ? ? ? _dimmingView;

? ? ? ? //34.变暗的view-----------

? ? ? ?id ? ? ? ? ? ? ? _dropShadowView;

? ? ? ? //35.删除阴影view成员变量--------------

? ? ? ?id? ? ? ? ? ? ? ? _currentAction;

? ? ? ? //36.当前动作方法

? ? ? ? UIStoryboard ? ? *_storyboard;

? ? ? ? //37.storyboard成员变量

? ? ? ? NSArray? ? ? ? ? *_storyboardSegueTemplates;

? ? ? ? //38.存放storyboardSegue的数组

? ? ? ? NSDictionary ? ? *_externalObjectsTableForViewLoading;

? ? ? ? //39.--------------------

? ? ? ? NSArray? ? ? ? ? *_topLevelObjectsToKeepAliveFromStoryboard;

? ? ? ? //40.--------------------

? ? ? ? UIView ? ? ? ? ? *_savedHeaderSuperview;

? ? ? ? //41.表头的父view

? ? ? ? UIView ? ? ? ? ? *_savedFooterSuperview;

? ? ? ? //42.表尾的父view

? ? ? ? UIBarButtonItem? *_editButtonItem;

? ? ? ? //43.可编辑的BarButtonItem

? ? ? ? UISearchDisplayController *_searchDisplayController;

? ? ? ? //44.用于搜索的viewController

? ? ? ? UIModalTransitionStyle _modalTransitionStyle;

? ? ? ? //45.模态视图过渡动画样式

? ? ? ? UIModalPresentationStyle _modalPresentationStyle;

? ? ? ? //46.模态视图呈现样式

? ? ? ? UIInterfaceOrientation _lastKnownInterfaceOrientation;

? ? ? ? //47.当前程序界面的旋转方向

? ? ? ? UIPopoverController*? ? _popoverController;

? ? ? ? //48.IPad专用的一种暂时视图，以漂浮的形式出如今屏幕表面。

? ? ? ? UIView *_containerViewInSheet;

? ? ? ? //49.---------------

? ? ? ? CGSize _contentSizeForViewInPopover;

? ? ? ? //50.在IPad暂时视图中展示容纳的view大小

? ? ? ? CGSize _formSheetSize;

? ? ? ? //51.---------

? ? ? ? UIScrollView *_recordedContentScrollView;

? ? ? ? //52.-----------

? ? ? ?void (^_afterAppearance)(void);

? ? ? ? //53.---------------

? ? ? ? NSInteger _explicitAppearanceTransitionLevel;

? ? ? ? //54.------------

? ? ? ? NSArray *_keyCommands;

? ? ? ? //55.------------

? ? ? ? NSMapTable *_overrideTraitCollections;

? ? ? ? //56.--------了解过还是不太理解

? ? ?

?? ?

? ?/*

?? ? The designated initializer. If you subclass UIViewController, you must call the super implementation of this

?? ? method, even if you aren‘t using a NIB.? (As a convenience, the default init method will do this for you,

?? ? and specify nil for both of this methods arguments.) In the specified NIB, the File‘s Owner proxy should

?? ? have its class set to your view controller subclass, with the view outlet connected to the main view. If you

?? ? invoke this method with a nil nib name, then this class‘ -loadView method will attempt to load a NIB whose

?? ? name is the same as your view controller‘s class. If no such NIB in fact exists then you must either call

?? ? -setView: before -view is invoked, or override the -loadView method to set up your views programatically.

?? ? */

? ? - (instancetype)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil;

? ? //100.这种方法是载入对应nibName的viewController

?? ?

?? ?

? ? @property(nonatomic,retain) UIView *view;// The getter first invokes [self loadView] if the view hasn‘t been set yet. Subclasses must call super if they override the setter or getter.

? ? //101.view属性，假设当你第一次调用[self loadView]方法而view还没有被设置，子类必须要调用super父类方法重写覆盖setter和getter

?? ?

? ? - (void)loadView;// This is where subclasses should create their custom view hierarchy if they aren‘t using a nib. Should never be called directly.

? ? //102.在loadView方法内部能够创建自己定义的view。有一前提是没有使用xib。

还有这种方法绝对不能直接主动去调用。

?? ?

? ? - (void)viewWillUnloadNS_DEPRECATED_IOS(5_0,6_0);

? ? //103.view将要销毁的时候会调用这种方法（只是如今已弃用）

?? ?

? ? - (void)viewDidUnloadNS_DEPRECATED_IOS(3_0,6_0);// Called after the view controller‘s view is released and set to nil. For example, a memory warning which causes the view to be purged. Not invoked as a result of -dealloc.

? ? //104.view已经被销毁的时候会调用这种方法(如今也已弃用)

? ?

? ? - (void)viewDidLoad;// Called after the view has been loaded. For view controllers created in code, this is after -loadView. For view controllers unarchived from a nib, this is after the view is set.

?? //105.这种方法在view载入完毕的时候调用，在此方法内部对view做一些渲染的事情，做一些初始化的操作，而且运行顺序是在loadView方法调用之后调用。

?? ?

? ? - (BOOL)isViewLoadedNS_AVAILABLE_IOS(3_0);

? ? //106.推断view是否被载入完毕

?? ?

? ? @property(nonatomic, readonly, copy) NSString *nibName; ? ?// The name of the nib to be loaded to instantiate the view.

? ? //107.nibName作为属性，载入对应的nib。

?? ?

? ?@property(nonatomic, readonly, retain) NSBundle *nibBundle;// The bundle from which to load the nib.

? ? //108.bundle是一个资源文件夹，包括nib文件，nibBunlde作为属性

?? ?

? ?@property(nonatomic, readonly, retain) UIStoryboard *storyboardNS_AVAILABLE_IOS(5_0);

? ? //109.storyboard属性,iOS5出现

?? ?

? ? - (void)performSegueWithIdentifier:(NSString *)identifier sender:(id)senderNS_AVAILABLE_IOS(5_0);

? ? //110.使用stortboard时利用segue进行页面跳转的方法

?? ?

? ? - (BOOL)shouldPerformSegueWithIdentifier:(NSString *)identifier sender:(id)senderNS_AVAILABLE_IOS(6_0);// Invoked immediately prior to initiating a segue. Return NO to prevent the segue from firing. The default implementation returns YES. This method is not invoked when -performSegueWithIdentifier:sender: is used.

? ? //111.这份方法是决定是否运行segeue的关键。可在内部做一些时间推断，返回yes。将运行performSegueWithIdentifier:方法，返回no不运行performSegueWithIdentifier:。默认返回yes，能够运行

?? ?

? ? - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)senderNS_AVAILABLE_IOS(5_0);

? ? //112.当用storyboard而且触发segue时，系统会自己主动调用这种方法。能够重写这种方法。在内部做一些类与类传递数据的操作

?? ?

? ? // View controllers will receive this message during segue unwinding. The default implementation returns the result of -respondsToSelector: - controllers can override this to perform any ancillary checks, if necessary.

? ? - (BOOL)canPerformUnwindSegueAction:(SEL)action fromViewController:(UIViewController *)fromViewController withSender:(id)sender NS_AVAILABLE_IOS(6_0);

? ? //113.我们一般在子控制器中通过实现canperformUnwindSegueAction：fromViewController:withSender：来决定要不要运行对应的Unwind Segue。

?? ?

? ? // Custom containers should override this method and search their children for an action handler (using -canPerformUnwindSegueAction:fromViewController:sender:). If a handler is found, the controller should return it. Otherwise, the result of invoking super‘s implementation should be returned.

? ? - (UIViewController *)viewControllerForUnwindSegueAction:(SEL)action fromViewController:(UIViewController *)fromViewController withSender:(id)senderNS_AVAILABLE_IOS(6_0);

? ? //114.这种方法用来决定哪个viewController来处理Unwind Segue action

? ?

? ? // Custom container view controllers should override this method and return segue instances that will perform the navigation portion of segue unwinding.

? ? - (UIStoryboardSegue *)segueForUnwindingToViewController:(UIViewController *)toViewController fromViewController:(UIViewController *)fromViewController identifier:(NSString *)identifier NS_AVAILABLE_IOS(6_0);

? ? //115.这种方法用来返回自己定义的Unwind Segue实例

?? ?

? ? - (void)viewWillAppear:(BOOL)animated;? ?// Called when the view is about to made visible. Default does nothing

?? //116.这种方法是当view将要显示的时候被调用

?? ?

? ? - (void)viewDidAppear:(BOOL)animated; ? ?// Called when the view has been fully transitioned onto the screen. Default does nothing

? ? //117.这种方法是当view已经显示的时候被调用

?? ?

? ? - (void)viewWillDisappear:(BOOL)animated;// Called when the view is dismissed, covered or otherwise hidden. Default does nothing

? ? //118.这种方法是当view将要消失的时候调用

?? ?

? ? - (void)viewDidDisappear:(BOOL)animated;?// Called after the view was dismissed, covered or otherwise hidden. Default does nothing

? ? //119.这种方法是当view已经消失的时候调用

?? ?

? ? // Called just before the view controller‘s view‘s layoutSubviews method is invoked. Subclasses can implement as necessary. The default is a nop.

? ? - (void)viewWillLayoutSubviewsNS_AVAILABLE_IOS(5_0);

? ? //120.在又一次布局子view前的时候会调用

?? ?

? ? // Called just after the view controller‘s view‘s layoutSubviews method is invoked. Subclasses can implement as necessary. The default is a nop.

? ? - (void)viewDidLayoutSubviewsNS_AVAILABLE_IOS(5_0);

? ? //120.在又一次布局子view后的时候会调用

?? ?

? ? @property(nonatomic,copy) NSString *title;?// Localized title for use by a parent controller.

? ? //121.标题title属性

?? ?

? ? - (void)didReceiveMemoryWarning;// Called when the parent application receives a memory warning. On iOS 6.0 it will no longer clear the view by default.

? ? //122.当应用程序收到内存警告的时候会调用这种方法 ,做对应的解决内存警告的操作

?? ?

? ?/*

?? ? If this view controller is a child of a containing view controller (e.g. a navigation controller or tab bar

?? ? controller,) this is the containing view controller.? Note that as of 5.0 this no longer will return the

?? ? presenting view controller.

?? ? */

? ?@property(nonatomic,readonly) UIViewController *parentViewController;

? ? //123.取父viewController的属性

?? ?

? ? // This property has been replaced by presentedViewController.

? ?@property(nonatomic,readonly) UIViewController *modalViewControllerNS_DEPRECATED_IOS(2_0,6_0);

? ? //124.得到模态视图控制器

?? ?

? ? // The view controller that was presented by this view controller or its nearest ancestor.

? ?@property(nonatomic,readonly) UIViewController *presentedViewController?NS_AVAILABLE_IOS(5_0);

? ? //125.------------------------

?? ?

? ? // The view controller that presented this view controller (or its farthest ancestor.)

? ?@property(nonatomic,readonly) UIViewController *presentingViewControllerNS_AVAILABLE_IOS(5_0);

? ? //126.正在展示的控制器

?? ?

? ?/*

?? ? Determines which parent view controller‘s view should be presented over for presentations of type

?? ? UIModalPresentationCurrentContext.? If no ancestor view controller has this flag set, then the presenter

?? ? will be the root view controller.

?? ? */

? ?@property(nonatomic,assign) BOOL definesPresentationContext NS_AVAILABLE_IOS(5_0);

? ? //127. 决定哪个父viewController的view应当呈如今当前，假设没有父viewController，呈现的将是根视图控制器。

?? ?

?? ?

? ? // A controller that defines the presentation context can also specify the modal transition style if this property is true.

? ?@property(nonatomic,assign) BOOL providesPresentationContextTransitionStyle NS_AVAILABLE_IOS(5_0);

? ? //128.假设这个属性是true的话，能够定义模态过渡转场的样式

?? ?

?? ?

? ?/*

?? ? These four methods can be used in a view controller‘s appearance callbacks to determine if it is being

?? ? presented, dismissed, or added or removed as a child view controller. For example, a view controller can

?? ? check if it is disappearing because it was dismissed or popped by asking itself in its viewWillDisappear:

?? ? method by checking the expression ([self isBeingDismissed] || [self isMovingFromParentViewController]).

?? ? */

?? ?

? ? - (BOOL)isBeingPresentedNS_AVAILABLE_IOS(5_0);

? ? //129.推断viewController是否正在展示

?? ?

? ? - (BOOL)isBeingDismissedNS_AVAILABLE_IOS(5_0);

? ? //130.推断viewController是否正在消失

?? ?

? ? - (BOOL)isMovingToParentViewControllerNS_AVAILABLE_IOS(5_0);

? ? //131.推断是否正在向父viewController移动

?? ?

? ? - (BOOL)isMovingFromParentViewControllerNS_AVAILABLE_IOS(5_0);

? ? //132.推断是否正由父viewController移动而来

?? ?

? ?/*

?? ? The next two methods are replacements for presentModalViewController:animated and

?? ? dismissModalViewControllerAnimated: The completion handler, if provided, will be invoked after the presented

?? ? controllers viewDidAppear: callback is invoked.

?? ? */

? ? - (void)presentViewController:(UIViewController *)viewControllerToPresent animated: (BOOL)flag completion:(void (^)(void))completion NS_AVAILABLE_IOS(5_0);

? ? //133.这种方法能够实现从当前viewController模态跳转到还有一个viewController，completion可在viewDidAppear后回调

?? ?

? ? // The completion handler, if provided, will be invoked after the dismissed controller‘s viewDidDisappear: callback is invoked.

? ? - (void)dismissViewControllerAnimated: (BOOL)flag completion: (void (^)(void))completion NS_AVAILABLE_IOS(5_0);

? ? //134.这种方法能够实现退出当前viewController由模态方式展现出来的，completion可在viewDidDisappear后回调

?? ?

? ? // Display another view controller as a modal child. Uses a vertical sheet transition if animated.This method has been replaced by presentViewController:animated:completion:

? ? - (void)presentModalViewController:(UIViewController *)modalViewController animated:(BOOL)animatedNS_DEPRECATED_IOS(2_0,6_0);

? ? //135.呈现模态视图

?? ?

? ? // Dismiss the current modal child. Uses a vertical sheet transition if animated. This method has been replaced by dismissViewControllerAnimated:completion:

? ? - (void)dismissModalViewControllerAnimated:(BOOL)animatedNS_DEPRECATED_IOS(2_0,6_0);

? ? //136.退出模态视图

?? ?

? ?/*

?? ? Defines the transition style that will be used for this view controller when it is presented modally. Set

?? ? this property on the view controller to be presented, not the presenter.? Defaults to

?? ? UIModalTransitionStyleCoverVertical.

?? ? */

? ?@property(nonatomic,assign) UIModalTransitionStyle modalTransitionStyleNS_AVAILABLE_IOS(3_0);

? ? //137.当一个viewController以模态方式呈现的时候，通过modalTransitionStyle可设置过渡动画样式

?? ?

? ?@property(nonatomic,assign) UIModalPresentationStyle modalPresentationStyleNS_AVAILABLE_IOS(3_2);

? ? //137.当一个viewController以模态方式呈现的时候，通过modalPresentationStyle可设置呈现的样式

?? ?

? ? // This controls whether this view controller takes over control of the status bar‘s appearance when presented non-full screen on another view controller. Defaults to NO.

? ?@property(nonatomic,assign) BOOL modalPresentationCapturesStatusBarAppearance NS_AVAILABLE_IOS(7_0);

? ? //138.这个属性是控制是否显示状态栏

?? ?

?? ?

? ? // Presentation modes may keep the keyboard visible when not required. Default implementation affects UIModalPresentationFormSheet visibility.

? ? - (BOOL)disablesAutomaticKeyboardDismissalNS_AVAILABLE_IOS(4_3);

? ? //139.这个API是于关闭键盘相关的，通常情况下单纯的使用resignFirstResponder就可以关闭键盘，可是在UIModalPresentationFormSheet下的视图是无法用resignFirstResponder这个API。是由于在进入到此模式后。系统将disablesAutomaticKeyboardDismissal的方法返回值设置成了YES，所以解决方法非常easy，又一次实现disablesAutomaticKeyboardDismissal，假设是直接使用viewController则能够在实现文件里又一次实现这个API，将返回改为NO后，就可以正常使用resignFirstResponder方法隐藏键盘。但非常多时候我们是把viewController放在UINavigationController中的，这样的情况下直接在viewController这里面实现disablesAutomaticKeyboardDismissal依然失效，而应发iUINavigationController中实现这个API。

?? ?

? ?@property(nonatomic,assign) BOOL wantsFullScreenLayout NS_DEPRECATED_IOS(3_0,7_0); // Deprecated in 7_0, Replaced by the following:

? ? //140.wantsFullScreenLayout=true。状态栏的高度就不会被算在视图里。也就是说有没有状态栏y坐标始终都是从0算起（只是此属性在iOS7已被弃用，以下属性替代此功能）

? ?@property(nonatomic,assign) UIRectEdge edgesForExtendedLayoutNS_AVAILABLE_IOS(7_0);// Defaults to UIRectEdgeAll

? ? //141.iOS7的新属性，默认值为UIRectEdgeAll。在navigationController中view的默认布局从navigationBar開始，self.edgesForExtendedLayout=UIRectEdgeNone,则布局控件减去navigationBar----------------

?? ?

? ? @property(nonatomic,assign)BOOL extendedLayoutIncludesOpaqueBarsNS_AVAILABLE_IOS(7_0);// Defaults to NO, but bars are translucent（透明的。半透明的）by default on 7_0.

? ? //142.在iOS7中UIViewController的wantsFullScreenLayout已经被舍弃。不在提供控件自己主动展示到导航栏以下这个属性。全部的UIViewController创建后默认就是full Screen的，因此假设带导航栏的应用界面中的部分控件会被导航栏覆盖掉。要解决这个情况能够使用iOS7中UIVIewController新增的属性extendedLayoutIncludesOpaqueBars和edgesForExtendedLayout来解决。

当中这个属性指定了当bar使用了不透明图片时，视图是否眼神至bar所在区域，默认值是NO，而edgesForExtendedLayout则是表示食欲是够覆盖到四周的区域。默认是UIRectEdgeAll。即上下左右四个方向都会覆盖，那么为让顶部不进行眼神到导航栏覆盖的区域，我们能够把顶部区域眼神去掉。实现代码例如以下，self.extendedLayoutIncludesOpaqueBars = NO;

self.edgesForExtendedLayout = UIRectEdgeBottom | UIRectEdgeLeft | UIRectEdgeRight;

? ? 当你在做的时候发现viewDidLoad的时候view的高度还是全屏。viewWillAppear已经去掉navigationbar了，所以frame的设置放在了viewWillAppear中比較准确。

?? ?

? ?@property(nonatomic,assign) BOOL automaticallyAdjustsScrollViewInsets NS_AVAILABLE_IOS(7_0);// Defaults to YES

? ? //143.当在一个viewController中有多个tableView之类的时候。要把这个属性设置为NO，这样多个tableview的位置就会是依照自己设定的来，而不会出现位置意外不正确的情况

? ? /* The preferredContentSize is used for any container laying out a child view controller.

?? ? */

? ?@property (nonatomic) CGSize preferredContentSizeNS_AVAILABLE_IOS(7_0);

? ? //144.preferredContentSize来设置我们期望的childViewController的界面的大小

?? ?

? ? // These methods control the attributes of the status bar when this view controller is shown. They can be overridden in view controller subclasses to return the desired status bar attributes.

? ? - (UIStatusBarStyle)preferredStatusBarStyleNS_AVAILABLE_IOS(7_0);// Defaults to UIStatusBarStyleDefault

? ? //145.设置shown的ViewController的状态栏样式

?? ?

? ? - (BOOL)prefersStatusBarHiddenNS_AVAILABLE_IOS(7_0);// Defaults to NO

? ? //146.设置状态栏是否隐藏显示

?? ?

? ? // Override to return the type of animation that should be used for status bar changes for this view controller. This currently only affects changes to prefersStatusBarHidden.

? ? - (UIStatusBarAnimation)preferredStatusBarUpdateAnimationNS_AVAILABLE_IOS(7_0);// Defaults to UIStatusBarAnimationFade

? ? //147.重写此方法设置状态栏更新时候的动画

?? ?

? ? // This should be called whenever the return values for the view controller‘s status bar attributes have changed. If it is called from within an animation block, the changes will be animated along with the rest of the animation block.

? ? - (void)setNeedsStatusBarAppearanceUpdateNS_AVAILABLE_IOS(7_0);

? ? //148.假设须要对状态栏进行刷新。调用此方法就可以

?? ?

? ? /* This method returns either itself or the nearest ancestor that responds to the action. View controllers can return NO from canPerformAction:withSender: to opt out of being a target for a given action. */

? ? - (UIViewController *)targetViewControllerForAction:(SEL)action sender:(id)senderNS_AVAILABLE_IOS(8_0);

? ? //149.

?? ?

? ? /* This method will show a view controller appropriately for the current size-class environment. It‘s implementation calls

?? ? `[self targetViewControllerForAction:sender:]` first and redirects accordingly if the return value is not `self`, otherwise it will present the vc. */

? ? - (void)showViewController:(UIViewController *)vc sender:(id)senderNS_AVAILABLE_IOS(8_0);

? ? //150.-----------------

?? ?

? ? /* This method will show a view controller within the semantic "detail" UI associated with the current size-class environment. It‘s implementation calls? `[self targetViewControllerForAction:sender:]` first and redirects accordingly if the return value is not `self`, otherwise it will present the vc.? */

? ? - (void)showDetailViewController:(UIViewController *)vc sender:(id)senderNS_AVAILABLE_IOS(8_0);

? ? //151.--------------------------

?? ?

?? ?

? ?@end

?? ?

? ? // To make it more convenient for applications to adopt rotation, a view controller may implement the below methods. Your UIWindow‘s frame should use [UIScreen mainScreen].bounds as its frame.

? ?@interface UIViewController (UIViewControllerRotation)

? ? //152.为UIViewController加入分类方法为了更好的适应应用的屏幕旋转

?? ?

? ? // call this method when your return value from shouldAutorotateToInterfaceOrientation: changes

? ? // if the current interface orientation does not match the current device orientation, a rotation may occur provided all relevant view controllers now return YES from shouldAutorotateToInterfaceOrientation:

? ? + (void)attemptRotationToDeviceOrientationNS_AVAILABLE_IOS(5_0);

? ? //153.这种方法这样使用：当应用的device orientation转换方向。又希望interface orientation也跟着转换方向时。不仅仅是将supportedInterfaceOrientations的返回值设置为目标方向，仍须要调用attemptRotationToDeviceOrientation这种方法。这样才干让interface orientation和device orientation的方向马上保持一致。

?? ?

? ? // Applications should use supportedInterfaceOrientations and/or shouldAutorotate..

? ? - (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)toInterfaceOrientationNS_DEPRECATED_IOS(2_0,6_0);

? ? //154.iOS6之前我们能够通过这种方法来单独控制某个UIVewController的旋转方向

?? ?

? ? // New Autorotation support.

? ? - (BOOL)shouldAutorotateNS_AVAILABLE_IOS(6_0);

? ? //155.决定是否之处多方向旋转屏，返回NO不支持，仅仅会支持默认的UIInterfaceOrientaionMaskPortrait方向

?? ?

? ? - (NSUInteger)supportedInterfaceOrientationsNS_AVAILABLE_IOS(6_0);

? ? //156.此方法的返回值决定interface orienation的旋转方向

?? ?

? ? // Returns interface orientation masks.

? ? - (UIInterfaceOrientation)preferredInterfaceOrientationForPresentationNS_AVAILABLE_IOS(6_0);

? ? //157.这种方法的作用是设置viewController在present时首选的默认方向，返回一个interfaceOrientation

?? ?

? ? // The rotating header and footer views will slide out during the rotation and back in once it has completed.

? ? - (UIView *)rotatingHeaderView NS_DEPRECATED_IOS(2_0,8_0,"Header views are animated along with the rest of the view hierarchy"); ? ?// Must be in the view hierarchy. Default returns nil.

? ? //158.查询当前的导航视图

?? ?

? ? - (UIView *)rotatingFooterView NS_DEPRECATED_IOS(2_0,8_0,"Footer views are animated along with the rest of the view hierarchy"); ? ?// Must be in the view hierarchy. Default returns nil.

? ? //159.查询当前的标签视图

?? ?

? ?@property(nonatomic,readonly) UIInterfaceOrientation interfaceOrientationNS_DEPRECATED_IOS(2_0,8_0);

? ? //160.interfaceOrientation是应用界面的旋转方向

?? ?

? ? // Notifies when rotation begins, reaches halfway point and ends.

? ? - (void)willRotateToInterfaceOrientation:(UIInterfaceOrientation)toInterfaceOrientation duration:(NSTimeInterval)durationNS_DEPRECATED_IOS(2_0,8_0,"Implement viewWillTransitionToSize:withTransitionCoordinator: instead");

? ? //161.应用界面将要旋转的时候前会调用。一般用来禁用某些控件或者停止某些正在运行的动作。比方播放视频等等

?? ?

? ? - (void)didRotateFromInterfaceOrientation:(UIInterfaceOrientation)fromInterfaceOrientationNS_DEPRECATED_IOS(2_0,8_0);

? ? //162.这个发生在旋转屏幕之后，一般用来启用某些之前被禁用的控件或者是之前已经正在运行的动作，如播放视频等等

?? ?

?