blob: b02a1ecc2dc8f350db4357b8f6b8920a315038de [file] [log] [blame]
[email protected]4fdf6742012-01-10 20:14:361// Copyright (c) 2012 The Chromium Authors. All rights reserved.
[email protected]0dd3a0ab2011-02-18 08:17:442// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
[email protected]674bc592011-12-20 23:00:425#ifndef CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_
6#define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_
[email protected]0dd3a0ab2011-02-18 08:17:447
[email protected]1de2b8b2011-06-29 19:38:468#include <set>
[email protected]0dd3a0ab2011-02-18 08:17:449#include <string>
[email protected]0dd3a0ab2011-02-18 08:17:4410
11#include "base/basictypes.h"
[email protected]f13b4202012-06-12 23:53:2312#include "base/callback.h"
[email protected]d583e3f22011-12-27 21:38:1713#include "base/string16.h"
[email protected]8d128d62011-09-13 22:11:5714#include "content/common/content_export.h"
[email protected]e6e646d2011-12-01 00:50:1115#include "content/public/browser/navigation_type.h"
[email protected]f13b4202012-06-12 23:53:2316#include "content/public/common/media_stream_request.h"
[email protected]2905f742011-10-13 03:51:5817#include "content/public/common/page_transition_types.h"
[email protected]4fdf6742012-01-10 20:14:3618#include "content/public/common/window_container_type.h"
[email protected]da8543762012-03-20 08:52:2019#include "third_party/skia/include/core/SkColor.h"
[email protected]0dd3a0ab2011-02-18 08:17:4420#include "ui/gfx/native_widget_types.h"
[email protected]59363fc92012-09-05 03:46:3121#include "ui/gfx/rect_f.h"
[email protected]0dd3a0ab2011-02-18 08:17:4422#include "webkit/glue/window_open_disposition.h"
23
[email protected]7dba43dc2011-11-10 01:57:5824class FilePath;
25class GURL;
[email protected]b172aee2012-04-10 17:05:2626class WebContentsImpl;
[email protected]7dba43dc2011-11-10 01:57:5827
[email protected]32ded2212011-11-10 18:51:4328namespace base {
29class ListValue;
30}
31
[email protected]3ab9cb82011-06-03 18:02:0732namespace content {
[email protected]3d7474ff2011-07-27 17:47:3733class BrowserContext;
[email protected]da8543762012-03-20 08:52:2034class ColorChooser;
[email protected]e582fdd2011-12-20 16:48:1735class DownloadItem;
[email protected]3ab9cb82011-06-03 18:02:0736class JavaScriptDialogCreator;
[email protected]c0c1c622012-03-13 04:51:5437class RenderViewHost;
[email protected]a81343d232011-12-27 07:39:2038class WebContents;
[email protected]0d9989d2011-12-21 20:26:0039class WebIntentsDispatcher;
[email protected]35be7ec2012-02-12 20:42:5140struct ContextMenuParams;
[email protected]e582fdd2011-12-20 16:48:1741struct FileChooserParams;
[email protected]b87ee522012-05-18 15:16:5442struct NativeWebKeyboardEvent;
[email protected]d583e3f22011-12-27 21:38:1743struct SSLStatus;
[email protected]3ab9cb82011-06-03 18:02:0744}
45
[email protected]0dd3a0ab2011-02-18 08:17:4446namespace gfx {
47class Point;
48class Rect;
49class Size;
50}
51
52namespace history {
53class HistoryAddPageArgs;
54}
55
[email protected]ce9751942011-09-21 01:57:2456namespace webkit_glue {
57struct WebIntentData;
[email protected]3a3b75a2012-06-01 08:38:3658struct WebIntentServiceData;
[email protected]ce9751942011-09-21 01:57:2459}
60
[email protected]16383382012-09-05 23:57:2661namespace WebKit {
62class WebLayer;
63}
64
[email protected]674bc592011-12-20 23:00:4265namespace content {
66
[email protected]e5d549d2011-12-28 01:29:2067struct OpenURLParams;
68
[email protected]f13b4202012-06-12 23:53:2369typedef base::Callback< void(const MediaStreamDevices&) > MediaResponseCallback;
70
[email protected]0dd3a0ab2011-02-18 08:17:4471// Objects implement this interface to get notified about changes in the
[email protected]2a6bc3e2011-12-28 23:51:3372// WebContents and to provide necessary functionality.
[email protected]674bc592011-12-20 23:00:4273class CONTENT_EXPORT WebContentsDelegate {
[email protected]0dd3a0ab2011-02-18 08:17:4474 public:
[email protected]674bc592011-12-20 23:00:4275 WebContentsDelegate();
[email protected]1de2b8b2011-06-29 19:38:4676
[email protected]e5d549d2011-12-28 01:29:2077 // Opens a new URL inside the passed in WebContents (if source is 0 open
[email protected]0dd3a0ab2011-02-18 08:17:4478 // in the current front-most tab), unless |disposition| indicates the url
79 // should be opened in a new tab or window.
80 //
81 // A NULL source indicates the current tab (callers should probably use
82 // OpenURL() for these cases which does it for you).
[email protected]00c37fc2011-08-02 00:22:5083
[email protected]e5d549d2011-12-28 01:29:2084 // Returns the WebContents the URL is opened in, or NULL if the URL wasn't
[email protected]992e4542011-07-20 23:09:2585 // opened immediately.
[email protected]e5d549d2011-12-28 01:29:2086 virtual WebContents* OpenURLFromTab(WebContents* source,
[email protected]00c37fc2011-08-02 00:22:5087 const OpenURLParams& params);
88
[email protected]ca13a442012-04-17 14:00:1289 // Called to inform the delegate that the WebContents's navigation state
[email protected]0dd3a0ab2011-02-18 08:17:4490 // changed. The |changed_flags| indicates the parts of the navigation state
91 // that have been updated, and is any combination of the
[email protected]2a6bc3e2011-12-28 23:51:3392 // |WebContents::InvalidateTypes| bits.
93 virtual void NavigationStateChanged(const WebContents* source,
[email protected]229eb7e2011-12-23 01:04:0894 unsigned changed_flags) {}
[email protected]0dd3a0ab2011-02-18 08:17:4495
[email protected]6c6b02d2011-09-02 03:36:4796 // Adds the navigation request headers to |headers|. Use
[email protected]0dd3a0ab2011-02-18 08:17:4497 // net::HttpUtil::AppendHeaderIfMissing to build the set of headers.
[email protected]229eb7e2011-12-23 01:04:0898 virtual void AddNavigationHeaders(const GURL& url, std::string* headers) {}
[email protected]0dd3a0ab2011-02-18 08:17:4499
[email protected]2a6bc3e2011-12-28 23:51:33100 // Creates a new tab with the already-created WebContents 'new_contents'.
[email protected]0dd3a0ab2011-02-18 08:17:44101 // The window for the added contents should be reparented correctly when this
102 // method returns. If |disposition| is NEW_POPUP, |pos| should hold the
103 // initial position.
[email protected]2a6bc3e2011-12-28 23:51:33104 virtual void AddNewContents(WebContents* source,
105 WebContents* new_contents,
[email protected]0dd3a0ab2011-02-18 08:17:44106 WindowOpenDisposition disposition,
107 const gfx::Rect& initial_pos,
[email protected]229eb7e2011-12-23 01:04:08108 bool user_gesture) {}
[email protected]0dd3a0ab2011-02-18 08:17:44109
110 // Selects the specified contents, bringing its container to the front.
[email protected]2a6bc3e2011-12-28 23:51:33111 virtual void ActivateContents(WebContents* contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44112
113 // Deactivates the specified contents by deactivating its container and
114 // potentialy moving it to the back of the Z order.
[email protected]2a6bc3e2011-12-28 23:51:33115 virtual void DeactivateContents(WebContents* contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44116
117 // Notifies the delegate that this contents is starting or is done loading
118 // some resource. The delegate should use this notification to represent
[email protected]2a6bc3e2011-12-28 23:51:33119 // loading feedback. See WebContents::IsLoading()
120 virtual void LoadingStateChanged(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44121
122 // Notifies the delegate that the page has made some progress loading.
123 // |progress| is a value between 0.0 (nothing loaded) to 1.0 (page fully
124 // loaded).
125 // Note that to receive this notification, you must have called
126 // SetReportLoadProgressEnabled(true) in the render view.
[email protected]b3996ba2012-08-08 00:39:13127 virtual void LoadProgressChanged(WebContents* source,
128 double progress) {}
[email protected]0dd3a0ab2011-02-18 08:17:44129
[email protected]2a6bc3e2011-12-28 23:51:33130 // Request the delegate to close this web contents, and do whatever cleanup
[email protected]0dd3a0ab2011-02-18 08:17:44131 // it needs to do.
[email protected]a81343d232011-12-27 07:39:20132 virtual void CloseContents(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44133
[email protected]cd9ed79d2011-11-15 19:22:57134 // Informs the delegate that the underlying RenderViewHost has been swapped
135 // out so it can perform any cleanup necessary.
[email protected]2a6bc3e2011-12-28 23:51:33136 virtual void SwappedOut(WebContents* source) {}
[email protected]cd9ed79d2011-11-15 19:22:57137
[email protected]ca13a442012-04-17 14:00:12138 // Request the delegate to move this WebContents to the specified position
[email protected]0dd3a0ab2011-02-18 08:17:44139 // in screen coordinates.
[email protected]2a6bc3e2011-12-28 23:51:33140 virtual void MoveContents(WebContents* source, const gfx::Rect& pos) {}
[email protected]0dd3a0ab2011-02-18 08:17:44141
[email protected]2a6bc3e2011-12-28 23:51:33142 // Called to determine if the WebContents is contained in a popup window
[email protected]b35b26b32011-05-05 20:35:14143 // or a panel window.
[email protected]2a6bc3e2011-12-28 23:51:33144 virtual bool IsPopupOrPanel(const WebContents* source) const;
[email protected]0dd3a0ab2011-02-18 08:17:44145
[email protected]0dd3a0ab2011-02-18 08:17:44146 // Notification that the target URL has changed.
[email protected]2a6bc3e2011-12-28 23:51:33147 virtual void UpdateTargetURL(WebContents* source,
[email protected]229eb7e2011-12-23 01:04:08148 int32 page_id,
149 const GURL& url) {}
[email protected]0dd3a0ab2011-02-18 08:17:44150
151 // Notification that there was a mouse event, along with the absolute
152 // coordinates of the mouse pointer and whether it was a normal motion event
153 // (otherwise, the pointer left the contents area).
[email protected]2a6bc3e2011-12-28 23:51:33154 virtual void ContentsMouseEvent(WebContents* source,
[email protected]229eb7e2011-12-23 01:04:08155 const gfx::Point& location,
156 bool motion) {}
[email protected]0dd3a0ab2011-02-18 08:17:44157
158 // Request the delegate to change the zoom level of the current tab.
[email protected]229eb7e2011-12-23 01:04:08159 virtual void ContentsZoomChange(bool zoom_in) {}
[email protected]0dd3a0ab2011-02-18 08:17:44160
[email protected]0dd3a0ab2011-02-18 08:17:44161 // Check whether this contents is inside a window dedicated to running a web
162 // application.
163 virtual bool IsApplication() const;
164
[email protected]24e18252012-04-16 21:26:27165 // Check whether this contents is permitted to load data URLs in WebUI mode.
166 // This is normally disallowed for security.
167 virtual bool CanLoadDataURLsInWebUI() const;
168
[email protected]b7a756d42012-01-23 18:08:17169 // Return the rect where to display the resize corner, if any, otherwise
170 // an empty rect.
171 virtual gfx::Rect GetRootWindowResizerRect() const;
172
[email protected]0dd3a0ab2011-02-18 08:17:44173 // Invoked prior to showing before unload handler confirmation dialog.
[email protected]229eb7e2011-12-23 01:04:08174 virtual void WillRunBeforeUnloadConfirm() {}
[email protected]0dd3a0ab2011-02-18 08:17:44175
176 // Returns true if javascript dialogs and unload alerts are suppressed.
177 // Default is false.
178 virtual bool ShouldSuppressDialogs();
179
[email protected]a796f202012-05-30 14:14:25180 // Add a message to the console. Returning true indicates that the delegate
181 // handled the message. If false is returned the default logging mechanism
182 // will be used for the message.
183 virtual bool AddMessageToConsole(WebContents* soruce,
184 int32 level,
185 const string16& message,
186 int32 line_no,
187 const string16& source_id);
188
[email protected]0dd3a0ab2011-02-18 08:17:44189 // Tells us that we've finished firing this tab's beforeunload event.
190 // The proceed bool tells us whether the user chose to proceed closing the
[email protected]a2c92a1c2012-04-03 12:32:14191 // tab. Returns true if the tab can continue on firing its unload event.
[email protected]0dd3a0ab2011-02-18 08:17:44192 // If we're closing the entire browser, then we'll want to delay firing
193 // unload events until all the beforeunload events have fired.
[email protected]2a6bc3e2011-12-28 23:51:33194 virtual void BeforeUnloadFired(WebContents* tab,
[email protected]0dd3a0ab2011-02-18 08:17:44195 bool proceed,
196 bool* proceed_to_fire_unload);
197
[email protected]0dd3a0ab2011-02-18 08:17:44198 // Sets focus to the location bar or some other place that is appropriate.
199 // This is called when the tab wants to encourage user input, like for the
200 // new tab page.
[email protected]229eb7e2011-12-23 01:04:08201 virtual void SetFocusToLocationBar(bool select_all) {}
[email protected]0dd3a0ab2011-02-18 08:17:44202
203 // Returns whether the page should be focused when transitioning from crashed
204 // to live. Default is true.
205 virtual bool ShouldFocusPageAfterCrash();
206
207 // Called when a popup select is about to be displayed. The delegate can use
208 // this to disable inactive rendering for the frame in the window the select
209 // is opened within if necessary.
[email protected]229eb7e2011-12-23 01:04:08210 virtual void RenderWidgetShowing() {}
[email protected]0dd3a0ab2011-02-18 08:17:44211
212 // This is called when WebKit tells us that it is done tabbing through
[email protected]674bc592011-12-20 23:00:42213 // controls on the page. Provides a way for WebContentsDelegates to handle
[email protected]0dd3a0ab2011-02-18 08:17:44214 // this. Returns true if the delegate successfully handled it.
[email protected]b3996ba2012-08-08 00:39:13215 virtual bool TakeFocus(WebContents* soruce,
216 bool reverse);
[email protected]0dd3a0ab2011-02-18 08:17:44217
218 // Invoked when the page loses mouse capture.
[email protected]229eb7e2011-12-23 01:04:08219 virtual void LostCapture() {}
[email protected]0dd3a0ab2011-02-18 08:17:44220
[email protected]2a6bc3e2011-12-28 23:51:33221 // Notification that |contents| has gained focus.
222 virtual void WebContentsFocused(WebContents* contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44223
[email protected]686493142011-07-15 21:47:22224 // Asks the delegate if the given tab can download.
[email protected]c0c1c622012-03-13 04:51:54225 virtual bool CanDownload(RenderViewHost* render_view_host,
226 int request_id,
227 const std::string& request_method);
[email protected]686493142011-07-15 21:47:22228
229 // Notifies the delegate that a download is starting.
[email protected]2a6bc3e2011-12-28 23:51:33230 virtual void OnStartDownload(WebContents* source, DownloadItem* download) {}
[email protected]686493142011-07-15 21:47:22231
[email protected]0dd3a0ab2011-02-18 08:17:44232 // Return much extra vertical space should be allotted to the
233 // render view widget during various animations (e.g. infobar closing).
234 // This is used to make painting look smoother.
235 virtual int GetExtraRenderViewHeight() const;
236
[email protected]0dd3a0ab2011-02-18 08:17:44237 // Returns true if the context menu operation was handled by the delegate.
[email protected]35be7ec2012-02-12 20:42:51238 virtual bool HandleContextMenu(const content::ContextMenuParams& params);
[email protected]0dd3a0ab2011-02-18 08:17:44239
240 // Returns true if the context menu command was handled
241 virtual bool ExecuteContextMenuCommand(int command);
242
[email protected]ca13a442012-04-17 14:00:12243 // Opens source view for given WebContents that is navigated to the given
[email protected]0dd3a0ab2011-02-18 08:17:44244 // page url.
[email protected]2a6bc3e2011-12-28 23:51:33245 virtual void ViewSourceForTab(WebContents* source, const GURL& page_url);
[email protected]0dd3a0ab2011-02-18 08:17:44246
[email protected]932b7a12011-03-09 12:50:27247 // Opens source view for the given subframe.
[email protected]2a6bc3e2011-12-28 23:51:33248 virtual void ViewSourceForFrame(WebContents* source,
[email protected]932b7a12011-03-09 12:50:27249 const GURL& url,
250 const std::string& content_state);
251
[email protected]0dd3a0ab2011-02-18 08:17:44252 // Allows delegates to handle keyboard events before sending to the renderer.
253 // Returns true if the |event| was handled. Otherwise, if the |event| would be
254 // handled in HandleKeyboardEvent() method as a normal keyboard shortcut,
255 // |*is_keyboard_shortcut| should be set to true.
[email protected]b3996ba2012-08-08 00:39:13256 virtual bool PreHandleKeyboardEvent(WebContents* source,
257 const NativeWebKeyboardEvent& event,
[email protected]0dd3a0ab2011-02-18 08:17:44258 bool* is_keyboard_shortcut);
259
260 // Allows delegates to handle unhandled keyboard messages coming back from
261 // the renderer.
[email protected]b3996ba2012-08-08 00:39:13262 virtual void HandleKeyboardEvent(WebContents* source,
263 const NativeWebKeyboardEvent& event) {}
[email protected]0dd3a0ab2011-02-18 08:17:44264
[email protected]229eb7e2011-12-23 01:04:08265 virtual void HandleMouseDown() {}
266 virtual void HandleMouseUp() {}
[email protected]590a634e2012-07-19 16:38:23267
268 // Handles activation resulting from a pointer event (e.g. when mouse is
269 // pressed, or a touch-gesture begins).
270 virtual void HandlePointerActivate() {}
271
272 virtual void HandleGestureBegin() {}
273 virtual void HandleGestureEnd() {}
[email protected]0dd3a0ab2011-02-18 08:17:44274
275 // Render view drag n drop ended.
[email protected]229eb7e2011-12-23 01:04:08276 virtual void DragEnded() {}
[email protected]0dd3a0ab2011-02-18 08:17:44277
278 // Shows the repost form confirmation dialog box.
[email protected]2a6bc3e2011-12-28 23:51:33279 virtual void ShowRepostFormWarningDialog(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44280
[email protected]0dd3a0ab2011-02-18 08:17:44281 // Allows delegate to override navigation to the history entries.
[email protected]2a6bc3e2011-12-28 23:51:33282 // Returns true to allow WebContents to continue with the default processing.
[email protected]0dd3a0ab2011-02-18 08:17:44283 virtual bool OnGoToEntryOffset(int offset);
284
[email protected]ca13a442012-04-17 14:00:12285 // Returns whether this WebContents should add the specified navigation to
[email protected]0dd3a0ab2011-02-18 08:17:44286 // history.
287 virtual bool ShouldAddNavigationToHistory(
288 const history::HistoryAddPageArgs& add_page_args,
[email protected]229eb7e2011-12-23 01:04:08289 NavigationType navigation_type);
[email protected]0dd3a0ab2011-02-18 08:17:44290
[email protected]ca13a442012-04-17 14:00:12291 // Returns the native window framing the view containing the WebContents.
[email protected]0dd3a0ab2011-02-18 08:17:44292 virtual gfx::NativeWindow GetFrameNativeWindow();
293
[email protected]4fdf6742012-01-10 20:14:36294 // Allows delegate to control whether a WebContents will be created. Returns
[email protected]03b6d552012-03-29 04:03:01295 // true to allow the creation. Default is to allow it. In cases where the
296 // delegate handles the creation/navigation itself, it will use |target_url|.
[email protected]4fdf6742012-01-10 20:14:36297 virtual bool ShouldCreateWebContents(
298 WebContents* web_contents,
299 int route_id,
300 WindowContainerType window_container_type,
[email protected]03b6d552012-03-29 04:03:01301 const string16& frame_name,
302 const GURL& target_url);
[email protected]4fdf6742012-01-10 20:14:36303
[email protected]2a6bc3e2011-12-28 23:51:33304 // Notifies the delegate about the creation of a new WebContents. This
[email protected]0dd3a0ab2011-02-18 08:17:44305 // typically happens when popups are created.
[email protected]4fdf6742012-01-10 20:14:36306 virtual void WebContentsCreated(WebContents* source_contents,
307 int64 source_frame_id,
308 const GURL& target_url,
309 WebContents* new_contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44310
[email protected]0dd3a0ab2011-02-18 08:17:44311 // Notifies the delegate that the content restrictions for this tab has
312 // changed.
[email protected]2a6bc3e2011-12-28 23:51:33313 virtual void ContentRestrictionsChanged(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44314
[email protected]55452902011-06-01 21:57:47315 // Notification that the tab is hung.
[email protected]2a6bc3e2011-12-28 23:51:33316 virtual void RendererUnresponsive(WebContents* source) {}
[email protected]55452902011-06-01 21:57:47317
318 // Notification that the tab is no longer hung.
[email protected]2a6bc3e2011-12-28 23:51:33319 virtual void RendererResponsive(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44320
321 // Notification that a worker associated with this tab has crashed.
[email protected]2a6bc3e2011-12-28 23:51:33322 virtual void WorkerCrashed(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44323
[email protected]09b29342011-06-24 19:18:48324 // Invoked when a main fram navigation occurs.
[email protected]3bbacc5b2012-04-17 17:46:15325 virtual void DidNavigateMainFramePostCommit(WebContents* source) {}
[email protected]93f230e02011-06-01 14:40:00326
[email protected]09b29342011-06-24 19:18:48327 // Invoked when navigating to a pending entry. When invoked the
328 // NavigationController has configured its pending entry, but it has not yet
329 // been committed.
[email protected]3bbacc5b2012-04-17 17:46:15330 virtual void DidNavigateToPendingEntry(WebContents* source) {}
[email protected]93f230e02011-06-01 14:40:00331
[email protected]51da7e32012-01-30 19:24:52332 // Returns a pointer to a service to create JavaScript dialogs. May return
333 // NULL in which case dialogs aren't shown.
[email protected]229eb7e2011-12-23 01:04:08334 virtual JavaScriptDialogCreator* GetJavaScriptDialogCreator();
[email protected]3ab9cb82011-06-03 18:02:07335
[email protected]da8543762012-03-20 08:52:20336 // Called when color chooser should open. Returns the opened color chooser.
[email protected]3bbacc5b2012-04-17 17:46:15337 virtual content::ColorChooser* OpenColorChooser(WebContents* web_contents,
[email protected]da8543762012-03-20 08:52:20338 int color_chooser_id,
[email protected]55578b0a2012-04-18 14:31:32339 SkColor color);
[email protected]da8543762012-03-20 08:52:20340
341 virtual void DidEndColorChooser() {}
342
[email protected]3a29a6e2011-08-24 18:26:21343 // Called when a file selection is to be done.
[email protected]3bbacc5b2012-04-17 17:46:15344 virtual void RunFileChooser(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08345 const FileChooserParams& params) {}
[email protected]3a29a6e2011-08-24 18:26:21346
347 // Request to enumerate a directory. This is equivalent to running the file
348 // chooser in directory-enumeration mode and having the user select the given
349 // directory.
[email protected]3bbacc5b2012-04-17 17:46:15350 virtual void EnumerateDirectory(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08351 int request_id,
352 const FilePath& path) {}
[email protected]3a29a6e2011-08-24 18:26:21353
[email protected]8a5e0ca2011-08-25 06:30:47354 // Called when the renderer puts a tab into or out of fullscreen mode.
[email protected]3bbacc5b2012-04-17 17:46:15355 virtual void ToggleFullscreenModeForTab(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08356 bool enter_fullscreen) {}
[email protected]3bbacc5b2012-04-17 17:46:15357 virtual bool IsFullscreenForTabOrPending(
358 const WebContents* web_contents) const;
[email protected]8a5e0ca2011-08-25 06:30:47359
[email protected]7d189022011-08-25 22:54:20360 // Called when a Javascript out of memory notification is received.
[email protected]3bbacc5b2012-04-17 17:46:15361 virtual void JSOutOfMemory(WebContents* web_contents) {}
[email protected]7d189022011-08-25 22:54:20362
363 // Register a new handler for URL requests with the given scheme.
[email protected]3a3b75a2012-06-01 08:38:36364 // |user_gesture| is true if the registration is made in the context of a user
365 // gesture.
[email protected]3bbacc5b2012-04-17 17:46:15366 virtual void RegisterProtocolHandler(WebContents* web_contents,
[email protected]7d189022011-08-25 22:54:20367 const std::string& protocol,
368 const GURL& url,
[email protected]3a3b75a2012-06-01 08:38:36369 const string16& title,
370 bool user_gesture) {}
[email protected]7d189022011-08-25 22:54:20371
[email protected]3a3b75a2012-06-01 08:38:36372 // Register a new Web Intents service.
373 // |user_gesture| is true if the registration is made in the context of a user
374 // gesture. |web_contents| is the context in which the registration was
375 // performed, and |data| is the service record being registered.
376 virtual void RegisterIntentHandler(
377 WebContents* web_contents,
378 const webkit_glue::WebIntentServiceData& data,
379 bool user_gesture) {}
[email protected]7d189022011-08-25 22:54:20380
[email protected]0b5af6f2012-02-03 23:14:16381 // Web Intents notification handler. See WebIntentsDispatcher for
382 // documentation of callee responsibility for the dispatcher.
[email protected]3bbacc5b2012-04-17 17:46:15383 virtual void WebIntentDispatch(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08384 WebIntentsDispatcher* intents_dispatcher);
[email protected]7d189022011-08-25 22:54:20385
[email protected]b888919c2011-09-02 00:32:16386 // Result of string search in the page. This includes the number of matches
387 // found and the selection rect (in screen coordinates) for the string found.
388 // If |final_update| is false, it indicates that more results follow.
[email protected]3bbacc5b2012-04-17 17:46:15389 virtual void FindReply(WebContents* web_contents,
[email protected]b888919c2011-09-02 00:32:16390 int request_id,
391 int number_of_matches,
392 const gfx::Rect& selection_rect,
393 int active_match_ordinal,
[email protected]229eb7e2011-12-23 01:04:08394 bool final_update) {}
[email protected]b888919c2011-09-02 00:32:16395
[email protected]59363fc92012-09-05 03:46:31396#if defined(OS_ANDROID)
397 // Provides the rects of the current find-in-page matches.
398 // Sent as a reply to RequestFindMatchRects.
399 virtual void FindMatchRectsReply(WebContents* web_contents,
400 int version,
401 const std::vector<gfx::RectF>& rects,
402 const gfx::RectF& active_rect) {}
403#endif
404
[email protected]0548c5352011-09-07 00:33:33405 // Invoked when the preferred size of the contents has been changed.
[email protected]3bbacc5b2012-04-17 17:46:15406 virtual void UpdatePreferredSize(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08407 const gfx::Size& pref_size) {}
[email protected]0548c5352011-09-07 00:33:33408
[email protected]61e2b3cc2012-03-02 16:13:34409 // Invoked when the contents auto-resized and the container should match it.
[email protected]3bbacc5b2012-04-17 17:46:15410 virtual void ResizeDueToAutoResize(WebContents* web_contents,
[email protected]61e2b3cc2012-03-02 16:13:34411 const gfx::Size& new_size) {}
412
[email protected]32ded2212011-11-10 18:51:43413 // Notification message from HTML UI.
[email protected]3bbacc5b2012-04-17 17:46:15414 virtual void WebUISend(WebContents* web_contents,
[email protected]32ded2212011-11-10 18:51:43415 const GURL& source_url,
416 const std::string& name,
[email protected]229eb7e2011-12-23 01:04:08417 const base::ListValue& args) {}
[email protected]32ded2212011-11-10 18:51:43418
[email protected]e9621112011-10-17 05:38:37419 // Requests to lock the mouse. Once the request is approved or rejected,
420 // GotResponseToLockMouseRequest() will be called on the requesting tab
421 // contents.
[email protected]42252e02012-04-26 16:29:39422 virtual void RequestToLockMouse(WebContents* web_contents,
[email protected]a9c81f02012-06-01 00:15:44423 bool user_gesture,
[email protected]f13b4202012-06-12 23:53:23424 bool last_unlocked_by_target) {}
[email protected]e9621112011-10-17 05:38:37425
426 // Notification that the page has lost the mouse lock.
[email protected]229eb7e2011-12-23 01:04:08427 virtual void LostMouseLock() {}
[email protected]e9621112011-10-17 05:38:37428
[email protected]f13b4202012-06-12 23:53:23429 // Asks permission to use the camera and/or microphone. If permission is
430 // granted, a call should be made to |callback| with the devices. If the
431 // request is denied, a call should be made to |callback| with an empty list
432 // of devices. |request| has the details of the request (e.g. which of audio
433 // and/or video devices are requested, and lists of available devices).
434 virtual void RequestMediaAccessPermission(
435 WebContents* web_contents,
436 const MediaStreamRequest* request,
437 const MediaResponseCallback& callback) {}
438
[email protected]16383382012-09-05 23:57:26439#if defined(OS_ANDROID)
440 // Returns true if the delegate wants to handle the url instead. Default
441 // returns false.
442 virtual bool ShouldOverrideLoading(const GURL& url);
443
444 // Called when a compositing layer becomes available for this web contents
445 // so the delegate can add it to the layer tree.
446 virtual void AttachLayer(WebContents* web_contents,
447 WebKit::WebLayer* layer) {}
448
449 // Called before a compositing layer becomes invalid so the delegate can
450 // remove it from the layer tree.
451 virtual void RemoveLayer(WebContents* web_contents,
452 WebKit::WebLayer* layer) {}
453#endif
454
[email protected]0dd3a0ab2011-02-18 08:17:44455 protected:
[email protected]674bc592011-12-20 23:00:42456 virtual ~WebContentsDelegate();
[email protected]1de2b8b2011-06-29 19:38:46457
458 private:
[email protected]b172aee2012-04-10 17:05:26459 friend class ::WebContentsImpl;
[email protected]1de2b8b2011-06-29 19:38:46460
[email protected]674bc592011-12-20 23:00:42461 // Called when |this| becomes the WebContentsDelegate for |source|.
[email protected]2a6bc3e2011-12-28 23:51:33462 void Attach(WebContents* source);
[email protected]1de2b8b2011-06-29 19:38:46463
[email protected]674bc592011-12-20 23:00:42464 // Called when |this| is no longer the WebContentsDelegate for |source|.
[email protected]2a6bc3e2011-12-28 23:51:33465 void Detach(WebContents* source);
[email protected]1de2b8b2011-06-29 19:38:46466
[email protected]2a6bc3e2011-12-28 23:51:33467 // The WebContents that this is currently a delegate for.
468 std::set<WebContents*> attached_contents_;
[email protected]0dd3a0ab2011-02-18 08:17:44469};
470
[email protected]674bc592011-12-20 23:00:42471} // namespace content
472
473#endif // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_