UIGeometry.h 简介

//

//  UIGeometry.h

//  UIKit

//

//  Copyright (c) 2005-2013, Apple Inc. All rights reserved.

//

 

 

#import <Foundation/Foundation.h>

#import <CoreGraphics/CoreGraphics.h>

#import <UIKit/UIKitDefines.h>

 

typedef struct UIEdgeInsets {　　//边缘锁进

    CGFloat top, left, bottom, right;  // specify amount to inset (positive) for each of the edges. values can be negative to 'outset'

} UIEdgeInsets;

 

／／offset 

typedef struct UIOffset {

    CGFloat horizontal, vertical; // specify amount to offset a position, positive for right or down, negative for left or up

} UIOffset;

 

//UIRectEdge 操作标志 

typedef NS_OPTIONS(NSUInteger, UIRectEdge) {

    UIRectEdgeNone   = 0,

    UIRectEdgeTop    = 1 << 0,

    UIRectEdgeLeft   = 1 << 1,

    UIRectEdgeBottom = 1 << 2,

    UIRectEdgeRight  = 1 << 3,

    UIRectEdgeAll    = UIRectEdgeTop | UIRectEdgeLeft | UIRectEdgeBottom | UIRectEdgeRight

} NS_ENUM_AVAILABLE_IOS(7_0);

 

／／生成边缘缩进的函数 

UIKIT_STATIC_INLINE UIEdgeInsets UIEdgeInsetsMake(CGFloat top, CGFloat left, CGFloat bottom, CGFloat right) {

    UIEdgeInsets insets = {top, left, bottom, right};

    return insets;

}

 

／／对一个CGRect进行边缘缩进操作 

UIKIT_STATIC_INLINE CGRect UIEdgeInsetsInsetRect(CGRect rect, UIEdgeInsets insets) {

    rect.origin.x    += insets.left;

    rect.origin.y    += insets.top;

    rect.size.width  -= (insets.left + insets.right);

    rect.size.height -= (insets.top  + insets.bottom);

    return rect;

}

 

／／生成UiOffset 

UIKIT_STATIC_INLINE UIOffset UIOffsetMake(CGFloat horizontal, CGFloat vertical) {

    UIOffset offset = {horizontal, vertical};

    return offset;

}

 

／／比较两个UIEdgeInset是否相等 

UIKIT_STATIC_INLINE BOOL UIEdgeInsetsEqualToEdgeInsets(UIEdgeInsets insets1, UIEdgeInsets insets2) {

    return insets1.left == insets2.left && insets1.top == insets2.top && insets1.right == insets2.right && insets1.bottom == insets2.bottom;

}

／／两个UIOffset是否相等 

UIKIT_STATIC_INLINE BOOL UIOffsetEqualToOffset(UIOffset offset1, UIOffset offset2) {

    return offset1.horizontal == offset2.horizontal && offset1.vertical == offset2.vertical;

}

 

／／两个常量 

UIKIT_EXTERN const UIEdgeInsets UIEdgeInsetsZero;

UIKIT_EXTERN const UIOffset UIOffsetZero;

 

／／从CGPoint, cgSize CGRect CGAffineTransForm UIEdgeInset UIOffset 来生成字符串 

UIKIT_EXTERN NSString *NSStringFromCGPoint(CGPoint point);

UIKIT_EXTERN NSString *NSStringFromCGSize(CGSize size);

UIKIT_EXTERN NSString *NSStringFromCGRect(CGRect rect);

UIKIT_EXTERN NSString *NSStringFromCGAffineTransform(CGAffineTransform transform);

UIKIT_EXTERN NSString *NSStringFromUIEdgeInsets(UIEdgeInsets insets);

UIKIT_EXTERN NSString *NSStringFromUIOffset(UIOffset offset);

 

／／从字符串生成CGPoint CGSize CGRect CGAffineTransForm  UIEdgeInsets UIOffset

UIKIT_EXTERN CGPoint CGPointFromString(NSString *string);

UIKIT_EXTERN CGSize CGSizeFromString(NSString *string);

UIKIT_EXTERN CGRect CGRectFromString(NSString *string);

UIKIT_EXTERN CGAffineTransform CGAffineTransformFromString(NSString *string);

UIKIT_EXTERN UIEdgeInsets UIEdgeInsetsFromString(NSString *string);

UIKIT_EXTERN UIOffset UIOffsetFromString(NSString *string);

 

//NSValue Catelog(NSValueUiGeometryExtensions) 

@interface NSValue (NSValueUIGeometryExtensions)

 

+ (NSValue *)valueWithCGPoint:(CGPoint)point;

+ (NSValue *)valueWithCGSize:(CGSize)size;

+ (NSValue *)valueWithCGRect:(CGRect)rect;

+ (NSValue *)valueWithCGAffineTransform:(CGAffineTransform)transform;

+ (NSValue *)valueWithUIEdgeInsets:(UIEdgeInsets)insets;

+ (NSValue *)valueWithUIOffset:(UIOffset)insets NS_AVAILABLE_IOS(5_0);

 

- (CGPoint)CGPointValue;

- (CGSize)CGSizeValue;

- (CGRect)CGRectValue;

- (CGAffineTransform)CGAffineTransformValue;

- (UIEdgeInsets)UIEdgeInsetsValue;

- (UIOffset)UIOffsetValue NS_AVAILABLE_IOS(5_0);

 

@end

 

//NSCoder Catelog    

@interface NSCoder (UIGeometryKeyedCoding)

 

- (void)encodeCGPoint:(CGPoint)point forKey:(NSString *)key;

- (void)encodeCGSize:(CGSize)size forKey:(NSString *)key;

- (void)encodeCGRect:(CGRect)rect forKey:(NSString *)key;

- (void)encodeCGAffineTransform:(CGAffineTransform)transform forKey:(NSString *)key;

- (void)encodeUIEdgeInsets:(UIEdgeInsets)insets forKey:(NSString *)key;

- (void)encodeUIOffset:(UIOffset)offset forKey:(NSString *)key NS_AVAILABLE_IOS(5_0);

 

- (CGPoint)decodeCGPointForKey:(NSString *)key;

- (CGSize)decodeCGSizeForKey:(NSString *)key;

- (CGRect)decodeCGRectForKey:(NSString *)key;

- (CGAffineTransform)decodeCGAffineTransformForKey:(NSString *)key;

- (UIEdgeInsets)decodeUIEdgeInsetsForKey:(NSString *)key;

- (UIOffset)decodeUIOffsetForKey:(NSString *)key NS_AVAILABLE_IOS(5_0);

 

@end