ui/app_list/views/app_list_item_view.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 UI_APP_LIST_VIEWS_APP_LIST_ITEM_VIEW_H_
   6 #define UI_APP_LIST_VIEWS_APP_LIST_ITEM_VIEW_H_
   7
   8 #include <string>
   9
  10 #include "base/memory/ref_counted.h"
  11 #include "base/memory/scoped_ptr.h"
  12 #include "base/timer/timer.h"
  13 #include "ui/app_list/app_list_export.h"
  14 #include "ui/app_list/app_list_item_observer.h"
  15 #include "ui/app_list/views/cached_label.h"
  16 #include "ui/gfx/shadow_value.h"
  17 #include "ui/views/context_menu_controller.h"
  18 #include "ui/views/controls/button/custom_button.h"
  19
  20 class SkBitmap;
  21
  22 namespace views {
  23 class ImageView;
  24 class Label;
  25 class MenuRunner;
  26 }
  27
  28 namespace app_list {
  29
  30 class AppListItem;
  31 class AppsGridView;
  32 class ProgressBarView;
  33
  34 class APP_LIST_EXPORT AppListItemView : public views::CustomButton,
  35                                         public views::ContextMenuController,
  36                                         public AppListItemObserver {
  37  public:
  38   // Internal class name.
  39   static const char kViewClassName[];
  40
  41   AppListItemView(AppsGridView* apps_grid_view, AppListItem* item);
  42   virtual ~AppListItemView();
  43
  44   void SetIconSize(const gfx::Size& size);
  45
  46   void Prerender();
  47
  48   void CancelContextMenu();
  49
  50   gfx::ImageSkia GetDragImage();
  51   void OnDragEnded();
  52   gfx::Point GetDragImageOffset();
  53
  54   void SetAsAttemptedFolderTarget(bool is_target_folder);
  55
  56   AppListItem* item() const { return item_; }
  57
  58   const views::Label* title() const { return title_; }
  59
  60   // In a synchronous drag the item view isn't informed directly of the drag
  61   // ending, so the runner of the drag should call this.
  62   void OnSyncDragEnd();
  63
  64   // Returns the icon bounds relative to AppListItemView.
  65   const gfx::Rect& GetIconBounds() const;
  66
  67  private:
  68   enum UIState {
  69     UI_STATE_NORMAL,    // Normal UI (icon + label)
  70     UI_STATE_DRAGGING,  // Dragging UI (scaled icon only)
  71     UI_STATE_DROPPING_IN_FOLDER,  // Folder dropping preview UI
  72   };
  73
  74   // Get icon from |item_| and schedule background processing.
  75   void UpdateIcon();
  76
  77   // Update the tooltip text from |item_|.
  78   void UpdateTooltip();
  79
  80   void SetUIState(UIState state);
  81
  82   // Sets |touch_dragging_| flag and updates UI.
  83   void SetTouchDragging(bool touch_dragging);
  84
  85   // Invoked when |mouse_drag_timer_| fires to show dragging UI.
  86   void OnMouseDragTimer();
  87
  88   // AppListItemObserver overrides:
  89   virtual void ItemIconChanged() OVERRIDE;
  90   virtual void ItemTitleChanged() OVERRIDE;
  91   virtual void ItemHighlightedChanged() OVERRIDE;
  92   virtual void ItemIsInstallingChanged() OVERRIDE;
  93   virtual void ItemPercentDownloadedChanged() OVERRIDE;
  94
  95   // views::View overrides:
  96   virtual const char* GetClassName() const OVERRIDE;
  97   virtual void Layout() OVERRIDE;
  98   virtual void OnPaint(gfx::Canvas* canvas) OVERRIDE;
  99   virtual void GetAccessibleState(ui::AccessibleViewState* state) OVERRIDE;
 100
 101   // views::ContextMenuController overrides:
 102   virtual void ShowContextMenuForView(views::View* source,
 103                                       const gfx::Point& point,
 104                                       ui::MenuSourceType source_type) OVERRIDE;
 105
 106   // views::CustomButton overrides:
 107   virtual void StateChanged() OVERRIDE;
 108   virtual bool ShouldEnterPushedState(const ui::Event& event) OVERRIDE;
 109
 110   // views::View overrides:
 111   virtual bool OnKeyPressed(const ui::KeyEvent& event) OVERRIDE;
 112   virtual bool OnMousePressed(const ui::MouseEvent& event) OVERRIDE;
 113   virtual void OnMouseReleased(const ui::MouseEvent& event) OVERRIDE;
 114   virtual void OnMouseCaptureLost() OVERRIDE;
 115   virtual bool OnMouseDragged(const ui::MouseEvent& event) OVERRIDE;
 116
 117   // ui::EventHandler overrides:
 118   virtual void OnGestureEvent(ui::GestureEvent* event) OVERRIDE;
 119
 120   AppListItem* item_;  // Owned by AppListModel.
 121
 122   AppsGridView* apps_grid_view_;  // Owned by views hierarchy.
 123   views::ImageView* icon_;  // Owned by views hierarchy.
 124   CachedLabel* title_;  // Owned by views hierarchy.
 125   ProgressBarView* progress_bar_;  // Owned by views hierarchy.
 126
 127   scoped_ptr<views::MenuRunner> context_menu_runner_;
 128
 129   gfx::Size icon_size_;
 130   gfx::ShadowValues icon_shadows_;
 131
 132   UIState ui_state_;
 133
 134   // True if scroll gestures should contribute to dragging.
 135   bool touch_dragging_;
 136
 137   // A timer to defer showing drag UI when mouse is pressed.
 138   base::OneShotTimer<AppListItemView> mouse_drag_timer_;
 139
 140   DISALLOW_COPY_AND_ASSIGN(AppListItemView);
 141 };
 142
 143 }  // namespace app_list
 144
 145 #endif  // UI_APP_LIST_VIEWS_APP_LIST_ITEM_VIEW_H_