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
|
// Copyright (c) 2011 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_BUTTON_MENU_ITEM_MODEL_H_
#define UI_BASE_MODELS_BUTTON_MENU_ITEM_MODEL_H_
#include <vector>
#include "base/compiler_specific.h"
#include "base/component_export.h"
#include "base/macros.h"
#include "base/strings/string16.h"
#include "ui/base/accelerators/accelerator.h"
namespace ui {
// A model representing the rows of buttons that should be inserted in a button
// containing menu item.
class COMPONENT_EXPORT(UI_BASE) ButtonMenuItemModel {
public:
// Types of buttons.
enum ButtonType {
TYPE_SPACE,
TYPE_BUTTON,
TYPE_BUTTON_LABEL
};
class COMPONENT_EXPORT(UI_BASE) Delegate : public AcceleratorProvider {
public:
// Some command ids have labels that change over time.
virtual bool IsItemForCommandIdDynamic(int command_id) const;
virtual base::string16 GetLabelForCommandId(int command_id) const;
// Performs the action associated with the specified command id.
virtual void ExecuteCommand(int command_id, int event_flags) = 0;
virtual bool IsCommandIdEnabled(int command_id) const;
virtual bool DoesCommandIdDismissMenu(int command_id) const;
// AcceleratorProvider overrides:
// By default, returns false for all commands. Can be further overridden.
bool GetAcceleratorForCommandId(
int command_id,
ui::Accelerator* accelerator) const override;
protected:
~Delegate() override {}
};
ButtonMenuItemModel(int string_id, ButtonMenuItemModel::Delegate* delegate);
~ButtonMenuItemModel();
// Adds a button that will emit |command_id|. All buttons created through
// this method will have the same size, based on the largest button.
void AddGroupItemWithStringId(int command_id, int string_id);
// Adds a button that has an icon instead of a label. Note that the image
// itself must be separately configured by platform-specific code; this method
// simply serves to add a blank item in the menu with a specified
// |command_id|.
void AddImageItem(int command_id);
// Adds a non-clickable button with a desensitized label that doesn't do
// anything. Usually combined with IsItemForCommandIdDynamic() to add
// information.
void AddButtonLabel(int command_id, int string_id);
// Adds a small horizontal space.
void AddSpace();
// Returns the number of items for iteration.
int GetItemCount() const;
// Returns what kind of item is at |index|.
ButtonType GetTypeAt(int index) const;
// Changes a position into a command ID.
int GetCommandIdAt(int index) const;
// Whether the label for item |index| changes.
bool IsItemDynamicAt(int index) const;
// Gets the accelerator information for the specified index, returning true if
// there is a shortcut accelerator for the item, false otherwise.
bool GetAcceleratorAt(int index, ui::Accelerator* accelerator) const;
// Returns the current label value for the button at |index|.
base::string16 GetLabelAt(int index) const;
// If the button at |index| should have its size equalized along with all
// other items that have their PartOfGroup bit set.
bool PartOfGroup(int index) const;
// Called when the item at the specified index has been activated.
void ActivatedAt(int index);
// Returns the enabled state of the button at |index|.
bool IsEnabledAt(int index) const;
// Returns whether clicking on the button at |index| dismisses the menu.
bool DismissesMenuAt(int index) const;
// Returns the enabled state of the command specified by |command_id|.
bool IsCommandIdEnabled(int command_id) const;
// Returns whether clicking on |command_id| dismisses the menu.
bool DoesCommandIdDismissMenu(int command_id) const;
const base::string16& label() const { return item_label_; }
private:
// The non-clickable label to the left of the buttons.
base::string16 item_label_;
struct Item;
std::vector<Item> items_;
Delegate* delegate_;
DISALLOW_COPY_AND_ASSIGN(ButtonMenuItemModel);
};
} // namespace ui
#endif // UI_BASE_MODELS_BUTTON_MENU_ITEM_MODEL_H_
|
