MacOS 开发 - 状态栏 NSStatusBar & NSStatusItem

编程乐园

已于 2023-07-12 17:27:59 修改

阅读量7.2k

点赞数 3

分类专栏： Apple开发文章标签： tooltip popover menu NSStatusItem 状态栏

于 2019-04-07 18:41:38 首次发布

本文链接：https://blog.csdn.net/lovechris00/article/details/78011718

版权

Apple开发专栏收录该内容

142 篇文章

订阅专栏

本文详细介绍如何在Mac上创建状态栏应用，包括初始化状态栏图标、设置提示文本、添加点击事件监听、集成弹出窗口(popover)及下拉菜单等功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

简介

官方对菜单栏的解释：
在这里插入图片描述

开发上为了方便喜欢直接叫左侧的 应用菜单 叫做菜单栏，右侧的 状态菜单 叫做状态栏。

创建和使用

1、在 AppDelegate.m 中持有这个变量。

@property (nonatomic,strong) NSStatusItem *statusItem; //必须应用、且强引用，否则不会显示。

2、在 applicationDidFinishLaunching 中初始化

注意 length 应选择 NSSquareStatusItemLength，否则不显示。NSVariableStatusItemLength 用于自定义 statusItem, 见本文第 6 部分。
状态栏高度为22，请注意图片尺寸。
setHighlightMode, YES-有高亮效果（蓝色背景色）,NO - 点击时和没点击，没什么特别效果。

- (void)addStatusItem{
    
    //获取系统单例NSStatusBar对象
    NSStatusBar *statusBar = [NSStatusBar systemStatusBar];
    
    NSStatusItem *statusItem = [statusBar statusItemWithLength: NSSquareStatusItemLength];
    
    self.statusItem = statusItem;
    
    [statusItem setHighlightMode:YES];
    [statusItem setImage: [NSImage imageNamed:@"swift18"]]; //设置图标，请注意尺寸
    }

2.1 设置 toolTip

toolTip 为鼠标悬停在 item 上面时的提示文字
[statusItem setToolTip:@"这是一个 ToolTip"];

tooltip

tooltip 多文字时

3、给 statusItem 添加监听 setAction

[statusItem setAction:@selector(statusOnClick:)];

- (void)statusOnClick:(NSStatusItem *)item{

    NSLog(@"statusOnClick ----- ");
 }

4、NSStatusBarButton & 给 statusItem 添加 popover

NSStatusItem 添加 popover

4.1 初始化 popOver
具体可参考：http://blog.csdn.net/lovechris00/article/details/77996141


@property(nonatomic,strong) NSPopover *firstPopover;
@property(nonatomic,strong) FirstViewController * firstVC;

- (NSPopover *)firstPopover
{
    if(!_firstPopover)
    {
        _firstPopover=[[NSPopover alloc]init];
        
        _firstPopover.appearance = [NSAppearance appearanceNamed:NSAppearanceNameAqua];
        
        _firstPopover.contentViewController = self.firstVC;
        _firstPopover.behavior = NSPopoverBehaviorTransient;
        
    }
    return _firstPopover;
}

- (FirstViewController *)firstVC
{
    if(!_firstVC)
    {
        _firstVC=[[FirstViewController alloc]init];
    }
    return _firstVC;
}

4.2 popover 弹出时，必须showRelativeToRect，我们无法获取 statusItem.bounds。
经过查看，statusItem 内部有个 .button，类型为 NSStatusBarButton，所以给这个 button 添加监听方法。

[statusItem.button setAction:@selector(statusButtonOnClick:)];

- (void)statusButtonOnClick:(NSButton *)btn{
    
    NSLog(@"statusButtonOnClick ----- ");
    
    [self.firstPopover showRelativeToRect:[btn bounds] ofView:btn preferredEdge:NSRectEdgeMaxY]; 
}

4.3 聪明的同学可能到这里会质疑，statusItem 和 statusItem.button 都绑定 action，那调用哪一个呢？
答：最先绑定的哪个，被后面那个覆盖。

5、添加NSMenu

NSStatusItem 添加 menu

5.1 初始化 menu
可参考博文：http://blog.csdn.net/lovechris00/article/details/78002161

 NSMenu *subMenu = [[NSMenu alloc] initWithTitle:@"Load_TEXT"];
    
    [subMenu addItemWithTitle:@"Load1"action:@selector(load1) keyEquivalent:@"E"];
    [subMenu addItemWithTitle:@"Load2"action:@selector(load2) keyEquivalent:@"R"];
    
- (void)load1{
    NSLog(@"load1 ---- ");
}

- (void)load2{
    NSLog(@"load1 ---- ");
}

5.2 绑定 NSStatusItem 和 menu

statusItem.menu = subMenu;

5.3 如果同时绑定 menu，有绑定 action 方法来调用 popover，会咋样？
答：经过测试，无论代码添加顺序，添加 menu成功，绑定两个 action都失败。不调用action 中的方法，也就不会弹出 popover。

6、自定义 item 样式 - setView

6.1 statusItemWithLength 的样式要改为 NSVariableStatusItemLength

6.2 初始化自定义的 view，并使用 setView 绑定。

NSView *customerView = [[NSView alloc]initWithFrame:NSMakeRect(0, 0, 30, 5)];
    customerView.wantsLayer = YES;
    customerView.layer.backgroundColor = [NSColor redColor].CGColor;
    [statusItem setView: customerView];