//
// UIView.h
// UIKit
//
// Copyright (c) 2005-2012, Apple Inc. All rights reserved.
//
#import <Foundation/Foundation.h> 基础框架入口
#import <UIKit/UIResponder.h>触摸事件响应处理
#import <UIKit/UIInterface.h> 界面UIcolor, UIFont 定义
#import <UIKit/UIKitDefines.h> 一些宏定义
#import <UIKit/UIAppearance.h> 外观代理
#import <UIKit/NSLayoutConstraint.h> 布局对象约束
typedef NS_ENUM(NSInteger, UIViewAnimationCurve) { //动画曲线
UIViewAnimationCurveEaseInOut, // slow at beginning and end 缓慢开始，中间加速，然后减速到结束
UIViewAnimationCurveEaseIn, // slow at beginning 缓慢开始，加速到结束
UIViewAnimationCurveEaseOut, // slow at end 加速开始，加速到结束
UIViewAnimationCurveLinear //正常速度
};
typedef NS_ENUM(NSInteger, UIViewContentMode) {
UIViewContentModeScaleToFill, 缩放内容到合适比例大小
UIViewContentModeScaleAspectFit, // contents scaled to fit with fixed aspect. remainder is transparent 缩放内容到合适的大小，边界多余部分透明
UIViewContentModeScaleAspectFill, // contents scaled to fill with fixed aspect. some portion of content may be clipped.缩放内容填充到指定大小，边界多余的部分省略
UIViewContentModeRedraw, // redraw on bounds change (calls -setNeedsDisplay) 重绘视图边界
UIViewContentModeCenter, // contents remain same size. positioned adjusted. 视图保持等比缩放
UIViewContentModeTop, 视图顶部对齐
UIViewContentModeBottom, 视图底部对齐
UIViewContentModeLeft, 视图左侧对齐
UIViewContentModeRight, 视图右侧对齐
UIViewContentModeTopLeft, 视图左上角对齐
UIViewContentModeTopRight, 视图右上角对齐
UIViewContentModeBottomLeft, 视图左下角对齐
UIViewContentModeBottomRight, 视图右下角对齐
};
typedef NS_ENUM(NSInteger, UIViewAnimationTransition) {
UIViewAnimationTransitionNone, 没有过渡
UIViewAnimationTransitionFlipFromLeft, 翻转视图从左到右
UIViewAnimationTransitionFlipFromRight, 翻转视图从右到左
UIViewAnimationTransitionCurlUp, 从上卷动
UIViewAnimationTransitionCurlDown, 从下卷动
};
typedef NS_OPTIONS(NSUInteger, UIViewAutoresizing) {
UIViewAutoresizingNone = 0, 父视图变化，自己不变化
UIViewAutoresizingFlexibleLeftMargin = 1 << 0, 视图的左边界和父视图的宽度等比例变化
UIViewAutoresizingFlexibleWidth = 1 << 1,视图的宽度和父视图的宽度成比例变化
UIViewAutoresizingFlexibleRightMargin = 1 << 2, 视图的右边界和父视图的宽度等比例变化
UIViewAutoresizingFlexibleTopMargin = 1 << 3, 视图的上边界和父视图的高度成等比例变化
UIViewAutoresizingFlexibleHeight = 1 << 4, 视图的高度和父视图的高度成比例变化
UIViewAutoresizingFlexibleBottomMargin = 1 << 5 视图的下边界和父视图的高度成等比例变化
};
typedef NS_OPTIONS(NSUInteger, UIViewAnimationOptions) {
UIViewAnimationOptionLayoutSubviews = 1 << 0,
UIViewAnimationOptionAllowUserInteraction = 1 << 1, // turn on user interaction while animating
UIViewAnimationOptionBeginFromCurrentState = 1 << 2, // start all views from current value, not initial value
UIViewAnimationOptionRepeat = 1 << 3, // repeat animation indefinitely
UIViewAnimationOptionAutoreverse = 1 << 4, // if repeat, run animation back and forth
UIViewAnimationOptionOverrideInheritedDuration = 1 << 5, // ignore nested duration
UIViewAnimationOptionOverrideInheritedCurve = 1 << 6, // ignore nested curve
UIViewAnimationOptionAllowAnimatedContent = 1 << 7, // animate contents (applies to transitions only)
UIViewAnimationOptionShowHideTransitionViews = 1 << 8, // flip to/from hidden state instead of adding/removing
UIViewAnimationOptionCurveEaseInOut = 0 << 16, // default
UIViewAnimationOptionCurveEaseIn = 1 << 16,
UIViewAnimationOptionCurveEaseOut = 2 << 16,
UIViewAnimationOptionCurveLinear = 3 << 16,
UIViewAnimationOptionTransitionNone = 0 << 20, // default
UIViewAnimationOptionTransitionFlipFromLeft = 1 << 20,
UIViewAnimationOptionTransitionFlipFromRight = 2 << 20,
UIViewAnimationOptionTransitionCurlUp = 3 << 20,
UIViewAnimationOptionTransitionCurlDown = 4 << 20,
UIViewAnimationOptionTransitionCrossDissolve = 5 << 20,
UIViewAnimationOptionTransitionFlipFromTop = 6 << 20,
UIViewAnimationOptionTransitionFlipFromBottom = 7 << 20,
} NS_ENUM_AVAILABLE_IOS(4_0);
@class UIEvent, UIWindow, UIViewController, UIColor, UIGestureRecognizer, CALayer;
NS_CLASS_AVAILABLE_IOS(2_0) @interface UIView : UIResponder<NSCoding, UIAppearance, UIAppearanceContainer> {
@package
CALayer *_layer;
id _tapInfo;
id _gestureInfo;
NSMutableArray *_gestureRecognizers;
NSArray *_subviewCache;
float _charge;
NSInteger _tag;
UIViewController *_viewDelegate;
NSString *_backgroundColorSystemColorName;
struct {
unsigned int userInteractionDisabled:1;
unsigned int implementsDrawRect:1;
unsigned int implementsDidScroll:1;
unsigned int implementsMouseTracking:1;
unsigned int hasBackgroundColor:1;
unsigned int isOpaque:1;
unsigned int becomeFirstResponderWhenCapable:1;
unsigned int interceptMouseEvent:1;
unsigned int deallocating:1;
unsigned int debugFlash:1;
unsigned int debugSkippedSetNeedsDisplay:1;
unsigned int debugScheduledDisplayIsRequired:1;
unsigned int isInAWindow:1;
unsigned int isAncestorOfFirstResponder:1;
unsigned int dontAutoresizeSubviews:1;
unsigned int autoresizeMask:6;
unsigned int patternBackground:1;
unsigned int fixedBackgroundPattern:1;
unsigned int dontAnimate:1;
unsigned int superLayerIsView:1;
unsigned int layerKitPatternDrawing:1;
unsigned int multipleTouchEnabled:1;
unsigned int exclusiveTouch:1;
unsigned int hasViewController:1;
unsigned int needsDidAppearOrDisappear:1;
unsigned int gesturesEnabled:1;
unsigned int deliversTouchesForGesturesToSuperview:1;
unsigned int chargeEnabled:1;
unsigned int skipsSubviewEnumeration:1;
unsigned int needsDisplayOnBoundsChange:1;
unsigned int hasTiledLayer:1;
unsigned int hasLargeContent:1;
unsigned int unused:1;
unsigned int traversalMark:1;
unsigned int appearanceIsInvalid:1;
unsigned int monitorsSubtree:1;
unsigned int layoutEngineIsOverridden:1;
unsigned int constraintsAreClean:1;
unsigned int subviewLayoutConstraintsAreClean:1;
unsigned int potentiallyHasDanglyConstraints:1;
unsigned int doesNotTranslateAutoresizingMaskIntoConstraints:1;
unsigned int autolayoutIsClean:1;
unsigned int subviewsAutolayoutIsClean:1;
unsigned int layoutFlushingDisabled:1;
unsigned int layingOutFromConstraints:1;
unsigned int wantsAutolayout:1;
unsigned int subviewWantsAutolayout:1;
unsigned int isApplyingValuesFromEngine:1;
unsigned int isInAutolayout:1;
unsigned int isUpdatingAutoresizingConstraints:1;
unsigned int isUpdatingConstraints:1;
unsigned int stayHiddenAwaitingReuse:1;
unsigned int stayHiddenAfterReuse:1;
unsigned int skippedLayoutWhileHiddenForReuse:1;
} _viewFlags;
}
+ (Class)layerClass; // default is [CALayer class]. Used when creating the underlying layer for the view. 绘图布局
- (id)initWithFrame:(CGRect)frame; // default initializer 初始化视图布局
@property(nonatomic,getter=isUserInteractionEnabled) BOOL userInteractionEnabled; // default is YES. if set to NO, user events (touch, keys) are ignored and removed from the event queue.确定是否接受用户事件
@property(nonatomic) NSInteger tag; // default is 0 标记视图对象
@property(nonatomic,readonly,retain) CALayer *layer; // returns view's layer. Will always return a non-nil value. view is layer's delegate 返回一个只读的视图层
@end
@interface UIView(UIViewGeometry)
// animatable. do not use frame if view is transformed since it will not correctly reflect the actual location of the view. use bounds + center instead.
@property(nonatomic) CGRect frame; 描述view在其父view坐标系中的定位和大小
// use bounds/center and not frame if non-identity transform. if bounds dimension is odd, center may be have fractional part
@property(nonatomic) CGRect bounds; // default bounds is zero origin, frame size. animatable 描述view自身的本地坐标系统的定位和大小
@property(nonatomic) CGPoint center; // center is center of frame. animatable 描述view的frame属性的中心点
@property(nonatomic) CGAffineTransform transform; // default is CGAffineTransformIdentity. animatable 描述view相对bounds的平移量
@property(nonatomic) CGFloat contentScaleFactor NS_AVAILABLE_IOS(4_0); 改变视图比例，主要用于修改分辨率，来支持高，低分辨率转化绘图
@property(nonatomic,getter=isMultipleTouchEnabled) BOOL multipleTouchEnabled; // default is NO 设置是否接受多点触摸。YES 是接受多点，NO 接受单点。
@property(nonatomic,getter=isExclusiveTouch) BOOL exclusiveTouch; // default is NO 当前视图独占触摸事件
- (UIView *)hitTest:(CGPoint)point withEvent:(UIEvent *)event; // recursively calls -pointInside:withEvent:. point is in the receiver's coordinate system 接收视图触摸事件，遍历视图，确定最终接受视图层
- (BOOL)pointInside:(CGPoint)point withEvent:(UIEvent *)event; // default returns YES if point is in bounds 判断触摸事件是否在当前视图
- (CGPoint)convertPoint:(CGPoint)point toView:(UIView *)view; 转化当前视图的坐标相对于另外一个视图的坐标
- (CGPoint)convertPoint:(CGPoint)point fromView:(UIView *)view; 转化另外视图坐标相对于当前视图的坐标
- (CGRect)convertRect:(CGRect)rect toView:(UIView *)view; 转化当前视图的矩形坐标相对于另外一个视图的矩形
- (CGRect)convertRect:(CGRect)rect fromView:(UIView *)view;转化另外视图的矩形坐标相对于当前视图矩形
@property(nonatomic) BOOL autoresizesSubviews; // default is YES. if set, subviews are adjusted according to their autoresizingMask if self.bounds changes 判断是否接收边界的改变，YES：接收 NO：不接收
@property(nonatomic) UIViewAutoresizing autoresizingMask; // simple resize. default is UIViewAutoresizingNone 视图边界大小调整参数
- (CGSize)sizeThatFits:(CGSize)size; // return 'best' size to fit given size. does not actually resize view. Default is return existing view size 计算并返回一个最适应接收子视图的大小
- (void)sizeToFit; // calls sizeThatFits: with current view bounds and changes bounds size. 移动并调整子视图的大小
@end
@interface UIView(UIViewHierarchy)
@property(nonatomic,readonly) UIView *superview; 父视图
@property(nonatomic,readonly,copy) NSArray *subviews; 子视图
@property(nonatomic,readonly) UIWindow *window; 窗口
- (void)removeFromSuperview; 将当前视图从父视图和窗口移除，并且把它的响应事件的响应链移除。
- (void)insertSubview:(UIView *)view atIndex:(NSInteger)index; 指定索引插入视图
- (void)exchangeSubviewAtIndex:(NSInteger)index1 withSubviewAtIndex:(NSInteger)index2; 指定索引交换子视图
视图的添加都是以栈的方式，即后进先出。
- (void)addSubview:(UIView *)view; 添加视图到最后- (void)insertSubview:(UIView *)view belowSubview:(UIView *)siblingSubview;添加视图到底层
- (void)insertSubview:(UIView *)view aboveSubview:(UIView *)siblingSubview; 添加视图到顶层
- (void)bringSubviewToFront:(UIView *)view; 将指定子视图推送到前台（顶层）
- (void)sendSubviewToBack:(UIView *)view; 将指定子视图推送到后台
- (void)didAddSubview:(UIView *)subview;通知某个子视图已经添加
- (void)willRemoveSubview:(UIView *)subview;通知视图某个子视图即将移除
- (void)willMoveToSuperview:(UIView *)newSuperview; 通知即将移动到新的父视图中
- (void)didMoveToSuperview;通知已经到新父视图
- (void)willMoveToWindow:(UIWindow *)newWindow; 通知即将已移动到新的窗口
- (void)didMoveToWindow; 通知已经移动新的窗口
- (BOOL)isDescendantOfView:(UIView *)view; // returns YES for self. 判断一个视图是否在父视图层中
- (UIView *)viewWithTag:(NSInteger)tag; // recursive search. includes self 获取标记的子视图
// Allows you to perform layout before the drawing cycle happens. -layoutIfNeeded forces layout early
- (void)setNeedsLayout; 标记为需要重新布局，异步调用layoutIfNeeded刷新布局，不立即刷新，但layoutSubviews一定会被调用
- (void)layoutIfNeeded;如果，有需要刷新的标记，立即调用layoutSubviews进行布局（如果没有标记，不会调用layoutSubviews）
- (void)layoutSubviews; // override point. called by layoutIfNeeded automatically. As of iOS 6.0, when constraints-based layout is used the base implementation applies the constraints-based layout, otherwise it does nothing. 重新布局
@end
@interface UIView(UIViewRendering)
- (void)drawRect:(CGRect)rect; 子类重写方法，重绘
- (void)setNeedsDisplay; 标记为需要重绘，异步调用drawRect
- (void)setNeedsDisplayInRect:(CGRect)rect; 标记为需要局部重绘
@property(nonatomic) BOOL clipsToBounds; // When YES, content and subviews are clipped to the bounds of the view. Default is NO. 决定子视图边界是否可以超过父视图范围
@property(nonatomic,copy) UIColor *backgroundColor; // default is nil 背景颜色
@property(nonatomic) CGFloat alpha; // animatable. default is 1.0 透明度， 取值范围为0.0 --- 1.0
@property(nonatomic,getter=isOpaque) BOOL opaque; // default is YES. opaque views must fill their entire bounds or the results are undefined. the active CGContext in drawRect: will not have been cleared and may have non-zeroed pixels 决定该消息接收者(UIView instance)是否让其视图不透明,用处在于给绘图系统提供一个性能优化开关。
@property(nonatomic) BOOL clearsContextBeforeDrawing; // default is YES. ignored for opaque views. for non-opaque views causes the active CGContext in drawRect: to be pre-filled with transparent pixels 决定绘制前是否清屏，默认为YES
@property(nonatomic,getter=isHidden) BOOL hidden; // default is NO. doesn't check superviews 视图是否隐藏，默认为NO(显示),YES为隐藏
@property(nonatomic) UIViewContentMode contentMode; // default is UIViewContentModeScaleToFill 视图边界填充
@property(nonatomic) CGRect contentStretch NS_DEPRECATED_IOS(3_0,6_0); // animatable. default is unit rectangle {{0,0} {1,1}}. Now deprecated: please use -[UIImage resizableImageWithCapInsets:] to achieve the same effect. 视图拉伸和缩略
@end
@interface UIView(UIViewAnimation)
+ (void)beginAnimations:(NSString *)animationID context:(void *)context; // additional context info passed to will start/did stop selectors. begin/commit can be nested 开始一个动画
+ (void)commitAnimations; // starts up any animations when the top level animation is commited 结束一个动画，类似数据库的事务处理
// no getters. if called outside animation block, these setters have no effect.
+ (void)setAnimationDelegate:(id)delegate; // default = nil 设置动画委托
+ (void)setAnimationWillStartSelector:(SEL)selector; // default = NULL. -animationWillStart:(NSString *)animationID context:(void *)context //当动画执行开始时，执行selector方法
+ (void)setAnimationDidStopSelector:(SEL)selector; // default = NULL. -animationDidStop:(NSString *)animationID finished:(NSNumber *)finished context:(void *)context //当动画执行结束时，执行selector方法
+ (void)setAnimationDuration:(NSTimeInterval)duration; // default = 0.2 //设置动画时间， 时间参数为double类型
+ (void)setAnimationDelay:(NSTimeInterval)delay; // default = 0.0 //设置动画延迟时间，单位秒
+ (void)setAnimationStartDate:(NSDate *)startDate; // default = now ([NSDate date]) 设置在动画块内部动画属性改变的开始时间
+ (void)setAnimationCurve:(UIViewAnimationCurve)curve; // default = UIViewAnimationCurveEaseInOut 设置动画的旋转曲度变化
+ (void)setAnimationRepeatCount:(float)repeatCount; // default = 0.0. May be fractional 设置动画在动画模块中的重复次数
+ (void)setAnimationRepeatAutoreverses:(BOOL)repeatAutoreverses; // default = NO. used if repeat count is non-zero 设置动画块中的动画效果是否自动重复播放
+ (void)setAnimationBeginsFromCurrentState:(BOOL)fromCurrentState; // default = NO. If YES, the current view position is always used for new animations -- allowing animations to "pile up" on each other. Otherwise, the last end state is used for the animation (the default). 设置动画是否从当前状态开始播放。
+ (void)setAnimationTransition:(UIViewAnimationTransition)transition forView:(UIView *)view cache:(BOOL)cache; // current limitation - only one per begin/commit block //在动画块设置过渡效果
+ (void)setAnimationsEnabled:(BOOL)enabled; // ignore any attribute changes while set. 设置是否开启动画，默认YES，开启
+ (BOOL)areAnimationsEnabled; 验证动画是否开启，YES:开启 NO：关闭
@end
@interface UIView(UIViewAnimationWithBlocks)
+ (void)animateWithDuration:(NSTimeInterval)duration delay:(NSTimeInterval)delay options:(UIViewAnimationOptions)options animations:(void (^)(void))animations completion:(void (^)(BOOL finished))completion NS_AVAILABLE_IOS(4_0); 动画效果处理块
+ (void)animateWithDuration:(NSTimeInterval)duration animations:(void (^)(void))animations completion:(void (^)(BOOL finished))completion NS_AVAILABLE_IOS(4_0); // delay = 0.0, options = 0 动画效果处理块，无延迟
+ (void)animateWithDuration:(NSTimeInterval)duration animations:(void (^)(void))animations NS_AVAILABLE_IOS(4_0); // delay = 0.0, options = 0, completion = NULL 动画效果处理块。无延迟，简单版
+ (void)transitionWithView:(UIView *)view duration:(NSTimeInterval)duration options:(UIViewAnimationOptions)options animations:(void (^)(void))animations completion:(void (^)(BOOL finished))completion NS_AVAILABLE_IOS(4_0); 过渡动画处理块
+ (void)transitionFromView:(UIView *)fromView toView:(UIView *)toView duration:(NSTimeInterval)duration options:(UIViewAnimationOptions)options completion:(void (^)(BOOL finished))completion NS_AVAILABLE_IOS(4_0); // toView added to fromView.superview, fromView removed from its superview 视图之间切换过渡动画处理块
@end
@interface UIView (UIViewGestureRecognizers)
@property(nonatomic,copy) NSArray *gestureRecognizers NS_AVAILABLE_IOS(3_2); 手势识别器
- (void)addGestureRecognizer:(UIGestureRecognizer*)gestureRecognizer NS_AVAILABLE_IOS(3_2);绑定手势到视图
- (void)removeGestureRecognizer:(UIGestureRecognizer*)gestureRecognizer NS_AVAILABLE_IOS(3_2);从视图中分离手势
// called when the recognizer attempts to transition out of UIGestureRecognizerStatePossible if a touch hit-tested to this view will be cancelled as a result of gesture recognition
// returns YES by default. return NO to cause the gesture recognizer to transition to UIGestureRecognizerStateFailed
// subclasses may override to prevent recognition of particular gestures. for example, UISlider prevents swipes parallel to the slider that start in the thumb
- (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer NS_AVAILABLE_IOS(6_0); 手势识别处理方式
@end
//
// UIView Constraint-based Layout Support
//
typedef NS_ENUM(NSInteger, UILayoutConstraintAxis) {
UILayoutConstraintAxisHorizontal = 0,
UILayoutConstraintAxisVertical = 1
};
// Installing Constraints
/* A constraint is typically installed on the closest common ancestor of the views involved in the constraint.
It is required that a constraint be installed on _a_ common ancestor of every view involved. The numbers in a constraint are interpreted in the coordinate system of the view it is installed on. A view is considered to be an ancestor of itself.
*/
@interface UIView (UIConstraintBasedLayoutInstallingConstraints)
- (NSArray *)constraints NS_AVAILABLE_IOS(6_0);视图布局约束
- (void)addConstraint:(NSLayoutConstraint *)constraint NS_AVAILABLE_IOS(6_0);/视图布局上添加一个约束
- (void)addConstraints:(NSArray *)constraints NS_AVAILABLE_IOS(6_0);视图布局上添加多个约束
- (void)removeConstraint:(NSLayoutConstraint *)constraint NS_AVAILABLE_IOS(6_0);移除视图布局上的一个约束
- (void)removeConstraints:(NSArray *)constraints NS_AVAILABLE_IOS(6_0);移除视图布局上的多个约束
@end
// Core Layout Methods
/* To render a window, the following passes will occur, if necessary.
update constraints
layout
display
Please see the conceptual documentation for a discussion of these methods.
*/
@interface UIView (UIConstraintBasedLayoutCoreMethods)
- (void)updateConstraintsIfNeeded NS_AVAILABLE_IOS(6_0); // Updates the constraints from the bottom up for the view hierarchy rooted at the receiver. UIWindow's implementation creates a layout engine if necessary first. 调用新的视图布局自动触发，更新视图布局上的约束
- (void)updateConstraints NS_AVAILABLE_IOS(6_0); // Override this to adjust your special constraints during a constraints update pass更新自定义视图布局约束
- (BOOL)needsUpdateConstraints NS_AVAILABLE_IOS(6_0);判断视图布局是否需要更新约束
- (void)setNeedsUpdateConstraints NS_AVAILABLE_IOS(6_0);设置视图布局是否需要更新约束
@end
// Compatibility and Adoption
@interface UIView (UIConstraintBasedCompatibility)
/* by default, the autoresizing mask on a view gives rise to constraints that fully determine the view's position. Any constraints you set on the view are likely to conflict with autoresizing constraints, so you must turn off this property first. IB will turn it off for you.
*/
- (BOOL)translatesAutoresizingMaskIntoConstraints NS_AVAILABLE_IOS(6_0); // Default YES 标示是否自动遵循视图布局约束
- (void)setTranslatesAutoresizingMaskIntoConstraints:(BOOL)flag NS_AVAILABLE_IOS(6_0); 设置是否自动遵循视图布局约束
/* constraint-based layout engages lazily when someone tries to use it (e.g., adds a constraint to a view). If you do all of your constraint set up in -updateConstraints, you might never even receive updateConstraints if no one makes a constraint. To fix this chicken and egg problem, override this method to return YES if your view needs the window to use constraint-based layout.
*/
+ (BOOL)requiresConstraintBasedLayout NS_AVAILABLE_IOS(6_0); 返回是遵循自定义视图布局约束
@end
// Separation of Concerns
@interface UIView (UIConstraintBasedLayoutLayering)
/* Constraints do not actually relate the frames of the views, rather they relate the "alignment rects" of views. This is the same as the frame unless overridden by a subclass of UIView. Alignment rects are the same as the "layout rects" shown in Interface Builder 3. Typically the alignment rect of a view is what the end user would think of as the bounding rect around a control, omitting ornamentation like shadows and engraving lines. The edges of the alignment rect are what is interesting to align, not the shadows and such.
*/
/* These two methods should be inverses of each other. UIKit will call both as part of layout computation.
They may be overridden to provide arbitrary transforms between frame and alignment rect, though the two methods must be inverses of each other.
However, the default implementation uses -alignmentRectInsets, so just override that if it's applicable. It's easier to get right.
A view that displayed an image with some ornament would typically override these, because the ornamental part of an image would scale up with the size of the frame.
Set the NSUserDefault UIViewShowAlignmentRects to YES to see alignment rects drawn.
*/
- (CGRect)alignmentRectForFrame:(CGRect)frame NS_AVAILABLE_IOS(6_0);返回矩形对于指定视图框架。
- (CGRect)frameForAlignmentRect:(CGRect)alignmentRect NS_AVAILABLE_IOS(6_0);返回框架对于指定视图矩形
/* override this if the alignment rect is obtained from the frame by insetting each edge by a fixed amount. This is only called by alignmentRectForFrame: and frameForAlignmentRect:.
*/
- (UIEdgeInsets)alignmentRectInsets NS_AVAILABLE_IOS(6_0);返回自定义视图框架
/* When you make a constraint on the NSLayoutAttributeBaseline of a view, the system aligns with the bottom of the view returned from this method. A nil return is interpreted as the receiver, and a non-nil return must be in the receiver's subtree. UIView's implementation returns self.
*/
- (UIView *)viewForBaselineLayout NS_AVAILABLE_IOS(6_0);如果超出约束范围，自动生成基线限制，以满足视图需求
/* Override this method to tell the layout system that there is something it doesn't natively understand in this view, and this is how large it intrinsically is. A typical example would be a single line text field. The layout system does not understand text - it must just be told that there's something in the view, and that that something will take a certain amount of space if not clipped.
In response, UIKit will set up constraints that specify (1) that the opaque content should not be compressed or clipped, (2) that the view prefers to hug tightly to its content.
A user of a view may need to specify the priority of these constraints. For example, by default, a push button
-strongly wants to hug its content in the vertical direction (buttons really ought to be their natural height)
-weakly hugs its content horizontally (extra side padding between the title and the edge of the bezel is acceptable)
-strongly resists compressing or clipping content in both directions.
However, you might have a case where you'd prefer to show all the available buttons with truncated text rather than losing some of the buttons. The truncation might only happen in portrait orientation but not in landscape, for example. In that case you'd want to setContentCompressionResistancePriority:forAxis: to (say) UILayoutPriorityDefaultLow for the horizontal axis.
The default 'strong' and 'weak' priorities referred to above are UILayoutPriorityDefaultHigh and UILayoutPriorityDefaultLow.
Note that not all views have an intrinsicContentSize. UIView's default implementation is to return (UIViewNoIntrinsicMetric, UIViewNoIntrinsicMetric). The _intrinsic_ content size is concerned only with data that is in the view itself, not in other views. Remember that you can also set constant width or height constraints on any view, and you don't need to override instrinsicContentSize if these dimensions won't be changing with changing view content.
*/
UIKIT_EXTERN const CGFloat UIViewNoIntrinsicMetric NS_AVAILABLE_IOS(6_0); // -1
- (CGSize)intrinsicContentSize NS_AVAILABLE_IOS(6_0); 返回自定义视图大小
- (void)invalidateIntrinsicContentSize NS_AVAILABLE_IOS(6_0); // call this when something changes that affects the intrinsicContentSize. Otherwise UIKit won't notice that it changed. 自定义视图内容大小无效
- (UILayoutPriority)contentHuggingPriorityForAxis:(UILayoutConstraintAxis)axis NS_AVAILABLE_IOS(6_0);返回放大的视图布局的轴线
- (void)setContentHuggingPriority:(UILayoutPriority)priority forAxis:(UILayoutConstraintAxis)axis NS_AVAILABLE_IOS(6_0);设置放大的视图布局的轴线
- (UILayoutPriority)contentCompressionResistancePriorityForAxis:(UILayoutConstraintAxis)axis NS_AVAILABLE_IOS(6_0);返回缩小的视图布局的轴线
- (void)setContentCompressionResistancePriority:(UILayoutPriority)priority forAxis:(UILayoutConstraintAxis)axis NS_AVAILABLE_IOS(6_0);设置缩小的视图布局的轴线
@end
// Size To Fit
UIKIT_EXTERN const CGSize UILayoutFittingCompressedSize NS_AVAILABLE_IOS(6_0);
UIKIT_EXTERN const CGSize UILayoutFittingExpandedSize NS_AVAILABLE_IOS(6_0);
@interface UIView (UIConstraintBasedLayoutFittingSize)
/* The size fitting most closely to targetSize in which the receiver's subtree can be laid out while optimally satisfying the constraints. If you want the smallest possible size, pass UILayoutFittingCompressedSize; for the largest possible size, pass UILayoutFittingExpandedSize.
Also see the comment for UILayoutPriorityFittingSizeLevel.
*/
- (CGSize)systemLayoutSizeFittingSize:(CGSize)targetSize NS_AVAILABLE_IOS(6_0);满足约束视图布局的大小
@end
// Debugging
/* Everything in this section should be used in debugging only, never in shipping code. These methods may not exist in the future - no promises.
*/
@interface UIView (UIConstraintBasedLayoutDebugging)
/* This returns a list of all the constraints that are affecting the current location of the receiver. The constraints do not necessarily involve the receiver, they may affect the frame indirectly.
Pass UILayoutConstraintAxisHorizontal for the constraints affecting [self center].x and CGRectGetWidth([self bounds]), and UILayoutConstraintAxisVertical for the constraints affecting[self center].y and CGRectGetHeight([self bounds]).
*/
- (NSArray *)constraintsAffectingLayoutForAxis:(UILayoutConstraintAxis)axis NS_AVAILABLE_IOS(6_0);返回影响视图布局限制的轴线
/* If there aren't enough constraints in the system to uniquely determine layout, we say the layout is ambiguous. For example, if the only constraint in the system was x = y + 100, then there are lots of different possible values for x and y. This situation is not automatically detected by UIKit, due to performance considerations and details of the algorithm used for layout.
The symptom of ambiguity is that views sometimes jump from place to place, or possibly are just in the wrong place.
-hasAmbiguousLayout runs a check for whether there is another center and bounds the receiver could have that could also satisfy the constraints.
-exerciseAmbiguousLayout does more. It randomly changes the view layout to a different valid layout. Making the UI jump back and forth can be helpful for figuring out where you're missing a constraint.
*/
- (BOOL)hasAmbiguousLayout NS_AVAILABLE_IOS(6_0);返回视图布局约束是否影响指定视图，主要用于调试约束布局，结合exerciseAmbiguityInLayout。
- (void)exerciseAmbiguityInLayout NS_AVAILABLE_IOS(6_0); 随机改变不同效值布局视图，主要用于调试基于约束布局的视图
@end
@interface UIView (UIStateRestoration)
@property (nonatomic, copy) NSString *restorationIdentifier NS_AVAILABLE_IOS(6_0);标示是否支持保存，恢复视图状态信息
- (void) encodeRestorableStateWithCoder:(NSCoder *)coder NS_AVAILABLE_IOS(6_0);保存视图状态相关信息
- (void) decodeRestorableStateWithCoder:(NSCoder *)coder NS_AVAILABLE_IOS(6_0); 恢复和保持视图状态相关信息
@end
