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
|
// Copyright 2014 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 CHROME_BROWSER_UI_TOOLBAR_TOOLBAR_ACTION_VIEW_CONTROLLER_H_
#define CHROME_BROWSER_UI_TOOLBAR_TOOLBAR_ACTION_VIEW_CONTROLLER_H_
#include "base/strings/string16.h"
#include "ui/gfx/image/image.h"
namespace content {
class WebContents;
}
namespace gfx {
class Size;
}
namespace ui {
class MenuModel;
}
class ToolbarActionViewDelegate;
// The basic controller class for an action that is shown on the toolbar -
// an extension action (like browser actions) or a component action (like
// chromecast).
class ToolbarActionViewController {
public:
virtual ~ToolbarActionViewController() {}
// Returns the unique ID of this particular action. For extensions, this is
// the extension id; for component actions, this is the name of the component.
virtual const std::string& GetId() const = 0;
// Sets the view delegate, which can handle most of the front-end logic.
virtual void SetDelegate(ToolbarActionViewDelegate* delegate) = 0;
// Returns the icon to use for the given |web_contents| and |size|.
virtual gfx::Image GetIcon(content::WebContents* web_contents,
const gfx::Size& size) = 0;
// Returns the name of the action, which can be separate from the accessible
// name or name for the tooltip.
virtual base::string16 GetActionName() const = 0;
// Returns the accessible name to use for the given |web_contents|.
virtual base::string16 GetAccessibleName(content::WebContents* web_contents)
const = 0;
// Returns the tooltip to use for the given |web_contents|.
virtual base::string16 GetTooltip(content::WebContents* web_contents)
const = 0;
// Returns true if the action should be enabled on the given |web_contents|.
virtual bool IsEnabled(content::WebContents* web_contents) const = 0;
// Returns true if the action wants to run, and should be popped out of the
// overflow menu on the given |web_contents|.
virtual bool WantsToRun(content::WebContents* web_contents) const = 0;
// Returns true if the action has a popup for the given |web_contents|.
virtual bool HasPopup(content::WebContents* web_contents) const = 0;
// Hides the current popup, if one is visible.
virtual void HidePopup() = 0;
// Returns the native view for the popup, if one is active.
virtual gfx::NativeView GetPopupNativeView() = 0;
// Returns the context menu model, or null if no context menu should be shown.
virtual ui::MenuModel* GetContextMenu() = 0;
// Called when a context menu has closed so the controller can perform any
// necessary cleanup.
virtual void OnContextMenuClosed() {}
// Returns true if this view can be dragged. This should only be true for
// extensions right now, since they are the only ones the model currently
// supports.
// TODO(devlin): Tweak the model so that it supports generic actions.
virtual bool CanDrag() const = 0;
// Executes the default action (which is typically showing the popup). If
// |by_user| is true, then this was through a direct user action (as oppposed
// to, e.g., an API call).
// Returns true if a popup is shown.
virtual bool ExecuteAction(bool by_user) = 0;
// Updates the current state of the action.
virtual void UpdateState() = 0;
// Returns true if clicking on an otherwise-disabled action should open the
// context menu.
virtual bool DisabledClickOpensMenu() const = 0;
// Registers an accelerator. Called when the view is added to the hierarchy.
// Unregistering any commands is the responsibility of the controller.
virtual void RegisterCommand() {
}
};
#endif // CHROME_BROWSER_UI_TOOLBAR_TOOLBAR_ACTION_VIEW_CONTROLLER_H_
|
