src/content/public/browser/browser_plugin_guest_delegate.h

   1 // Copyright 2013 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_DELEGATE_H_
   6 #define CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_
   7
   8 #include "base/callback_forward.h"
   9 #include "base/process/kill.h"
  10 #include "content/common/content_export.h"
  11 #include "content/public/browser/web_contents.h"
  12
  13 namespace base {
  14 class DictionaryValue;
  15 }  // namespace base
  16
  17 namespace gfx {
  18 class Size;
  19 }  // namespace gfx
  20
  21 namespace content {
  22
  23 // Objects implement this interface to get notified about changes in the guest
  24 // WebContents and to provide necessary functionality.
  25 class CONTENT_EXPORT BrowserPluginGuestDelegate {
  26  public:
  27   virtual ~BrowserPluginGuestDelegate() {}
  28
  29   // Notification that the embedder will begin attachment. This is called
  30   // prior to resuming resource loads.
  31   virtual void WillAttach(content::WebContents* embedder_web_contents,
  32                           const base::DictionaryValue& extra_params) {}
  33
  34   virtual WebContents* CreateNewGuestWindow(
  35       const WebContents::CreateParams& create_params);
  36
  37   // Notification that the embedder has completed attachment.
  38   virtual void DidAttach() {}
  39
  40   // Requests the instance ID associated with the delegate.
  41   virtual int GetGuestInstanceID() const;
  42
  43   // Notification that the BrowserPlugin has resized.
  44   virtual void ElementSizeChanged(const gfx::Size& old_size,
  45                                   const gfx::Size& new_size) {}
  46
  47   // Notifies that the content size of the guest has changed.
  48   // Note: In autosize mode, it si possible that the guest size may not match
  49   // the element size.
  50   virtual void GuestSizeChanged(const gfx::Size& old_size,
  51                                 const gfx::Size& new_size) {}
  52
  53   // Asks the delegate if the given guest can lock the pointer.
  54   // Invoking the |callback| synchronously is OK.
  55   virtual void RequestPointerLockPermission(
  56       bool user_gesture,
  57       bool last_unlocked_by_target,
  58       const base::Callback<void(bool)>& callback) {}
  59
  60   // Requests that the delegate destroy itself along with its associated
  61   // WebContents.
  62   virtual void Destroy() {}
  63
  64   // Registers a |callback| with the delegate that the delegate would call when
  65   // it is about to be destroyed.
  66   typedef base::Callback<void()> DestructionCallback;
  67   virtual void RegisterDestructionCallback(
  68       const DestructionCallback& callback) {}
  69 };
  70
  71 }  // namespace content
  72
  73 #endif  // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_