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