UITouch - BNR

　　本节任务：创建一个视图，让用户在视图上拖动手指来画线。　　

---

　　UIView类能够重载4个方法来处理不同的触摸事件。

- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event 　　// 一个手指或多个手指触摸屏幕。

- (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event 　　//一个或多个手指在视图上移动

- (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event 　　//一个或多个手指抬离屏幕时。

- (void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event 　　//系统事件，在触摸结束前被其打断。

@property(nonatomic, getter=isMultipleTouchEnabled) BOOL multipleTouchEnabled 　　// 默认为NO，如果想要处理多手指触摸事件，则需设置为YES。

　　一个UITouch对应在屏幕上的一个手指。如果一个视图开始拥有触摸对象，该视图将拥有触摸对象的生命周期。你不应该引用触摸对象。　　

---

　　创建一个新的Single View Application工程，命名为TouchTracker。

　　首先，需要一个模型对象来描述line。创建一个NSObject的子类，取名为BNRLine。

　　再创建一个UIView的子类，取名为BNRDrawView。BNRDrawView用来追踪全部画好了的线条以及目前正在画的线条。

　　再创建一个UIViewController的子类来管理BNRDrawView对象，取名为BNRDrawViewController。

　　

　　在BNRLine.h头文件中，声明两个CGPoint属性，如下：

 @property (nonatomic) CGPoint begin;
 @property (nonatomic) CGPoint end;

同时，将 #import <Foundation/Foundation.h> 改为 #import <UIKit/UIKit.h> 。

　　打开BNRDrawViewController.m文件，重载loadView方法，将BNRDrawView对象设置为BNRDrawViewController的view。

当请求显示控制器的view时，但是为nil，则视图控制器会自动调用loadView方法。该方法应加载或创建一个视图，并将其赋给控制器的view属性。如果视图控制器有一个相对于的nib文件，loadView方法将从该nib文件加载view。如果你使用了Interface Builder创建了视图并初始化了视图控制器，你一定不能重载该方法。

　　如果使用Interface Builder设计用户界面时，当视图对象从nib文件中加载视图时，initWithFrame:方法将不会被调用。

 - (void)loadView {
     self.view = [[BNRDrawView alloc] initWithFrame:CGRectZero];
 }

同时，在实现文件顶部导入BNRDrawView头文件，如下：

#import "BNRDrawView.h"

　　打开AppDelegate.m文件，创建一个BNRDrawViewController对象，将其作为window的rootViewController。同时导入BNRDrawViewController的头文件， #import "BNRDrawViewController.h" 。

方法application:didFinishLaunchingWithOptions:方法修改如下：

 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Override point for customization after application launch.
     self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
     BNRDrawViewController *dvc = [[BNRDrawViewController alloc] init];
     self.window.rootViewController = dvc;

     self.window.backgroundColor = [UIColor yellowColor];
     [self.window makeKeyAndVisible];
     return YES;
 }

　　打开BNRDrawView.m，导入BNRLine头文件，并在类扩展中声明两个属性，如下：

 #import "BNRLine.h"

 @interface BNRDrawView ()

 @property (nonatomic, strong) BNRLine *currentLine;
 @property (nonatomic, strong) NSMutableArray *finishedLines;

 @end

同时，添加initWithFrame:代码如下：

 - (instancetype)initWithFrame:(CGRect)r {
     self = [super initWithFrame:r];
     if (self) {
         self.finishedLines = [[NSMutableArray alloc] init];
         self.backgroundColor = [UIColor grayColor];
     }
     return self;
 }

同时，需要实现对finishedLine和currentLine的绘制。

当一个视图第一次显示或者一个事件的发生使得视图可见的部分失效了，则drawRect:方法会被调用。绝对不能直接调用该方法。为了使失效的部分重新绘制，需调用setNeedsDisplay或setNeedsDisplayInRect:方法。如下：

 - (void)strokeLike:(BNRLine *)line {
     UIBezierPath *bp = [UIBezierPath bezierPath];
     bp.lineWidth = ;
     bp.lineCapStyle = kCGLineCapRound;

     [bp moveToPoint:line.begin];
     [bp addLineToPoint:line.end];
     [bp stroke];
 }

 - (void)drawRect:(CGRect)rect {
     [[UIColor blackColor] set];
     for (BNRLine *line in self.finishedLines) {
         [self strokeLike:line];
     }
     if (self.currentLine) {
         [[UIColor redColor] set];
         [self strokeLike:self.currentLine];
     }
 }

该工程的对象关系如下所示：

---

　　当触摸事件开始时，需要创建一个line，将begin和end设置为触摸开始的点位置处。当手指移动时，将更新end。因此，打开BNRDrawView.m文件，touchesBegin:withEvent:方法实现如下：

 - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
     UITouch *t = [touches anyObject];
     CGPoint location = [t locationInView:self];
     self.currentLine = [[BNRLine alloc] init];
     self.currentLine.begin = location;
     self.currentLine.end = location;
     [self setNeedsDisplay];
 }

　　touchesMoved:withEvent:方法实现如下：

 - (void)touchesMoved:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
     UITouch *t = [touches anyObject];
     CGPoint location = [t locationInView:self];
     self.currentLine.end = location;
     [self setNeedsDisplay];
 }

