src/ash/wm/app_list_controller.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_WM_APP_LIST_CONTROLLER_H_
   6 #define ASH_WM_APP_LIST_CONTROLLER_H_
   7
   8 #include "ash/shelf/shelf_icon_observer.h"
   9 #include "ash/shell_observer.h"
  10 #include "base/basictypes.h"
  11 #include "base/compiler_specific.h"
  12 #include "base/timer/timer.h"
  13 #include "ui/app_list/pagination_model_observer.h"
  14 #include "ui/aura/client/focus_change_observer.h"
  15 #include "ui/aura/window_observer.h"
  16 #include "ui/compositor/layer_animation_observer.h"
  17 #include "ui/events/event_handler.h"
  18 #include "ui/gfx/rect.h"
  19 #include "ui/views/widget/widget_observer.h"
  20
  21 namespace app_list {
  22 class ApplicationDragAndDropHost;
  23 class AppListView;
  24 class PaginationModel;
  25 }
  26
  27 namespace ui {
  28 class LocatedEvent;
  29 }
  30
  31 namespace ash {
  32 namespace test {
  33 class AppListControllerTestApi;
  34 }
  35
  36 namespace internal {
  37
  38 // AppListController is a controller that manages app list UI for shell.
  39 // It creates AppListView and schedules showing/hiding animation.
  40 // While the UI is visible, it monitors things such as app list widget's
  41 // activation state and desktop mouse click to auto dismiss the UI.
  42 class AppListController : public ui::EventHandler,
  43                           public aura::client::FocusChangeObserver,
  44                           public aura::WindowObserver,
  45                           public ui::ImplicitAnimationObserver,
  46                           public views::WidgetObserver,
  47                           public ShellObserver,
  48                           public ShelfIconObserver,
  49                           public app_list::PaginationModelObserver {
  50  public:
  51   AppListController();
  52   virtual ~AppListController();
  53
  54   // Show/hide app list window. The |window| is used to deterime in
  55   // which display (in which the |window| exists) the app list should
  56   // be shown.
  57   void SetVisible(bool visible, aura::Window* window);
  58
  59   // Whether app list window is visible (shown or being shown).
  60   bool IsVisible() const;
  61
  62   // Returns target visibility. This differs from IsVisible() if an animation
  63   // is ongoing.
  64   bool GetTargetVisibility() const { return is_visible_; }
  65
  66   // Returns app list window or NULL if it is not visible.
  67   aura::Window* GetWindow();
  68
  69   // Returns app list view or NULL if it is not visible.
  70   app_list::AppListView* GetView() { return view_; }
  71
  72  private:
  73   friend class test::AppListControllerTestApi;
  74
  75   // If |drag_and_drop_host| is not NULL it will be called upon drag and drop
  76   // operations outside the application list.
  77   void SetDragAndDropHostOfCurrentAppList(
  78       app_list::ApplicationDragAndDropHost* drag_and_drop_host);
  79
  80   // Sets the app list view and attempts to show it.
  81   void SetView(app_list::AppListView* view);
  82
  83   // Forgets the view.
  84   void ResetView();
  85
  86   // Starts show/hide animation.
  87   void ScheduleAnimation();
  88
  89   void ProcessLocatedEvent(ui::LocatedEvent* event);
  90
  91   // Makes app list bubble update its bounds.
  92   void UpdateBounds();
  93
  94   // ui::EventHandler overrides:
  95   virtual void OnMouseEvent(ui::MouseEvent* event) OVERRIDE;
  96   virtual void OnGestureEvent(ui::GestureEvent* event) OVERRIDE;
  97
  98   // aura::client::FocusChangeObserver overrides:
  99   virtual void OnWindowFocused(aura::Window* gained_focus,
 100                                aura::Window* lost_focus) OVERRIDE;
 101
 102   // aura::WindowObserver overrides:
 103   virtual void OnWindowBoundsChanged(aura::Window* root,
 104                                      const gfx::Rect& old_bounds,
 105                                      const gfx::Rect& new_bounds) OVERRIDE;
 106
 107   // ui::ImplicitAnimationObserver overrides:
 108   virtual void OnImplicitAnimationsCompleted() OVERRIDE;
 109
 110   // views::WidgetObserver overrides:
 111   virtual void OnWidgetDestroying(views::Widget* widget) OVERRIDE;
 112
 113   // ShellObserver overrides:
 114   virtual void OnShelfAlignmentChanged(aura::Window* root_window) OVERRIDE;
 115
 116   // ShelfIconObserver overrides:
 117   virtual void OnShelfIconPositionsChanged() OVERRIDE;
 118
 119   // app_list::PaginationModelObserver overrides:
 120   virtual void TotalPagesChanged() OVERRIDE;
 121   virtual void SelectedPageChanged(int old_selected, int new_selected) OVERRIDE;
 122   virtual void TransitionStarted() OVERRIDE;
 123   virtual void TransitionChanged() OVERRIDE;
 124
 125   scoped_ptr<app_list::PaginationModel> pagination_model_;
 126
 127   // Whether we should show or hide app list widget.
 128   bool is_visible_;
 129
 130   // The AppListView this class manages, owned by its widget.
 131   app_list::AppListView* view_;
 132
 133   // Cached bounds of |view_| for snapping back animation after over-scroll.
 134   gfx::Rect view_bounds_;
 135
 136   // Whether should schedule snap back animation.
 137   bool should_snap_back_;
 138
 139   DISALLOW_COPY_AND_ASSIGN(AppListController);
 140 };
 141
 142 }  // namespace internal
 143 }  // namespace ash
 144
 145 #endif  // ASH_WM_APP_LIST_CONTROLLER_H_