browser_plugin_guest_delegate.h revision 03b57e008b61dfcb1fbad3aea950ae0e001748b0 
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
13namespace base {
14class DictionaryValue;
15}  // namespace base
16
17namespace gfx {
18class Size;
19}  // namespace gfx
20
21namespace content {
22
23// Objects implement this interface to get notified about changes in the guest
24// WebContents and to provide necessary functionality.
25class 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
33  virtual WebContents* CreateNewGuestWindow(
34      const WebContents::CreateParams& create_params);
35
36  // Notification that the embedder has completed attachment.
37  virtual void DidAttach() {}
38
39  // Notification that the BrowserPlugin has resized.
40  virtual void ElementSizeChanged(const gfx::Size& old_size,
41                                  const gfx::Size& new_size) {}
42
43  // Notifies that the content size of the guest has changed.
44  // Note: In autosize mode, it si possible that the guest size may not match
45  // the element size.
46  virtual void GuestSizeChanged(const gfx::Size& old_size,
47                                const gfx::Size& new_size) {}
48
49  // Asks the delegate if the given guest can lock the pointer.
50  // Invoking the |callback| synchronously is OK.
51  virtual void RequestPointerLockPermission(
52      bool user_gesture,
53      bool last_unlocked_by_target,
54      const base::Callback<void(bool)>& callback) {}
55
56  // Requests that the delegate destroy itself along with its associated
57  // WebContents.
58  virtual void Destroy() {}
59
60  // Registers a |callback| with the delegate that the delegate would call when
61  // it is about to be destroyed.
62  typedef base::Callback<void()> DestructionCallback;
63  virtual void RegisterDestructionCallback(
64      const DestructionCallback& callback) {}
65};
66
67}  // namespace content
68
69#endif  // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_
70