　　当触摸事件结束时，将currentLine添加到finishedLines，touchesEnded:withEvent:实现如下：

 - (void)touchesEnded:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
     [self.finishedLines addObject:self.currentLine];
     self.currentLine = nil;
     [self setNeedsDisplay];
 }

　　启动程序，当正在画线时，线条显示红色。当画线结束，将变为黑色。

---

　　默认情况下，一个视图将一次只接受一个触摸。

　　此时，需要一个属性来包含尽可能多的将在屏幕上画出的线条。打开BNRDrawView.m，用下列的属性代替currentLine。

@property (nonatomic, strong) NSMutableDictionary *linesInProgress;

修改BNRDrawView中initWithFrame:方法使其能接收多点触摸，并初始化linesInProgress属性，如下：

 - (instancetype)initWithFrame:(CGRect)r {
     self = [super initWithFrame:r];
     if (self) {
         self.linesInProgress = [[NSMutableDictionary alloc] init];
         self.finishedLines = [[NSMutableArray alloc] init];
         self.backgroundColor = [UIColor grayColor];
         self.multipleTouchEnabled = YES;
     }
     return self;
 }

修改触摸响应事件如下：

 - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
     NSLog(@"%@", NSStringFromSelector(_cmd));

     for (UITouch *t in touches) {
         CGPoint location = [t locationInView:self];
         BNRLine *line = [[BNRLine alloc] init];
         line.begin = location;
         line.end = location;
         NSValue *key = [NSValue valueWithNonretainedObject:t];
         self.linesInProgress[key] = line;
     }
     [self setNeedsDisplay];
 }

 - (void)touchesMoved:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
     NSLog(@"%@", NSStringFromSelector(_cmd));

     for (UITouch *t in touches) {
         NSValue *key = [NSValue valueWithNonretainedObject:t];
         BNRLine *line = self.linesInProgress[key];
         line.end = [t locationInView:self];
     }

     [self setNeedsDisplay];
 }

 - (void)touchesEnded:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
     NSLog(@"%@", NSStringFromSelector(_cmd));

     for (UITouch *t in touches) {
         NSValue *key = [NSValue valueWithNonretainedObject:t];
         BNRLine *line = self.linesInProgress[key];
         [self.finishedLines addObject:line];
         [self.linesInProgress removeObjectForKey:key];
     }
     [self setNeedsDisplay];
 }

　　其中，我们使用valueWithNonretainedObject:方法来产生key用于保存BNRLine。该方法产生的NSValue对象将拥有与该lian有关的UITouch对象的地址。在每次触摸事件中。UITouch对象的地址是保持不变的。

　　在一个NSDictionary中，object使用的key必须遵守NSCopying协议，该协议允许他们接收copy方法。

最后，修改drawRect:方法：

 - (void)drawRect:(CGRect)rect {
     [[UIColor blackColor] set];
     for (BNRLine *line in self.finishedLines) {
         [self strokeLike:line];
     }
     [[UIColor redColor] set];
     for (NSValue *key in self.linesInProgress) {
         [self strokeLike:self.linesInProgress[key]];
     }
 }

　　最后，添加touchesCancelled:withEvent:方法。当一个触摸事件取消时，应将在linesInProgress中的线条全部移除。如下：

 - (void)touchesCancelled:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
     NSLog(@"%@", NSStringFromSelector(_cmd));
     for (UITouch *t in touches) {
         NSValue *key = [NSValue valueWithNonretainedObject:t];
         [self.linesInProgress removeObjectForKey:key];
     }
     [self setNeedsDisplay];
 }

程序代码：http://pan.baidu.com/s/1jGKYYt4