显示和管理编辑菜单 <- iOS文本编程指南

编辑菜单是一种上下文菜单，它用来显示可执行的命令，例如文本视图或图片中的文字。编辑菜单是复制、剪切、以及粘贴操作的组成部分，它显示（可能的话）复制、剪切、粘贴、选择、以及选择全部命令。

管理选择和编辑菜单

想要在视图中复制或剪切什么，或用它来做其他事，其内容必须被选择。它可以是一定范围的文本、图片、URL、颜色、或者其他数据表示法，包括自定义对象。你必须自己管理视图中的选中对象。如果用户通过某些操作手势选择了视图中的对象、你必须处理该事件、内部记录所选内容（并取消之前的所选内容）、并可能在视图中直观的指示新的选择内容。如果你想在视图中实现对多个对象的复制-剪切-粘贴操作，你必须实现多选择内容（multiple-selection）行为。

注意：处理触摸事件的计数，包括使用手势识别器，在UIKit Apps的Event Handling Guide中讨论。

当app确定用户要求的编辑菜单（它可以用来处理所选内容）的时候，你应该通过完成以下步骤来显示菜单：

1. 调用UIMenuController的sharedMenuController类来获取全局的菜单控制器实例。
2. 计算选中内容的边界，并使用结果矩形来调用setTargetRect:inView:方法。编辑菜单在上面的矩形的上面或下面显示，取决于选中内容与屏幕的上沿和下沿的靠近程度。
3. 调用setMenuVisible:animated: 方法（两个参数都YES）来动态的在选中内容的上方或下方显示菜单。

图7-1说明了你应该如何在touchesEnded:withEvent:方法的实现中编辑菜单的显示，来处理复制、剪切、以及粘贴操作。（注意，该例子忽略了处理选择内容的代码。）该代码片段还显示了自定义视图给自己发送becomeFirstResponder消息来确保自己成为第一响应者，以便可以进行复制、剪切、以及粘贴操作。

代码清单7-1 显示编辑菜单

- (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event {
    UITouch *theTouch = [touches anyObject];

    if ([theTouch tapCount] == 2  && [self becomeFirstResponder]) {

        // selection management code goes here...

        // bring up edit menu.
        UIMenuController *theMenu = [UIMenuController sharedMenuController];
        CGRect selectionRect = CGRectMake (currentSelection.x, currentSelection.y, SIDE, SIDE);
        [theMenu setTargetRect:selectionRect inView:self];
        [theMenu setMenuVisible:YES animated:YES];

    }
}

菜单初始包含第一响应者具有的相应UIResponderStandardEditActions方法实现的所有命令（copy:, paste:等等）。但是，在菜单显示之前系统发送canPerformAction:withSender:给第一响应者，大很多情况下是自定义视图本身。在它的方法实现中，响应者评估当前上下文中是否应用命令。例如，如果选择器是paste:，并且在该视图类型的可以处理的剪贴板中就没有数据，响应者应该返回NO来阻止粘贴对象。如果响应者没有实现canPerformAction:withSender:方法，或者没有处理给定的命令，该消息会传递给响应者链。

代码清单7-2显示了canPerformAction:withSender:方法的实现，它寻找匹配cut:, copy:,和 paste: 选择器的消息；它基于当前选中内容启用或取消复制、剪切、以及粘贴菜单命令，对于粘贴，就是是否剪贴板中的内容。

代码清单7-2 有条件的启用菜单命令

- (BOOL)canPerformAction:(SEL)action withSender:(id)sender {
    BOOL retValue = NO;
    ColorTile *theTile = [self colorTileForOrigin:currentSelection];

    if (action == @selector(paste:) )
        retValue = (theTile == nil) &&
             [[UIPasteboard generalPasteboard] containsPasteboardTypes:
             [NSArray arrayWithObject:ColorTileUTI]];
    else if ( action == @selector(cut:) || action == @selector(copy:) )
        retValue = (theTile != nil);
    else
        retValue = [super canPerformAction:action withSender:sender];
    return retValue;
}

注意，方法中的最后一个else调用了超类的实现，以便给超类一个机会来处理子类忽略的命令。

注意，当采取行动的时候，菜单命令可以改变菜单命令的上下文。例如，如果用户选择视图中所有的对象，复制和剪切命令应该包含在菜单中。在这种情况下，响应者（在菜单仍可见的时候）可以调用菜单控制器的update方法；这导致第一响应者的canPerformAction:withSender:重新调用（reinvocation）。

添加自定义项目到编辑菜单

你可以添加自定义项目到编辑菜单。当用户点击该项目时，对当前应用程序的目标有影响的命令被发出。UIKit框架通过目标动作机制来实现。一个项目的点击导致动作消息被发送给能够处理该消息的响应者链中的第一响应者。图7-1展示了自定义菜单项目（改变颜色，Change Color）的例子。

图 7-1 带有自定义菜单项目的编辑菜单

UIMenuItem类的实例代表自定义菜单项目。UIMenuItem对象有两个属性，标题和动作选择器，你可以在任何时间改变它们。为了实现自定义菜单项目，你必须使用这些属性初始化一个UIMenuItem实例，把这个实例添加到菜单控制器的自定义菜单项目数组中，并且实现动作方法来处理恰当的响应者子类的命令。

实现自定义菜单项目其他方面，通常是以全代码的方式使用UIMenuController单例对象。在自定义或重写视图中，你设置该视图为第一响应者、获取共享的菜单控制器、设置目标矩形、然后调用setMenuVisible:animated:来显示菜单。代码清单7-3中的简单例子，添加了一个自定义菜单项目，用红黑两种颜色改变自定义视图的颜色。

代码清单 7-3 实现改变颜色的菜单项目

- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {}
- (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event {}
- (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event {
    UITouch *theTouch = [touches anyObject];
    if ([theTouch tapCount] == 2) {
        [self becomeFirstResponder];
        UIMenuItem *menuItem = [[UIMenuItem alloc] initWithTitle:@"Change Color" action:@selector(changeColor:)];
        UIMenuController *menuCont = [UIMenuController sharedMenuController];
        [menuCont setTargetRect:self.frame inView:self.superview];
        menuCont.arrowDirection = UIMenuControllerArrowLeft;
        menuCont.menuItems = [NSArray arrayWithObject:menuItem];
        [menuCont setMenuVisible:YES animated:YES];
    }
}
- (void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event {}

- (BOOL)canBecomeFirstResponder { return YES; }

- (void)changeColor:(id)sender {
    if ([self.viewColor isEqual:[UIColor blackColor]]) {
        self.viewColor = [UIColor redColor];
    } else {
        self.viewColor = [UIColor blackColor];
    }
    [self setNeedsDisplay];
}

注意：代码清单7-3中的UIMenuController的arrowDirection属性，允许你指定尖头的方向，让它指向目标矩形。

关闭编辑菜单

当你的系统或者地定义命令实现返回的时候，编辑菜单自动隐藏。你可以使用下面这行代码让它继续存在：

[UIMenuController sharedMenuController].menuVisible = YES;

系统可以在任何时候隐藏编辑菜单。例如，它可以在一个警告框显示或者用户点击屏幕的任何位置的时候隐藏。如果你有状态、或显示是基于编辑菜单是否可见，那么你应该监听UIMenuControllerWillHideMenuNotification通知，并采取适当的行动。