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: ~BrowserPluginGuestDelegate()27 virtual ~BrowserPluginGuestDelegate() {} 28 29 // Notification that the embedder will begin attachment. This is called 30 // prior to resuming resource loads. |element_instance_id| uniquely identifies 31 // the element that will serve as a container for the guest. WillAttach(content::WebContents * embedder_web_contents,int element_instance_id)32 virtual void WillAttach(content::WebContents* embedder_web_contents, 33 int element_instance_id) {} 34 35 virtual WebContents* CreateNewGuestWindow( 36 const WebContents::CreateParams& create_params); 37 38 // Notification that the embedder has completed attachment. The 39 // |guest_proxy_routing_id| is the routing ID for the RenderView in the 40 // embedder that will serve as a contentWindow proxy for the guest. DidAttach(int guest_proxy_routing_id)41 virtual void DidAttach(int guest_proxy_routing_id) {} 42 43 // Notification that the BrowserPlugin has resized. ElementSizeChanged(const gfx::Size & old_size,const gfx::Size & new_size)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. GuestSizeChanged(const gfx::Size & old_size,const gfx::Size & new_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. RequestPointerLockPermission(bool user_gesture,bool last_unlocked_by_target,const base::Callback<void (bool)> & callback)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. Destroy()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; RegisterDestructionCallback(const DestructionCallback & callback)67 virtual void RegisterDestructionCallback( 68 const DestructionCallback& callback) {} 69 }; 70 71 } // namespace content 72 73 #endif // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_ 74