[Merge to 2924] Reland "Propagate information about how ARC apps are launched"

chrome/browser/ui/ash/launcher/arc_app_deferred_launcher_item_controller.h

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_UI_ASH_LAUNCHER_ARC_APP_DEFERRED_LAUNCHER_ITEM_CONTROLLER_H_
 #define CHROME_BROWSER_UI_ASH_LAUNCHER_ARC_APP_DEFERRED_LAUNCHER_ITEM_CONTROLLER_H_
 
 #include <string>
 
 #include "base/macros.h"
 #include "base/memory/weak_ptr.h"
 #include "base/time/time.h"
 #include "chrome/browser/ui/ash/launcher/launcher_item_controller.h"
 
 class ArcAppDeferredLauncherController;
 class ChromeLauncherController;
 
+// ArcAppDeferredLauncherItemController displays the icon of the ARC app that
+// cannot be launched immediately (due to ARC not being ready) on Chrome OS'
+// shelf, with an overlaid spinner to provide visual feedback.
 class ArcAppDeferredLauncherItemController : public LauncherItemController {
  public:
   ArcAppDeferredLauncherItemController(
       const std::string& arc_app_id,
       ChromeLauncherController* controller,
+      int event_flags,
       const base::WeakPtr<ArcAppDeferredLauncherController>& host);
 
   ~ArcAppDeferredLauncherItemController() override;
 
   base::TimeDelta GetActiveTime() const;
 
+  int event_flags() const { return event_flags_; }
+
   // ash::ShelfItemDelegate
   ash::ShelfItemDelegate::PerformedAction ItemSelected(
       const ui::Event& event) override;
   base::string16 GetTitle() override;
   bool CanPin() const override;
   ash::ShelfMenuModel* CreateApplicationMenu(int event_flags) override;
   bool IsDraggable() override;
   bool ShouldShowTooltip() override;
   void Close() override;
 
   // LauncherItemController overrides:
   bool IsVisible() const override;
   void Launch(ash::LaunchSource source, int event_flags) override;
   ash::ShelfItemDelegate::PerformedAction Activate(
       ash::LaunchSource source) override;
   ChromeLauncherAppMenuItems GetApplicationList(int event_flags) override;
 
  private:
+  // The flags of the event that caused the ARC app to be activated. These will
+  // be propagated to the launch event once the app is actually launched.
+  const int event_flags_;
+
   base::WeakPtr<ArcAppDeferredLauncherController> host_;
   const base::Time start_time_;
 
   DISALLOW_COPY_AND_ASSIGN(ArcAppDeferredLauncherItemController);
 };
 
 #endif  // CHROME_BROWSER_UI_ASH_LAUNCHER_ARC_APP_DEFERRED_LAUNCHER_ITEM_CONTROLLER_H_