iOS苹果自带UIMenuController

一、UIMenuController认识

• 1.默认情况下，UITextView / UITextFiled / UIWebView 都有苹果自带的有UIMenuController功能

• 2.UITextFiled 的弹出菜单效果系统自带的

      

   

• 3.当然，系统只给某些控件提供的该功能，但是我们自己给可以给指定控件添加该功能效果，至于如何添加，我们先简单学习一下，如何使用系统提供的UIMenuController功能

二、UIMenuController基本使用

• 如何学UIMenuController使用，查看头文件是最直接的方式了。

 

• 可得：UIMenuController继承NSObject；我们可以自定义；通过sharedMenuController获取单例对象；必须手动设置弹窗菜单可见；指定弹窗相对哪个View的哪个位置显示;指定其显示方向（上下左右）；指定Item多个（数组）；而且可以指定menuFrame；不仅如此，系统也提供了可以监听menu的通知（即将显示/完全显示、即将隐藏/完全隐藏、menu的frame改变）

• 1.获得菜单 menu

• 　　UIMenuController *menu = [UIMenuController sharedMenuController];
  

• 2.设置菜单最终显示的位置

•  // 菜单最终显示的位置
    CGRect rect = CGRectMake(100, 100, 100, 100);
    [menu setTargetRect:rect inView:self.label];
    /*
     targetRect：menuController指向的矩形框
     targetView：targetRect以targetView的左上角为坐标原点
     */

• 3.手动设置需要，显示菜单

• // 显示菜单
  [menu setMenuVisible:YES animated:YES];

• 4.必须要得通过第一响应者，来告诉MenuController它内部应该显示什么内容

  • 4.1 那如何告诉显示内容呢？
    • 让第一响应者，实现下面方法，来告诉显示内容，监听哪些操作action

• /**
  * 通过这个方法告诉UIMenuController它内部应该显示什么内容
  * 返回YES，就代表支持action这个操作
  */
  - (BOOL)canPerformAction:(SEL)action withSender:(id)sender
  {
    NSLog(@"%@", NSStringFromSelector(action));
     if (action == @selector(cut:)
        || action == @selector(copy:)
        || action == @selector(paste:)) {
        return YES; // YES ->  代表我们只监听 cut: / copy: / paste:方法
    }
    return NO; // 除了上面的操作，都不支持
  }

• // 打印如下：

  2017-07-08 11:01:34.607 MenuController[2259:24945] -----cut:

  2017-07-08 11:01:34.607 MenuController[2259:24945] -----copy:

  2017-07-08 11:01:34.608 MenuController[2259:24945] -----select:

  2017-07-08 11:01:34.608 MenuController[2259:24945] -----selectAll:

  2017-07-08 11:01:34.608 MenuController[2259:24945] -----paste:

  2017-07-08 11:01:34.609 MenuController[2259:24945] -----delete:

  2017-07-08 11:01:34.609 MenuController[2259:24945] -----_promptForReplace:

  2017-07-08 11:01:34.609 MenuController[2259:24945] -----_transliterateChinese:

  2017-07-08 11:01:34.610 MenuController[2259:24945] -----_showTextStyleOptions:

  2017-07-08 11:01:34.610 MenuController[2259:24945] -----_lookup:

  2017-07-08 11:01:34.610 MenuController[2259:24945] -----_define:

  2017-07-08 11:01:34.610 MenuController[2259:24945] -----_addShortcut:

  2017-07-08 11:01:34.610 MenuController[2259:24945] -----_accessibilitySpeak:

  2017-07-08 11:01:34.610 MenuController[2259:24945] -----_accessibilitySpeakLanguageSelection:

  2017-07-08 11:01:34.611 MenuController[2259:24945] -----_accessibilityPauseSpeaking:

  2017-07-08 11:01:34.611 MenuController[2259:24945] -----_share:

  2017-07-08 11:01:34.611 MenuController[2259:24945] -----makeTextWritingDirectionRightToLeft:

  2017-07-08 11:01:34.611 MenuController[2259:24945] -----makeTextWritingDirectionLeftToRight:

  • 4.2 设置第一响应者
    • 前提是：必须要有第一响应者，让第一响应者，实现上面方法，告诉显示什么内容。实现下面方法，可以让某个视图或者控制器，成为第一响应者： canBecomeFirstResponder方法。

• 

  /**
  * 说明控制器可以成为第一响应者
  */
  - (BOOL)canBecomeFirstResponder
  {
    return YES;
  }

  

• 5.实现监听菜单内容的对应的action方法

•  - (void)cut:(UIMenuController *)menu
  {
      NSLog(@"%s %@", __func__, menu);
  }
  
  - (void)copy:(UIMenuController *)menu
  {
      NSLog(@"%s %@", __func__, menu);
  }
  
  - (void)paste:(UIMenuController *)menu
  {
      NSLog(@"%s %@", __func__, menu);
  }

