| // 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 { |
| |
| class GuestHost; |
| |
| // 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. |
| // Once the content embedder has completed setting up state for attachment, it |
| // must call the |completion_callback| to complete attachment. |
| virtual void WillAttach(content::WebContents* embedder_web_contents, |
| int element_instance_id, |
| bool is_full_page_plugin, |
| const base::Closure& completion_callback) {} |
| |
| virtual WebContents* CreateNewGuestWindow( |
| const WebContents::CreateParams& create_params); |
| |
| // Asks the delegate whether this guest can run while detached from a |
| // container. A detached guest is a WebContents that has no visual surface |
| // into which it can composite its content. Detached guests can be thought |
| // of as workers with a DOM. |
| virtual bool CanRunInDetachedState() const; |
| |
| // 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 guest has detached from its container. |
| virtual void DidDetach() {} |
| |
| // Notification that a valid |url| was dropped over the guest. |
| virtual void DidDropLink(const GURL& url) {} |
| |
| // Notification that the BrowserPlugin has resized. |
| virtual void ElementSizeChanged(const gfx::Size& size) {} |
| |
| // Returns the WebContents that currently owns this guest. |
| virtual WebContents* GetOwnerWebContents() const; |
| |
| // Notifies that the content size of the guest has changed. |
| // Note: In autosize mode, it is possible that the guest size may not match |
| // the element size. |
| virtual void GuestSizeChanged(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) {} |
| |
| // Find the given |search_text| in the page. Returns true if the find request |
| // is handled by this browser plugin guest delegate. |
| virtual bool HandleFindForEmbedder(int request_id, |
| const base::string16& search_text, |
| const blink::WebFindOptions& options); |
| virtual bool HandleStopFindingForEmbedder(StopFindAction action); |
| |
| // Provides the delegate with an interface with which to communicate with the |
| // content module. |
| virtual void SetGuestHost(GuestHost* guest_host) {} |
| |
| // Sets the position of the context menu for the guest contents. The value |
| // reported from the guest renderer should be ignored. The reported value |
| // fromt he guest renderer is incorrect in situations where BrowserPlugin is |
| // subject to CSS transforms. |
| virtual void SetContextMenuPosition(const gfx::Point& position) {} |
| }; |
| |
| } // namespace content |
| |
| #endif // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_ |