1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
// 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 "base/strings/string16.h"
#include "base/values.h"
#include "content/common/content_export.h"
#include "content/public/common/browser_plugin_permission_type.h"
#include "content/public/common/media_stream_request.h"
#include "ui/gfx/geometry/rect.h"
#include "ui/gfx/size.h"
#include "url/gurl.h"
namespace content {
class JavaScriptDialogManager;
struct ContextMenuParams;
struct NativeWebKeyboardEvent;
// 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() {}
// Add a message to the console.
virtual void AddMessageToConsole(int32 level,
const base::string16& message,
int32 line_no,
const base::string16& source_id) {}
// Request the delegate to close this guest, and do whatever cleanup it needs
// to do.
virtual void Close() {}
// Notification that the embedder has completed attachment.
virtual void DidAttach() {}
// Informs the delegate that the guest render process is gone. |status|
// indicates whether the guest was killed, crashed, or was terminated
// gracefully.
virtual void GuestProcessGone(base::TerminationStatus status) {}
// Informs the delegate that the embedder has been destroyed.
virtual void EmbedderDestroyed() {}
// Informs the delegate of a reply to the find request specified by
// |request_id|.
virtual void FindReply(int request_id,
int number_of_matches,
const gfx::Rect& selection_rect,
int active_match_ordinal,
bool final_update) {}
virtual bool HandleKeyboardEvent(const NativeWebKeyboardEvent& event);
// Requests setting the zoom level to the provided |zoom_level|.
virtual void SetZoom(double zoom_factor) {}
virtual bool IsDragAndDropEnabled();
// Returns whether the user agent for the guest is being overridden.
virtual bool IsOverridingUserAgent() const;
// Notification that a load in the guest resulted in abort. Note that |url|
// may be invalid.
virtual void LoadAbort(bool is_top_level,
const GURL& url,
const std::string& error_type) {}
// Notification that the page has made some progress loading. |progress| is a
// value between 0.0 (nothing loaded) and 1.0 (page loaded completely).
virtual void LoadProgressed(double progress) {}
// Notification that the guest is no longer hung.
virtual void RendererResponsive() {}
// Notification that the guest is hung.
virtual void RendererUnresponsive() {}
typedef base::Callback<void(bool /* allow */,
const std::string& /* user_input */)>
PermissionResponseCallback;
// Request permission from the delegate to perform an action of the provided
// |permission_type|. Details of the permission request are found in
// |request_info|. A |callback| is provided to make the decision.
virtual void RequestPermission(
BrowserPluginPermissionType permission_type,
const base::DictionaryValue& request_info,
const PermissionResponseCallback& callback,
bool allowed_by_default) {}
// Requests resolution of a potentially relative URL.
virtual GURL ResolveURL(const std::string& src);
// Notifies that the content size of the guest has changed in autosize mode.
virtual void SizeChanged(const gfx::Size& old_size,
const gfx::Size& new_size) {}
// Asks permission to use the camera and/or microphone. If permission is
// granted, a call should be made to |callback| with the devices. If the
// request is denied, a call should be made to |callback| with an empty list
// of devices. |request| has the details of the request (e.g. which of audio
// and/or video devices are requested, and lists of available devices).
virtual void RequestMediaAccessPermission(
const MediaStreamRequest& request,
const MediaResponseCallback& callback);
// Asks the delegate if the given guest can download.
// Invoking the |callback| synchronously is OK.
virtual void CanDownload(const std::string& request_method,
const GURL& url,
const base::Callback<void(bool)>& callback);
// 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) {}
// Returns a pointer to a service to manage JavaScript dialogs. May return
// NULL in which case dialogs aren't shown.
virtual JavaScriptDialogManager* GetJavaScriptDialogManager();
// Returns true if the context menu operation was handled by the delegate.
virtual bool HandleContextMenu(const ContextMenuParams& params);
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_BROWSER_PLUGIN_GUEST_DELEGATE_H_
|
