iOS苹果自带UIMenuController

Posted 2020-09-27 chennet

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了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

以上是关于iOS苹果自带UIMenuController的主要内容，如果未能解决你的问题，请参考以下文章

iOS 共享 UIMenuController 可能会缓存 UIMenuItem

iOS UIMenuController

如何在 iOS 5 中隐藏 UIMenuController

iOS：如何从 UIMenuController 获取选定的 UIMenuItem

在 iOS 的 UIMenuController 开头附加自定义 UIMenuItems

如何从 iOS 的 UIMenuController 中删除默认的 UIMenuItem？