browser_plugin_guest_delegate.h revision 58537e28ecd584eab876aee8be7156509866d23a
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 "base/strings/string16.h" 11#include "base/values.h" 12#include "content/common/content_export.h" 13#include "content/public/common/browser_plugin_permission_type.h" 14#include "ui/gfx/size.h" 15#include "url/gurl.h" 16 17namespace content { 18 19struct NativeWebKeyboardEvent; 20 21// Objects implement this interface to get notified about changes in the guest 22// WebContents and to provide necessary functionality. 23class CONTENT_EXPORT BrowserPluginGuestDelegate { 24 public: 25 virtual ~BrowserPluginGuestDelegate() {} 26 27 // Add a message to the console. 28 virtual void AddMessageToConsole(int32 level, 29 const string16& message, 30 int32 line_no, 31 const string16& source_id) {} 32 33 // Request the delegate to close this guest, and do whatever cleanup it needs 34 // to do. 35 virtual void Close() {} 36 37 // Informs the delegate that the guest render process is gone. |status| 38 // indicates whether the guest was killed, crashed, or was terminated 39 // gracefully. 40 virtual void GuestProcessGone(base::TerminationStatus status) {} 41 42 virtual bool HandleKeyboardEvent(const NativeWebKeyboardEvent& event); 43 44 // Notification that a load in the guest resulted in abort. Note that |url| 45 // may be invalid. 46 virtual void LoadAbort(bool is_top_level, 47 const GURL& url, 48 const std::string& error_type) {} 49 50 // Notification that the page has made some progress loading. |progress| is a 51 // value between 0.0 (nothing loaded) and 1.0 (page loaded completely). 52 virtual void LoadProgressed(double progress) {} 53 54 // Notification that the guest is no longer hung. 55 virtual void RendererResponsive() {} 56 57 // Notification that the guest is hung. 58 virtual void RendererUnresponsive() {} 59 60 typedef base::Callback<void(bool /* allow */, 61 const std::string& /* user_input */)> 62 PermissionResponseCallback; 63 64 // Request permission from the delegate to perform an action of the provided 65 // |permission_type|. Details of the permission request are found in 66 // |request_info|. A |callback| is provided to make the decision. 67 // Returns whether the delegate has, or will handle the permission request. 68 virtual bool RequestPermission( 69 BrowserPluginPermissionType permission_type, 70 const base::DictionaryValue& request_info, 71 const PermissionResponseCallback& callback); 72 73 // Notifies that the content size of the guest has changed in autosize mode. 74 virtual void SizeChanged(const gfx::Size& old_size, 75 const gfx::Size& new_size) {} 76}; 77 78} // namespace content 79 80#endif // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_ 81