Enhance chrome.app.window API for shelf integration with pinning support

ash/common/shelf/shelf_delegate.h

 // Copyright 2013 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 ASH_COMMON_SHELF_SHELF_DELEGATE_H_
 #define ASH_COMMON_SHELF_SHELF_DELEGATE_H_
 
 #include <string>
 
 #include "ash/ash_export.h"
@@ skipping 24 matching lines @@
 
   // Called when |shelf|'s auto-hide state changes.
   virtual void OnShelfAutoHideStateChanged(WmShelf* shelf) = 0;
 
   // Called when |shelf|'s visibility state is committed.
   virtual void OnShelfVisibilityStateChanged(WmShelf* shelf) = 0;
 
   // Get the shelf ID from an application ID.
   virtual ShelfID GetShelfIDForAppID(const std::string& app_id) = 0;
 
+  // Get the shelf ID from an application ID and a launch ID.
+  virtual ShelfID GetShelfIDForAppIDAndLaunchID(
+      const std::string& app_id,
+      const std::string& launch_id) = 0;

[James Cook, 2016/09/01 04:27:51]

|launch_id| needs to be documented at this level as well.

(Steven, are you sure you like launch_id? I find it pretty confusing.
app_window_id or app_window_key or window_key might be better. We just use the
word "launch" too much.)

[Andra Paraschiv, 2016/09/01 08:27:25]

Added the comment for launch_id.

+
   // Checks whether a mapping exists from the ShelfID |id| to an app id.
   virtual bool HasShelfIDToAppIDMapping(ShelfID id) const = 0;
 
   // Get the application ID for a given shelf ID.
   // |HasShelfIDToAppIDMapping(ShelfID)| should be called first to ensure the
   // ShelfID can be successfully mapped to an app id.
   virtual const std::string& GetAppIDForShelfID(ShelfID id) = 0;
 
   // Pins an app with |app_id| to shelf. A running instance will get pinned.
   // In case there is no running instance a new shelf item is created and
   // pinned.
   virtual void PinAppWithID(const std::string& app_id) = 0;
 
   // Check if the app with |app_id_| is pinned to the shelf.
   virtual bool IsAppPinned(const std::string& app_id) = 0;
 
   // Unpins app item with |app_id|.
   virtual void UnpinAppWithID(const std::string& app_id) = 0;
 };
 
 }  // namespace ash
 
 #endif  // ASH_COMMON_SHELF_SHELF_DELEGATE_H_