blob: 6eb5d2e6524c5401343456aa50f7dc8beecff9ec (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
// Copyright 2013 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_BASE_COCOA_MENU_CONTROLLER_H_
#define UI_BASE_COCOA_MENU_CONTROLLER_H_
#import <Cocoa/Cocoa.h>
#include "base/component_export.h"
#include "base/mac/scoped_nsobject.h"
namespace ui {
class ColorProvider;
class MenuModel;
}
COMPONENT_EXPORT(UI_BASE)
@protocol MenuControllerCocoaDelegate
// Called as each item is created during menu or submenu creation.
- (void)controllerWillAddItem:(NSMenuItem*)menuItem
fromModel:(ui::MenuModel*)model
atIndex:(NSInteger)index
withColorProvider:(const ui::ColorProvider*)colorProvider;
// Called after all menu items in a menu or submenu are created.
- (void)controllerWillAddMenu:(NSMenu*)menu fromModel:(ui::MenuModel*)model;
@end
// A controller for the cross-platform menu model. The menu that's created
// has the tag and represented object set for each menu item. The object is a
// NSValue holding a pointer to the model for that level of the menu (to
// allow for hierarchical menus). The tag is the index into that model for
// that particular item. It is important that the model outlives this object
// as it only maintains weak references.
COMPONENT_EXPORT(UI_BASE)
@interface MenuControllerCocoa
: NSObject<NSMenuDelegate, NSUserInterfaceValidations>
// Note that changing this will have no effect if you use
// |-initWithModel:useWithPopUpButtonCell:| or after the first call to |-menu|.
@property(nonatomic, assign) BOOL useWithPopUpButtonCell;
// NIB-based initializer. This does not create a menu. Clients can set the
// properties of the object and the menu will be created upon the first call to
// |-maybeBuildWithColorProvider:| or |-menu|.
- (instancetype)init;
// Builds a NSMenu from the pre-built model (must not be nil). Changes made
// to the contents of the model after calling this will not be noticed. If
// the menu will be displayed by a NSPopUpButtonCell, it needs to be of a
// slightly different form (0th item is empty).
- (instancetype)initWithModel:(ui::MenuModel*)model
delegate:(id<MenuControllerCocoaDelegate>)delegate
colorProvider:(const ui::ColorProvider*)colorProvider
useWithPopUpButtonCell:(BOOL)useWithCell;
// Initializes the MenuControllerCocoa instance with the given parameters. This
// does not create create a menu, clients must call
// |-maybeBuildWithColorProvider:| or |-menu| first.
- (instancetype)initWithModel:(ui::MenuModel*)model
delegate:(id<MenuControllerCocoaDelegate>)delegate
useWithPopUpButtonCell:(BOOL)useWithCell;
// Builds a NSMenu with the supplied ColorProvider. Will no-op if the NSMenu
// already exists or the model has not been set.
- (void)maybeBuildWithColorProvider:(const ui::ColorProvider*)colorProvider;
// Programmatically close the constructed menu.
- (void)cancel;
- (ui::MenuModel*)model;
- (void)setModel:(ui::MenuModel*)model;
// Access to the constructed menu if the complex initializer was used. If the
// menu has not bee built yet it will be built on the first call.
- (NSMenu*)menu;
// Whether the menu is currently open.
- (BOOL)isMenuOpen;
@end
@interface MenuControllerCocoa (TestingAPI)
// Whether the NSMenu has been built.
- (BOOL)isMenuBuiltForTesting;
@end
#endif // UI_BASE_COCOA_MENU_CONTROLLER_H_
|
