显示和管理编辑菜单 <- 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通知,并采取适当的行动。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,080评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,422评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,630评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,554评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,662评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,856评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,014评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,752评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,212评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,541评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,687评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,347评论 4 331
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,973评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,777评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,006评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,406评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,576评论 2 349

推荐阅读更多精彩内容