src/ash/launcher/launcher_button.h

   1 // Copyright (c) 2012 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 ASH_LAUNCHER_LAUNCHER_BUTTON_H_
   6 #define ASH_LAUNCHER_LAUNCHER_BUTTON_H_
   7
   8 #include "ash/ash_export.h"
   9 #include "ui/gfx/shadow_value.h"
  10 #include "ui/views/controls/button/custom_button.h"
  11 #include "ui/views/controls/image_view.h"
  12
  13 namespace ash {
  14 namespace internal {
  15
  16 class LauncherButtonHost;
  17 class ShelfLayoutManager;
  18
  19 // Button used for items on the launcher, except for the AppList.
  20 class ASH_EXPORT LauncherButton : public views::CustomButton {
  21  public:
  22   // Used to indicate the current state of the button.
  23   enum State {
  24     // Nothing special. Usually represents an app shortcut item with no running
  25     // instance.
  26     STATE_NORMAL    = 0,
  27     // Button has mouse hovering on it.
  28     STATE_HOVERED   = 1 << 0,
  29     // Underlying LauncherItem has a running instance.
  30     STATE_RUNNING   = 1 << 1,
  31     // Underlying LauncherItem is active (i.e. has focus).
  32     STATE_ACTIVE    = 1 << 2,
  33     // Underlying LauncherItem needs user's attention.
  34     STATE_ATTENTION = 1 << 3,
  35     STATE_FOCUSED   = 1 << 4,
  36     // Hide the status (temporarily for some animations).
  37     STATE_HIDDEN = 1 << 5,
  38   };
  39
  40   virtual ~LauncherButton();
  41
  42   // Called to create an instance of a LauncherButton.
  43   static LauncherButton* Create(views::ButtonListener* listener,
  44                                 LauncherButtonHost* host,
  45                                 ShelfLayoutManager* shelf_layout_manager);
  46
  47   // Sets the image to display for this entry.
  48   void SetImage(const gfx::ImageSkia& image);
  49
  50   // Retrieve the image to show proxy operations.
  51   const gfx::ImageSkia& GetImage() const;
  52
  53   // |state| is or'd into the current state.
  54   void AddState(State state);
  55   void ClearState(State state);
  56   int state() const { return state_; }
  57   const ShelfLayoutManager* shelf_layout_manager() const {
  58     return shelf_layout_manager_;
  59   }
  60
  61   // Returns the bounds of the icon.
  62   gfx::Rect GetIconBounds() const;
  63
  64   // Overrides to views::CustomButton:
  65   virtual void ShowContextMenu(const gfx::Point& p,
  66                                ui::MenuSourceType source_type) OVERRIDE;
  67
  68   // View override - needed by unit test.
  69   virtual void OnMouseCaptureLost() OVERRIDE;
  70
  71  protected:
  72   LauncherButton(views::ButtonListener* listener,
  73                  LauncherButtonHost* host,
  74                  ShelfLayoutManager* shelf_layout_manager);
  75
  76   // Class that draws the icon part of a button, so it can be animated
  77   // independently of the rest. This can be subclassed to provide a custom
  78   // implementation, by overriding CreateIconView().
  79   class IconView : public views::ImageView {
  80    public:
  81     IconView();
  82     virtual ~IconView();
  83
  84     void set_icon_size(int icon_size) { icon_size_ = icon_size; }
  85     int icon_size() const { return icon_size_; }
  86
  87     // views::View overrides.
  88     virtual bool HitTestRect(const gfx::Rect& rect) const OVERRIDE;
  89
  90    private:
  91     // Set to non-zero to force icons to be resized to fit within a square,
  92     // while maintaining original proportions.
  93     int icon_size_;
  94
  95     DISALLOW_COPY_AND_ASSIGN(IconView);
  96   };
  97
  98   // View overrides:
  99   virtual bool OnMousePressed(const ui::MouseEvent& event) OVERRIDE;
 100   virtual void OnMouseReleased(const ui::MouseEvent& event) OVERRIDE;
 101   virtual bool OnMouseDragged(const ui::MouseEvent& event) OVERRIDE;
 102   virtual void OnMouseMoved(const ui::MouseEvent& event) OVERRIDE;
 103   virtual void OnMouseEntered(const ui::MouseEvent& event) OVERRIDE;
 104   virtual void OnMouseExited(const ui::MouseEvent& event) OVERRIDE;
 105   virtual void GetAccessibleState(ui::AccessibleViewState* state) OVERRIDE;
 106   virtual void Layout() OVERRIDE;
 107   virtual void ChildPreferredSizeChanged(views::View* child) OVERRIDE;
 108   virtual void OnFocus() OVERRIDE;
 109   virtual void OnBlur() OVERRIDE;
 110
 111   // ui::EventHandler overrides:
 112   virtual void OnGestureEvent(ui::GestureEvent* event) OVERRIDE;
 113
 114   // Sets the icon image with a shadow.
 115   void SetShadowedImage(const gfx::ImageSkia& bitmap);
 116   // Override for custom initialization.
 117   virtual void Init();
 118   // Override to subclass IconView.
 119   virtual IconView* CreateIconView();
 120   IconView* icon_view() const { return icon_view_; }
 121   LauncherButtonHost* host() const { return host_; }
 122
 123  private:
 124   class BarView;
 125
 126   // Returns true if the shelf is horizontal. If this returns false the shelf is
 127   // vertical.
 128   bool IsShelfHorizontal() const;
 129
 130   // Updates the parts of the button to reflect the current |state_| and
 131   // alignment. This may add or remove views, layout and paint.
 132   void UpdateState();
 133
 134   // Updates the status bar (bitmap, orientation, visibility).
 135   void UpdateBar();
 136
 137   LauncherButtonHost* host_;
 138   IconView* icon_view_;
 139   // Draws a bar underneath the image to represent the state of the application.
 140   BarView* bar_;
 141   // The current state of the application, multiple values of AppState are or'd
 142   // together.
 143   int state_;
 144
 145   ShelfLayoutManager* shelf_layout_manager_;
 146
 147   gfx::ShadowValues icon_shadows_;
 148
 149   // If non-null the destuctor sets this to true. This is set while the menu is
 150   // showing and used to detect if the menu was deleted while running.
 151   bool* destroyed_flag_;
 152
 153   DISALLOW_COPY_AND_ASSIGN(LauncherButton);
 154 };
 155
 156 }  // namespace internal
 157 }  // namespace ash
 158
 159 #endif  // ASH_LAUNCHER_LAUNCHER_BUTTON_H_