• 6.当然，我们还可以监听到menu菜单的显示与隐藏与frame改变的通知.

  • 如下：监听menu即将显示的通知

  • • 6.当然，我们还可以监听到menu菜单的显示与隐藏与frame改变的通知.

      • 如下：监听menu即将显示的通知

        • 1.注册通知监听

          // 注册监听 菜单即将显示 通知
          [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(show:) name:UIMenuControllerWillShowMenuNotification object:nil];

        • 2.实现监听到menu菜单显示调用方法

        // 指定 menu 弹出菜单显示什么 内容 ，默认 NO 都不显示

        - (BOOL)canPerformAction:(SEL)action withSender:(id)sender{

        return NO;

        }

        • 3.dealloc方法中，移除通知监听

        - (void)dealloc{
           // 移除监听通知
          [[NSNotificationCenter defaultCenter] removeObserver:self];
        }

  • 7.当然系统提供的menuItem的标题，默认是英文的，我们可以设置menu支持中文，显示中文 ->修改软件应用支持中文
• 

  Snip20151028_12.png

• 8.那么如何自定义meun显示自己定义的文字

  • 解决方案：查看UIMenuController的头文件，我们发现有个属性menuItems数组，通过它我们可以增加额外的菜单项。

注意：

• 1.创建只能通过[UIMenuController sharedMenuController];单例方式获取，不能通过init方式创建，否则报如下错误

 // 获得菜单 -> 回报如下错误
UIMenuController *menu = [[UIMenuController alloc] init]; 

 Terminating app due to uncaught exception 'NSInternalInconsistencyException',
 reason: 'There can only be one UIMenuController instance.'

三、应用

1. 如何给Label添加UIMenuController功能

• 1.设置UILabel允许交互
• 2.给UILabel添加手势，
• 3.在UILabel手势监听方法中，创建UIMenuController-》menu
• 4.设置menu位置，利用UIMenuController的对象方法setTargetRect: inView:方法来设置menu显示在在那个控件的那个位置
• 6.显示menu, -》 menu setMenuVisible: animation:
• 7.设置menu显示内容
  • 注意：得通过第一响应者，来告诉menu它内部显示什么内容。如果显示中文标题，就需要手动设置APP支持中文
  • 实现：
    • 7.1让label成为第一响应者（注意：不一定第一响应者必须是控制器）
    • 7.2设置menu显示menuItem，告诉menu可以显示什么内容

• - (void)awakeFromNib
  {
     // 给Label添加手机
     [self addGestureRecognizer:[[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(labelClick)]];
  }
  
  -  (void)initWithFrame:(CGRect)rect{
     if(self = [super initWithFrame:rect]){
        // 给Label添加手机
        [self addGestureRecognizer:[[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(labelClick)]];
     }
  }
  - (void)labelClick
  {
      // 让label成为第一响应者
      [self becomeFirstResponder];
  
      // 获得菜单
      UIMenuController *menu = [UIMenuController sharedMenuController];
  
      // 设置菜单内容，显示中文，所以要手动设置app支持中文
      menu.menuItems = @[
                         [[UIMenuItem alloc] initWithTitle:@"顶" action:@selector(ding:)],
                         [[UIMenuItem alloc] initWithTitle:@"回复" action:@selector(reply:)],
                         [[UIMenuItem alloc] initWithTitle:@"举报" action:@selector(warn:)]
                         ];
  
      // 菜单最终显示的位置
      [menu setTargetRect:self.bounds inView:self];
  
      // 显示菜单
      [menu setMenuVisible:YES animated:YES];
  }
  
  #pragma mark - UIMenuController相关
  /**
   * 让Label具备成为第一响应者的资格
   */
  - (BOOL)canBecomeFirstResponder
  {
      return YES;
  }
  
  /**
   * 通过第一响应者的这个方法告诉UIMenuController可以显示什么内容
   */
  - (BOOL)canPerformAction:(SEL)action withSender:(id)sender
  {
      if ( (action == @selector(copy:) && self.text) // 需要有文字才能支持复制
          || (action == @selector(cut:) && self.text) // 需要有文字才能支持剪切
          || action == @selector(paste:)
          || action == @selector(ding:)
          || action == @selector(reply:)
          || action == @selector(warn:)) return YES;
  
      return NO;
  }
  
  #pragma mark - 监听MenuItem的点击事件
  - (void)cut:(UIMenuController *)menu
  {
      // 将label的文字存储到粘贴板
      [UIPasteboard generalPasteboard].string = self.text;
      // 清空文字
      self.text = nil;
  }
  
  - (void)copy:(UIMenuController *)menu
  {
      // 将label的文字存储到粘贴板
      [UIPasteboard generalPasteboard].string = self.text;
  }
  
  - (void)paste:(UIMenuController *)menu
  {
      // 将粘贴板的文字赋值给label
      self.text = [UIPasteboard generalPasteboard].string;
  }
  
  - (void)ding:(UIMenuController *)menu
  {
      NSLog(@"%s %@", __func__, menu);
  }
  
  - (void)reply:(UIMenuController *)menu
  {
      NSLog(@"%s %@", __func__, menu);
  }
  
  - (void)warn:(UIMenuController *)menu
  {
      NSLog(@"%s %@", __func__, menu);
  }
  @end