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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
// Copyright (c) 2012 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_MODELS_MENU_MODEL_H_
#define UI_BASE_MODELS_MENU_MODEL_H_
#include <string>
#include "base/component_export.h"
#include "base/memory/weak_ptr.h"
#include "ui/base/models/menu_model_delegate.h"
#include "ui/base/models/menu_separator_types.h"
#include "ui/gfx/native_widget_types.h"
namespace gfx {
class FontList;
}
namespace ui {
class Accelerator;
class ButtonMenuItemModel;
class ImageModel;
// An interface implemented by an object that provides the content of a menu.
class COMPONENT_EXPORT(UI_BASE) MenuModel
: public base::SupportsWeakPtr<MenuModel> {
public:
// The type of item.
enum ItemType {
TYPE_COMMAND, // Performs an action when selected.
TYPE_CHECK, // Can be selected/checked to toggle a boolean state.
TYPE_RADIO, // Can be selected/checked among a group of choices.
TYPE_SEPARATOR, // Shows a horizontal line separator.
TYPE_BUTTON_ITEM, // Shows a row of buttons.
TYPE_SUBMENU, // Presents a submenu within another menu.
TYPE_ACTIONABLE_SUBMENU, // A SUBMENU that is also a COMMAND.
TYPE_HIGHLIGHTED, // Performs an action when selected, and has a different
// colored background. When placed at the bottom, the
// background matches the menu's rounded corners.
TYPE_TITLE, // Plain text that does not perform any action when
// selected.
};
MenuModel();
virtual ~MenuModel();
// Returns true if any of the items within the model have icons. Not all
// platforms support icons in menus natively and so this is a hint for
// triggering a custom rendering mode.
virtual bool HasIcons() const = 0;
// Returns the number of items in the menu.
virtual int GetItemCount() const = 0;
// Returns the type of item at the specified index.
virtual ItemType GetTypeAt(int index) const = 0;
// Returns the separator type at the specified index.
virtual ui::MenuSeparatorType GetSeparatorTypeAt(int index) const = 0;
// Returns the command id of the item at the specified index.
virtual int GetCommandIdAt(int index) const = 0;
// Returns the label of the item at the specified index.
virtual std::u16string GetLabelAt(int index) const = 0;
// Returns the secondary label of the item at the specified index. Secondary
// label is shown below the label.
virtual std::u16string GetSecondaryLabelAt(int index) const;
// Returns the minor text of the item at the specified index. The minor text
// is rendered to the right of the label and using the font GetLabelFontAt().
virtual std::u16string GetMinorTextAt(int index) const;
// Returns the minor icon of the item at the specified index. The minor icon
// is rendered to the left of the minor text.
virtual ImageModel GetMinorIconAt(int index) const;
// Returns true if the menu item (label/sublabel/icon) at the specified
// index can change over the course of the menu's lifetime. If this function
// returns true, the label, sublabel and icon of the menu item will be
// updated each time the menu is shown.
virtual bool IsItemDynamicAt(int index) const = 0;
// Returns whether the menu item at the specified index has a user-set title,
// in which case it should always be treated as plain text.
virtual bool MayHaveMnemonicsAt(int index) const;
// Returns the font list used for the label at the specified index.
// If NULL, then the default font list should be used.
virtual const gfx::FontList* GetLabelFontListAt(int index) const;
// Gets the accelerator information for the specified index, returning true if
// there is a shortcut accelerator for the item, false otherwise.
virtual bool GetAcceleratorAt(int index,
ui::Accelerator* accelerator) const = 0;
// Returns the checked state of the item at the specified index.
virtual bool IsItemCheckedAt(int index) const = 0;
// Returns the id of the group of radio items that the item at the specified
// index belongs to.
virtual int GetGroupIdAt(int index) const = 0;
// Gets the icon for the item at the specified index. ImageModel is empty if
// there is no icon.
virtual ImageModel GetIconAt(int index) const = 0;
// Returns the model for a menu item with a line of buttons at |index|.
virtual ButtonMenuItemModel* GetButtonMenuItemAt(int index) const = 0;
// Returns the enabled state of the item at the specified index.
virtual bool IsEnabledAt(int index) const = 0;
// Returns true if the menu item is visible.
virtual bool IsVisibleAt(int index) const;
// Returns true if the item is rendered specially to draw attention
// for in-product help.
virtual bool IsAlertedAt(int index) const;
// Returns true if the menu item grants access to a new feature that we want
// to show off to users (items marked as new will receive a "New" badge when
// the appropriate flag is enabled).
virtual bool IsNewFeatureAt(int index) const;
// Returns the model for the submenu at the specified index.
virtual MenuModel* GetSubmenuModelAt(int index) const = 0;
// Called when the item at the specified index has been activated.
virtual void ActivatedAt(int index) = 0;
// Called when the item has been activated with given event flags.
// (for the case where the activation involves a navigation).
// |event_flags| is a bit mask of ui::EventFlags.
virtual void ActivatedAt(int index, int event_flags);
// Called when the menu is about to be shown.
virtual void MenuWillShow() {}
// Called when the menu is about to be closed. The MenuRunner, and |this|
// should not be deleted here.
virtual void MenuWillClose() {}
// Set the MenuModelDelegate, owned by the caller of this function. We allow
// setting a new one or clearing the current one.
void SetMenuModelDelegate(MenuModelDelegate* delegate);
// Gets the MenuModelDelegate.
MenuModelDelegate* menu_model_delegate() { return menu_model_delegate_; }
const MenuModelDelegate* menu_model_delegate() const {
return menu_model_delegate_;
}
// Retrieves the model and index that contains a specific command id. Returns
// true if an item with the specified command id is found. |model| is inout,
// and specifies the model to start searching from.
static bool GetModelAndIndexForCommandId(int command_id,
MenuModel** model,
int* index);
private:
// MenuModelDelegate. Weak. Could be null.
MenuModelDelegate* menu_model_delegate_;
};
} // namespace ui
#endif // UI_BASE_MODELS_MENU_MODEL_H_
|
