| // 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 CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_ |
| #define CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_ |
| |
| #include "base/callback_forward.h" |
| #include "base/process/kill.h" |
| #include "content/common/content_export.h" |
| #include "content/public/browser/web_contents.h" |
| |
| namespace base { |
| class DictionaryValue; |
| } // namespace base |
| |
| namespace gfx { |
| class Size; |
| } // namespace gfx |
| |
| namespace content { |
| |
| // Objects implement this interface to get notified about changes in the guest |
| // WebContents and to provide necessary functionality. |
| class CONTENT_EXPORT BrowserPluginGuestDelegate { |
| public: |
| virtual ~BrowserPluginGuestDelegate() {} |
| |
| // Notification that the embedder will begin attachment. This is called |
| // prior to resuming resource loads. |element_instance_id| uniquely identifies |
| // the element that will serve as a container for the guest. |
| virtual void WillAttach(content::WebContents* embedder_web_contents, |
| int element_instance_id) {} |
| |
| virtual WebContents* CreateNewGuestWindow( |
| const WebContents::CreateParams& create_params); |
| |
| // Notification that the embedder has completed attachment. The |
| // |guest_proxy_routing_id| is the routing ID for the RenderView in the |
| // embedder that will serve as a contentWindow proxy for the guest. |
| virtual void DidAttach(int guest_proxy_routing_id) {} |
| |
| // Notification that the BrowserPlugin has resized. |
| virtual void ElementSizeChanged(const gfx::Size& old_size, |
| const gfx::Size& new_size) {} |
| |
| // Notifies that the content size of the guest has changed. |
| // Note: In autosize mode, it si possible that the guest size may not match |
| // the element size. |
| virtual void GuestSizeChanged(const gfx::Size& old_size, |
| const gfx::Size& new_size) {} |
| |
| // Asks the delegate if the given guest can lock the pointer. |
| // Invoking the |callback| synchronously is OK. |
| virtual void RequestPointerLockPermission( |
| bool user_gesture, |
| bool last_unlocked_by_target, |
| const base::Callback<void(bool)>& callback) {} |
| |
| // Registers a |callback| with the delegate that the delegate would call when |
| // it is about to be destroyed. |
| typedef base::Callback<void()> DestructionCallback; |
| virtual void RegisterDestructionCallback( |
| const DestructionCallback& callback) {} |
| |
| // Find the given |search_text| in the page. Returns true if the find request |
| // is handled by this browser plugin guest delegate. |
| virtual bool Find(int request_id, |
| const base::string16& search_text, |
| const blink::WebFindOptions& options, |
| bool is_full_page_plugin); |
| }; |
| |
| } // namespace content |
| |
| #endif // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_ |