content/public/browser/browser_plugin_guest_manager.h

   1 // Copyright 2014 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 CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_MANAGER_H_
   6 #define CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_MANAGER_H_
   7
   8 #include "base/callback.h"
   9 #include "content/common/content_export.h"
  10
  11 namespace content {
  12
  13 class WebContents;
  14
  15 // A BrowserPluginGuestManager offloads guest management and routing
  16 // operations outside of the content layer.
  17 class CONTENT_EXPORT BrowserPluginGuestManager {
  18  public:
  19   virtual ~BrowserPluginGuestManager() {}
  20
  21   // Requests a guest WebContents associated with the provided
  22   // <owner_process_id, browser_plugin_instance_id> tuple.
  23   virtual WebContents* GetGuestByInstanceID(int owner_process_id,
  24                                             int browser_plugin_instance_id);
  25
  26   // Iterates over all WebContents belonging to a given |embedder_web_contents|,
  27   // calling |callback| for each. If one of the callbacks returns true, then
  28   // the iteration exits early.
  29   typedef base::Callback<bool(WebContents*)> GuestCallback;
  30   virtual bool ForEachGuest(WebContents* embedder_web_contents,
  31                             const GuestCallback& callback);
  32
  33   // Returns the "full page" guest if there is one. That is, if there is a
  34   // single BrowserPlugin in the given embedder which takes up the full page,
  35   // then it is returned.
  36   virtual WebContents* GetFullPageGuest(WebContents* embedder_web_contents);
  37 };
  38
  39 }  // namespace content
  40
  41 #endif  // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_MANAGER_H_