chrome/browser/ui/toolbar/toolbar_action_view_controller.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_UI_TOOLBAR_TOOLBAR_ACTION_VIEW_CONTROLLER_H_
   6 #define CHROME_BROWSER_UI_TOOLBAR_TOOLBAR_ACTION_VIEW_CONTROLLER_H_
   7
   8 #include "base/strings/string16.h"
   9 #include "ui/gfx/image/image.h"
  10
  11 namespace content {
  12 class WebContents;
  13 }
  14
  15 namespace gfx {
  16 class Size;
  17 }
  18
  19 namespace ui {
  20 class MenuModel;
  21 }
  22
  23 class ToolbarActionViewDelegate;
  24
  25 // The basic controller class for an action that is shown on the toolbar -
  26 // an extension action (like browser actions) or a component action (like
  27 // chromecast).
  28 class ToolbarActionViewController {
  29  public:
  30   virtual ~ToolbarActionViewController() {}
  31
  32   // Returns the unique ID of this particular action. For extensions, this is
  33   // the extension id; for component actions, this is the name of the component.
  34   virtual const std::string& GetId() const = 0;
  35
  36   // Sets the view delegate, which can handle most of the front-end logic.
  37   virtual void SetDelegate(ToolbarActionViewDelegate* delegate) = 0;
  38
  39   // Returns the icon to use for the given |web_contents| and |size|.
  40   virtual gfx::Image GetIcon(content::WebContents* web_contents,
  41                              const gfx::Size& size) = 0;
  42
  43   // Returns the name of the action, which can be separate from the accessible
  44   // name or name for the tooltip.
  45   virtual base::string16 GetActionName() const = 0;
  46
  47   // Returns the accessible name to use for the given |web_contents|.
  48   virtual base::string16 GetAccessibleName(content::WebContents* web_contents)
  49       const = 0;
  50
  51   // Returns the tooltip to use for the given |web_contents|.
  52   virtual base::string16 GetTooltip(content::WebContents* web_contents)
  53       const = 0;
  54
  55   // Returns true if the action should be enabled on the given |web_contents|.
  56   virtual bool IsEnabled(content::WebContents* web_contents) const = 0;
  57
  58   // Returns true if the action wants to run, and should be popped out of the
  59   // overflow menu on the given |web_contents|.
  60   virtual bool WantsToRun(content::WebContents* web_contents) const = 0;
  61
  62   // Returns true if the action has a popup for the given |web_contents|.
  63   virtual bool HasPopup(content::WebContents* web_contents) const = 0;
  64
  65   // Hides the current popup, if one is visible.
  66   virtual void HidePopup() = 0;
  67
  68   // Returns the native view for the popup, if one is active.
  69   virtual gfx::NativeView GetPopupNativeView() = 0;
  70
  71   // Returns the context menu model, or null if no context menu should be shown.
  72   virtual ui::MenuModel* GetContextMenu() = 0;
  73
  74   // Called when a context menu has closed so the controller can perform any
  75   // necessary cleanup.
  76   virtual void OnContextMenuClosed() {}
  77
  78   // Returns true if this view can be dragged. This should only be true for
  79   // extensions right now, since they are the only ones the model currently
  80   // supports.
  81   // TODO(devlin): Tweak the model so that it supports generic actions.
  82   virtual bool CanDrag() const = 0;
  83
  84   // Executes the default action (which is typically showing the popup). If
  85   // |by_user| is true, then this was through a direct user action (as oppposed
  86   // to, e.g., an API call).
  87   // Returns true if a popup is shown.
  88   virtual bool ExecuteAction(bool by_user) = 0;
  89
  90   // Updates the current state of the action.
  91   virtual void UpdateState() = 0;
  92
  93   // Returns true if clicking on an otherwise-disabled action should open the
  94   // context menu.
  95   virtual bool DisabledClickOpensMenu() const = 0;
  96
  97   // Registers an accelerator. Called when the view is added to the hierarchy.
  98   // Unregistering any commands is the responsibility of the controller.
  99   virtual void RegisterCommand() {
 100   }
 101 };
 102
 103 #endif  // CHROME_BROWSER_UI_TOOLBAR_TOOLBAR_ACTION_VIEW_CONTROLLER_H_