blob: 0e019a991c0456f3b4db82095e62040777ffa729 [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]26dd01c2013-06-12 13:52:1313#include "base/strings/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]2255a9332013-06-17 05:12:3119#include "third_party/WebKit/public/web/WebDragOperation.h"
[email protected]da8543762012-03-20 08:52:2020#include "third_party/skia/include/core/SkColor.h"
[email protected]f47621b2013-01-22 20:50:3321#include "ui/base/window_open_disposition.h"
[email protected]0dd3a0ab2011-02-18 08:17:4422#include "ui/gfx/native_widget_types.h"
[email protected]59363fc92012-09-05 03:46:3123#include "ui/gfx/rect_f.h"
[email protected]9b003482013-05-21 14:00:1724#include "ui/gfx/vector2d.h"
[email protected]0dd3a0ab2011-02-18 08:17:4425
[email protected]7dba43dc2011-11-10 01:57:5826class GURL;
[email protected]7dba43dc2011-11-10 01:57:5827
[email protected]32ded2212011-11-10 18:51:4328namespace base {
[email protected]a3ef4832013-02-02 05:12:3329class FilePath;
[email protected]32ded2212011-11-10 18:51:4330class ListValue;
31}
32
[email protected]3ab9cb82011-06-03 18:02:0733namespace content {
[email protected]3d7474ff2011-07-27 17:47:3734class BrowserContext;
[email protected]da8543762012-03-20 08:52:2035class ColorChooser;
[email protected]e582fdd2011-12-20 16:48:1736class DownloadItem;
[email protected]71a88bb2013-02-01 22:05:1537class JavaScriptDialogManager;
[email protected]691aa2f2013-05-28 22:52:0438class PageState;
[email protected]c0c1c622012-03-13 04:51:5439class RenderViewHost;
[email protected]dd6730412013-08-14 15:03:3740class SessionStorageNamespace;
[email protected]a81343d232011-12-27 07:39:2041class WebContents;
[email protected]8ff00d72012-10-23 19:12:2142class WebContentsImpl;
[email protected]35be7ec2012-02-12 20:42:5143struct ContextMenuParams;
[email protected]dc293a72013-07-01 11:11:2244struct DropData;
[email protected]e582fdd2011-12-20 16:48:1745struct FileChooserParams;
[email protected]b87ee522012-05-18 15:16:5446struct NativeWebKeyboardEvent;
[email protected]44e55b012013-07-23 14:21:5647struct Referrer;
[email protected]d583e3f22011-12-27 21:38:1748struct SSLStatus;
[email protected]3ab9cb82011-06-03 18:02:0749}
50
[email protected]0dd3a0ab2011-02-18 08:17:4451namespace gfx {
52class Point;
53class Rect;
54class Size;
55}
56
[email protected]16383382012-09-05 23:57:2657namespace WebKit {
58class WebLayer;
[email protected]453c1b22013-07-23 09:31:4859struct WebWindowFeatures;
[email protected]16383382012-09-05 23:57:2660}
61
[email protected]674bc592011-12-20 23:00:4262namespace content {
63
[email protected]e5d549d2011-12-28 01:29:2064struct OpenURLParams;
65
[email protected]0dd3a0ab2011-02-18 08:17:4466// Objects implement this interface to get notified about changes in the
[email protected]2a6bc3e2011-12-28 23:51:3367// WebContents and to provide necessary functionality.
[email protected]674bc592011-12-20 23:00:4268class CONTENT_EXPORT WebContentsDelegate {
[email protected]0dd3a0ab2011-02-18 08:17:4469 public:
[email protected]674bc592011-12-20 23:00:4270 WebContentsDelegate();
[email protected]1de2b8b2011-06-29 19:38:4671
[email protected]e5d549d2011-12-28 01:29:2072 // Opens a new URL inside the passed in WebContents (if source is 0 open
[email protected]0dd3a0ab2011-02-18 08:17:4473 // in the current front-most tab), unless |disposition| indicates the url
74 // should be opened in a new tab or window.
75 //
76 // A NULL source indicates the current tab (callers should probably use
77 // OpenURL() for these cases which does it for you).
[email protected]00c37fc2011-08-02 00:22:5078
[email protected]e5d549d2011-12-28 01:29:2079 // Returns the WebContents the URL is opened in, or NULL if the URL wasn't
[email protected]992e4542011-07-20 23:09:2580 // opened immediately.
[email protected]e5d549d2011-12-28 01:29:2081 virtual WebContents* OpenURLFromTab(WebContents* source,
[email protected]00c37fc2011-08-02 00:22:5082 const OpenURLParams& params);
83
[email protected]ca13a442012-04-17 14:00:1284 // Called to inform the delegate that the WebContents's navigation state
[email protected]0dd3a0ab2011-02-18 08:17:4485 // changed. The |changed_flags| indicates the parts of the navigation state
86 // that have been updated, and is any combination of the
[email protected]2a6bc3e2011-12-28 23:51:3387 // |WebContents::InvalidateTypes| bits.
88 virtual void NavigationStateChanged(const WebContents* source,
[email protected]229eb7e2011-12-23 01:04:0889 unsigned changed_flags) {}
[email protected]0dd3a0ab2011-02-18 08:17:4490
[email protected]6c6b02d2011-09-02 03:36:4791 // Adds the navigation request headers to |headers|. Use
[email protected]0dd3a0ab2011-02-18 08:17:4492 // net::HttpUtil::AppendHeaderIfMissing to build the set of headers.
[email protected]229eb7e2011-12-23 01:04:0893 virtual void AddNavigationHeaders(const GURL& url, std::string* headers) {}
[email protected]0dd3a0ab2011-02-18 08:17:4494
[email protected]2a6bc3e2011-12-28 23:51:3395 // Creates a new tab with the already-created WebContents 'new_contents'.
[email protected]0dd3a0ab2011-02-18 08:17:4496 // The window for the added contents should be reparented correctly when this
[email protected]dc0fd432013-08-27 15:29:2197 // method returns. If |disposition| is NEW_POPUP, |initial_pos| should hold
98 // the initial position. If |was_blocked| is non-NULL, then |*was_blocked|
99 // will be set to true if the popup gets blocked, and left unchanged
100 // otherwise.
[email protected]2a6bc3e2011-12-28 23:51:33101 virtual void AddNewContents(WebContents* source,
102 WebContents* new_contents,
[email protected]0dd3a0ab2011-02-18 08:17:44103 WindowOpenDisposition disposition,
104 const gfx::Rect& initial_pos,
[email protected]eda238a12012-09-07 23:44:00105 bool user_gesture,
106 bool* was_blocked) {}
[email protected]0dd3a0ab2011-02-18 08:17:44107
108 // Selects the specified contents, bringing its container to the front.
[email protected]2a6bc3e2011-12-28 23:51:33109 virtual void ActivateContents(WebContents* contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44110
111 // Deactivates the specified contents by deactivating its container and
112 // potentialy moving it to the back of the Z order.
[email protected]2a6bc3e2011-12-28 23:51:33113 virtual void DeactivateContents(WebContents* contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44114
115 // Notifies the delegate that this contents is starting or is done loading
116 // some resource. The delegate should use this notification to represent
[email protected]2a6bc3e2011-12-28 23:51:33117 // loading feedback. See WebContents::IsLoading()
118 virtual void LoadingStateChanged(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44119
[email protected]8e603cd92012-10-23 22:29:26120#if defined(OS_ANDROID)
[email protected]0dd3a0ab2011-02-18 08:17:44121 // Notifies the delegate that the page has made some progress loading.
122 // |progress| is a value between 0.0 (nothing loaded) to 1.0 (page fully
123 // loaded).
[email protected]b3996ba2012-08-08 00:39:13124 virtual void LoadProgressChanged(WebContents* source,
125 double progress) {}
[email protected]8e603cd92012-10-23 22:29:26126#endif
[email protected]0dd3a0ab2011-02-18 08:17:44127
[email protected]2a6bc3e2011-12-28 23:51:33128 // Request the delegate to close this web contents, and do whatever cleanup
[email protected]0dd3a0ab2011-02-18 08:17:44129 // it needs to do.
[email protected]a81343d232011-12-27 07:39:20130 virtual void CloseContents(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44131
[email protected]cd9ed79d2011-11-15 19:22:57132 // Informs the delegate that the underlying RenderViewHost has been swapped
133 // out so it can perform any cleanup necessary.
[email protected]2a6bc3e2011-12-28 23:51:33134 virtual void SwappedOut(WebContents* source) {}
[email protected]cd9ed79d2011-11-15 19:22:57135
[email protected]ca13a442012-04-17 14:00:12136 // Request the delegate to move this WebContents to the specified position
[email protected]0dd3a0ab2011-02-18 08:17:44137 // in screen coordinates.
[email protected]2a6bc3e2011-12-28 23:51:33138 virtual void MoveContents(WebContents* source, const gfx::Rect& pos) {}
[email protected]0dd3a0ab2011-02-18 08:17:44139
[email protected]2a6bc3e2011-12-28 23:51:33140 // Called to determine if the WebContents is contained in a popup window
[email protected]b35b26b32011-05-05 20:35:14141 // or a panel window.
[email protected]2a6bc3e2011-12-28 23:51:33142 virtual bool IsPopupOrPanel(const WebContents* source) const;
[email protected]0dd3a0ab2011-02-18 08:17:44143
[email protected]0dd3a0ab2011-02-18 08:17:44144 // Notification that the target URL has changed.
[email protected]2a6bc3e2011-12-28 23:51:33145 virtual void UpdateTargetURL(WebContents* source,
[email protected]229eb7e2011-12-23 01:04:08146 int32 page_id,
147 const GURL& url) {}
[email protected]0dd3a0ab2011-02-18 08:17:44148
149 // Notification that there was a mouse event, along with the absolute
150 // coordinates of the mouse pointer and whether it was a normal motion event
151 // (otherwise, the pointer left the contents area).
[email protected]2a6bc3e2011-12-28 23:51:33152 virtual void ContentsMouseEvent(WebContents* source,
[email protected]229eb7e2011-12-23 01:04:08153 const gfx::Point& location,
154 bool motion) {}
[email protected]0dd3a0ab2011-02-18 08:17:44155
156 // Request the delegate to change the zoom level of the current tab.
[email protected]229eb7e2011-12-23 01:04:08157 virtual void ContentsZoomChange(bool zoom_in) {}
[email protected]0dd3a0ab2011-02-18 08:17:44158
[email protected]067310262012-11-22 14:30:41159 // Called to determine if the WebContents can be overscrolled with touch/wheel
160 // gestures.
161 virtual bool CanOverscrollContent() const;
162
[email protected]888878e82013-07-24 22:49:40163 // Callback that allows vertical overscroll activies to be communicated to the
164 // delegate.
165 virtual void OverscrollUpdate(int delta_y) {}
166
[email protected]24e18252012-04-16 21:26:27167 // Check whether this contents is permitted to load data URLs in WebUI mode.
168 // This is normally disallowed for security.
169 virtual bool CanLoadDataURLsInWebUI() const;
170
[email protected]b7a756d42012-01-23 18:08:17171 // Return the rect where to display the resize corner, if any, otherwise
172 // an empty rect.
173 virtual gfx::Rect GetRootWindowResizerRect() const;
174
[email protected]0dd3a0ab2011-02-18 08:17:44175 // Invoked prior to showing before unload handler confirmation dialog.
[email protected]229eb7e2011-12-23 01:04:08176 virtual void WillRunBeforeUnloadConfirm() {}
[email protected]0dd3a0ab2011-02-18 08:17:44177
178 // Returns true if javascript dialogs and unload alerts are suppressed.
179 // Default is false.
180 virtual bool ShouldSuppressDialogs();
181
[email protected]a796f202012-05-30 14:14:25182 // Add a message to the console. Returning true indicates that the delegate
183 // handled the message. If false is returned the default logging mechanism
184 // will be used for the message.
[email protected]0c9406632013-02-08 01:13:33185 virtual bool AddMessageToConsole(WebContents* source,
[email protected]a796f202012-05-30 14:14:25186 int32 level,
187 const string16& message,
188 int32 line_no,
189 const string16& source_id);
190
[email protected]0dd3a0ab2011-02-18 08:17:44191 // Tells us that we've finished firing this tab's beforeunload event.
192 // The proceed bool tells us whether the user chose to proceed closing the
[email protected]a2c92a1c2012-04-03 12:32:14193 // tab. Returns true if the tab can continue on firing its unload event.
[email protected]0dd3a0ab2011-02-18 08:17:44194 // If we're closing the entire browser, then we'll want to delay firing
195 // unload events until all the beforeunload events have fired.
[email protected]2a6bc3e2011-12-28 23:51:33196 virtual void BeforeUnloadFired(WebContents* tab,
[email protected]0dd3a0ab2011-02-18 08:17:44197 bool proceed,
198 bool* proceed_to_fire_unload);
199
[email protected]0c9406632013-02-08 01:13:33200 // Returns true if the location bar should be focused by default rather than
[email protected]af4b5f92013-03-05 07:48:38201 // the page contents. NOTE: this is only used if WebContents can't determine
202 // for itself whether the location bar should be focused by default. For a
203 // complete check, you should use WebContents::FocusLocationBarByDefault().
[email protected]0c9406632013-02-08 01:13:33204 virtual bool ShouldFocusLocationBarByDefault(WebContents* source);
205
[email protected]0dd3a0ab2011-02-18 08:17:44206 // Sets focus to the location bar or some other place that is appropriate.
207 // This is called when the tab wants to encourage user input, like for the
208 // new tab page.
[email protected]229eb7e2011-12-23 01:04:08209 virtual void SetFocusToLocationBar(bool select_all) {}
[email protected]0dd3a0ab2011-02-18 08:17:44210
211 // Returns whether the page should be focused when transitioning from crashed
212 // to live. Default is true.
213 virtual bool ShouldFocusPageAfterCrash();
214
215 // Called when a popup select is about to be displayed. The delegate can use
216 // this to disable inactive rendering for the frame in the window the select
217 // is opened within if necessary.
[email protected]229eb7e2011-12-23 01:04:08218 virtual void RenderWidgetShowing() {}
[email protected]0dd3a0ab2011-02-18 08:17:44219
220 // This is called when WebKit tells us that it is done tabbing through
[email protected]674bc592011-12-20 23:00:42221 // controls on the page. Provides a way for WebContentsDelegates to handle
[email protected]0dd3a0ab2011-02-18 08:17:44222 // this. Returns true if the delegate successfully handled it.
[email protected]0c9406632013-02-08 01:13:33223 virtual bool TakeFocus(WebContents* source,
[email protected]b3996ba2012-08-08 00:39:13224 bool reverse);
[email protected]0dd3a0ab2011-02-18 08:17:44225
226 // Invoked when the page loses mouse capture.
[email protected]229eb7e2011-12-23 01:04:08227 virtual void LostCapture() {}
[email protected]0dd3a0ab2011-02-18 08:17:44228
[email protected]2a6bc3e2011-12-28 23:51:33229 // Notification that |contents| has gained focus.
230 virtual void WebContentsFocused(WebContents* contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44231
[email protected]686493142011-07-15 21:47:22232 // Asks the delegate if the given tab can download.
[email protected]f85f5032013-04-03 09:01:54233 // Invoking the |callback| synchronously is OK.
234 virtual void CanDownload(RenderViewHost* render_view_host,
[email protected]c0c1c622012-03-13 04:51:54235 int request_id,
[email protected]f85f5032013-04-03 09:01:54236 const std::string& request_method,
237 const base::Callback<void(bool)>& callback);
[email protected]686493142011-07-15 21:47:22238
[email protected]0dd3a0ab2011-02-18 08:17:44239 // Return much extra vertical space should be allotted to the
240 // render view widget during various animations (e.g. infobar closing).
241 // This is used to make painting look smoother.
242 virtual int GetExtraRenderViewHeight() const;
243
[email protected]0dd3a0ab2011-02-18 08:17:44244 // Returns true if the context menu operation was handled by the delegate.
[email protected]35be7ec2012-02-12 20:42:51245 virtual bool HandleContextMenu(const content::ContextMenuParams& params);
[email protected]0dd3a0ab2011-02-18 08:17:44246
[email protected]ca13a442012-04-17 14:00:12247 // Opens source view for given WebContents that is navigated to the given
[email protected]0dd3a0ab2011-02-18 08:17:44248 // page url.
[email protected]2a6bc3e2011-12-28 23:51:33249 virtual void ViewSourceForTab(WebContents* source, const GURL& page_url);
[email protected]0dd3a0ab2011-02-18 08:17:44250
[email protected]932b7a12011-03-09 12:50:27251 // Opens source view for the given subframe.
[email protected]2a6bc3e2011-12-28 23:51:33252 virtual void ViewSourceForFrame(WebContents* source,
[email protected]932b7a12011-03-09 12:50:27253 const GURL& url,
[email protected]691aa2f2013-05-28 22:52:04254 const PageState& page_state);
[email protected]932b7a12011-03-09 12:50:27255
[email protected]0dd3a0ab2011-02-18 08:17:44256 // Allows delegates to handle keyboard events before sending to the renderer.
257 // Returns true if the |event| was handled. Otherwise, if the |event| would be
258 // handled in HandleKeyboardEvent() method as a normal keyboard shortcut,
259 // |*is_keyboard_shortcut| should be set to true.
[email protected]b3996ba2012-08-08 00:39:13260 virtual bool PreHandleKeyboardEvent(WebContents* source,
261 const NativeWebKeyboardEvent& event,
[email protected]0dd3a0ab2011-02-18 08:17:44262 bool* is_keyboard_shortcut);
263
264 // Allows delegates to handle unhandled keyboard messages coming back from
265 // the renderer.
[email protected]b3996ba2012-08-08 00:39:13266 virtual void HandleKeyboardEvent(WebContents* source,
267 const NativeWebKeyboardEvent& event) {}
[email protected]0dd3a0ab2011-02-18 08:17:44268
[email protected]229eb7e2011-12-23 01:04:08269 virtual void HandleMouseDown() {}
270 virtual void HandleMouseUp() {}
[email protected]590a634e2012-07-19 16:38:23271
272 // Handles activation resulting from a pointer event (e.g. when mouse is
273 // pressed, or a touch-gesture begins).
274 virtual void HandlePointerActivate() {}
275
276 virtual void HandleGestureBegin() {}
277 virtual void HandleGestureEnd() {}
[email protected]0dd3a0ab2011-02-18 08:17:44278
[email protected]090550f2013-06-11 15:04:47279 // Called when an external drag event enters the web contents window. Return
280 // true to allow dragging and dropping on the web contents window or false to
281 // cancel the operation. This method is used by Chromium Embedded Framework.
282 virtual bool CanDragEnter(WebContents* source,
[email protected]dc293a72013-07-01 11:11:22283 const DropData& data,
[email protected]090550f2013-06-11 15:04:47284 WebKit::WebDragOperationsMask operations_allowed);
285
[email protected]0dd3a0ab2011-02-18 08:17:44286 // Render view drag n drop ended.
[email protected]229eb7e2011-12-23 01:04:08287 virtual void DragEnded() {}
[email protected]0dd3a0ab2011-02-18 08:17:44288
289 // Shows the repost form confirmation dialog box.
[email protected]2a6bc3e2011-12-28 23:51:33290 virtual void ShowRepostFormWarningDialog(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44291
[email protected]0dd3a0ab2011-02-18 08:17:44292 // Allows delegate to override navigation to the history entries.
[email protected]2a6bc3e2011-12-28 23:51:33293 // Returns true to allow WebContents to continue with the default processing.
[email protected]0dd3a0ab2011-02-18 08:17:44294 virtual bool OnGoToEntryOffset(int offset);
295
[email protected]4fdf6742012-01-10 20:14:36296 // Allows delegate to control whether a WebContents will be created. Returns
[email protected]03b6d552012-03-29 04:03:01297 // true to allow the creation. Default is to allow it. In cases where the
298 // delegate handles the creation/navigation itself, it will use |target_url|.
[email protected]4fdf6742012-01-10 20:14:36299 virtual bool ShouldCreateWebContents(
300 WebContents* web_contents,
301 int route_id,
302 WindowContainerType window_container_type,
[email protected]03b6d552012-03-29 04:03:01303 const string16& frame_name,
[email protected]4543b67c2013-07-11 18:18:36304 const GURL& target_url,
[email protected]dd6730412013-08-14 15:03:37305 const std::string& partition_id,
306 SessionStorageNamespace* session_storage_namespace);
[email protected]4fdf6742012-01-10 20:14:36307
[email protected]2a6bc3e2011-12-28 23:51:33308 // Notifies the delegate about the creation of a new WebContents. This
[email protected]0dd3a0ab2011-02-18 08:17:44309 // typically happens when popups are created.
[email protected]4fdf6742012-01-10 20:14:36310 virtual void WebContentsCreated(WebContents* source_contents,
311 int64 source_frame_id,
[email protected]50de3222013-03-20 15:36:13312 const string16& frame_name,
[email protected]4fdf6742012-01-10 20:14:36313 const GURL& target_url,
314 WebContents* new_contents) {}
[email protected]0dd3a0ab2011-02-18 08:17:44315
[email protected]55452902011-06-01 21:57:47316 // Notification that the tab is hung.
[email protected]2a6bc3e2011-12-28 23:51:33317 virtual void RendererUnresponsive(WebContents* source) {}
[email protected]55452902011-06-01 21:57:47318
319 // Notification that the tab is no longer hung.
[email protected]2a6bc3e2011-12-28 23:51:33320 virtual void RendererResponsive(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44321
322 // Notification that a worker associated with this tab has crashed.
[email protected]2a6bc3e2011-12-28 23:51:33323 virtual void WorkerCrashed(WebContents* source) {}
[email protected]0dd3a0ab2011-02-18 08:17:44324
[email protected]09b29342011-06-24 19:18:48325 // Invoked when a main fram navigation occurs.
[email protected]3bbacc5b2012-04-17 17:46:15326 virtual void DidNavigateMainFramePostCommit(WebContents* source) {}
[email protected]93f230e02011-06-01 14:40:00327
[email protected]09b29342011-06-24 19:18:48328 // Invoked when navigating to a pending entry. When invoked the
329 // NavigationController has configured its pending entry, but it has not yet
330 // been committed.
[email protected]3bbacc5b2012-04-17 17:46:15331 virtual void DidNavigateToPendingEntry(WebContents* source) {}
[email protected]93f230e02011-06-01 14:40:00332
[email protected]71a88bb2013-02-01 22:05:15333 // Returns a pointer to a service to manage JavaScript dialogs. May return
[email protected]51da7e32012-01-30 19:24:52334 // NULL in which case dialogs aren't shown.
[email protected]71a88bb2013-02-01 22:05:15335 virtual JavaScriptDialogManager* GetJavaScriptDialogManager();
[email protected]3ab9cb82011-06-03 18:02:07336
[email protected]da8543762012-03-20 08:52:20337 // Called when color chooser should open. Returns the opened color chooser.
[email protected]36193fcf2012-11-30 20:01:57338 // Ownership of the returned pointer is transferred to the caller.
[email protected]cb805452013-05-22 15:16:21339 virtual ColorChooser* OpenColorChooser(WebContents* web_contents,
340 SkColor color);
[email protected]da8543762012-03-20 08:52:20341
[email protected]3a29a6e2011-08-24 18:26:21342 // Called when a file selection is to be done.
[email protected]3bbacc5b2012-04-17 17:46:15343 virtual void RunFileChooser(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08344 const FileChooserParams& params) {}
[email protected]3a29a6e2011-08-24 18:26:21345
346 // Request to enumerate a directory. This is equivalent to running the file
347 // chooser in directory-enumeration mode and having the user select the given
348 // directory.
[email protected]3bbacc5b2012-04-17 17:46:15349 virtual void EnumerateDirectory(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08350 int request_id,
[email protected]a3ef4832013-02-02 05:12:33351 const base::FilePath& path) {}
[email protected]3a29a6e2011-08-24 18:26:21352
[email protected]8a5e0ca2011-08-25 06:30:47353 // Called when the renderer puts a tab into or out of fullscreen mode.
[email protected]3bbacc5b2012-04-17 17:46:15354 virtual void ToggleFullscreenModeForTab(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08355 bool enter_fullscreen) {}
[email protected]3bbacc5b2012-04-17 17:46:15356 virtual bool IsFullscreenForTabOrPending(
357 const WebContents* web_contents) const;
[email protected]8a5e0ca2011-08-25 06:30:47358
[email protected]9b003482013-05-21 14:00:17359 // Called when the renderer has scrolled programmatically.
360 virtual void DidProgrammaticallyScroll(WebContents* web_contents,
361 const gfx::Vector2d& scroll_point) {}
362
[email protected]7d189022011-08-25 22:54:20363 // Called when a Javascript out of memory notification is received.
[email protected]3bbacc5b2012-04-17 17:46:15364 virtual void JSOutOfMemory(WebContents* web_contents) {}
[email protected]7d189022011-08-25 22:54:20365
366 // Register a new handler for URL requests with the given scheme.
[email protected]3a3b75a2012-06-01 08:38:36367 // |user_gesture| is true if the registration is made in the context of a user
368 // gesture.
[email protected]3bbacc5b2012-04-17 17:46:15369 virtual void RegisterProtocolHandler(WebContents* web_contents,
[email protected]7d189022011-08-25 22:54:20370 const std::string& protocol,
371 const GURL& url,
[email protected]3a3b75a2012-06-01 08:38:36372 const string16& title,
373 bool user_gesture) {}
[email protected]7d189022011-08-25 22:54:20374
[email protected]b888919c2011-09-02 00:32:16375 // Result of string search in the page. This includes the number of matches
376 // found and the selection rect (in screen coordinates) for the string found.
377 // If |final_update| is false, it indicates that more results follow.
[email protected]3bbacc5b2012-04-17 17:46:15378 virtual void FindReply(WebContents* web_contents,
[email protected]b888919c2011-09-02 00:32:16379 int request_id,
380 int number_of_matches,
381 const gfx::Rect& selection_rect,
382 int active_match_ordinal,
[email protected]229eb7e2011-12-23 01:04:08383 bool final_update) {}
[email protected]b888919c2011-09-02 00:32:16384
[email protected]59363fc92012-09-05 03:46:31385#if defined(OS_ANDROID)
386 // Provides the rects of the current find-in-page matches.
387 // Sent as a reply to RequestFindMatchRects.
388 virtual void FindMatchRectsReply(WebContents* web_contents,
389 int version,
390 const std::vector<gfx::RectF>& rects,
391 const gfx::RectF& active_rect) {}
392#endif
393
[email protected]0548c5352011-09-07 00:33:33394 // Invoked when the preferred size of the contents has been changed.
[email protected]3bbacc5b2012-04-17 17:46:15395 virtual void UpdatePreferredSize(WebContents* web_contents,
[email protected]229eb7e2011-12-23 01:04:08396 const gfx::Size& pref_size) {}
[email protected]0548c5352011-09-07 00:33:33397
[email protected]61e2b3cc2012-03-02 16:13:34398 // Invoked when the contents auto-resized and the container should match it.
[email protected]3bbacc5b2012-04-17 17:46:15399 virtual void ResizeDueToAutoResize(WebContents* web_contents,
[email protected]61e2b3cc2012-03-02 16:13:34400 const gfx::Size& new_size) {}
401
[email protected]32ded2212011-11-10 18:51:43402 // Notification message from HTML UI.
[email protected]3bbacc5b2012-04-17 17:46:15403 virtual void WebUISend(WebContents* web_contents,
[email protected]32ded2212011-11-10 18:51:43404 const GURL& source_url,
405 const std::string& name,
[email protected]229eb7e2011-12-23 01:04:08406 const base::ListValue& args) {}
[email protected]32ded2212011-11-10 18:51:43407
[email protected]e9621112011-10-17 05:38:37408 // Requests to lock the mouse. Once the request is approved or rejected,
409 // GotResponseToLockMouseRequest() will be called on the requesting tab
410 // contents.
[email protected]42252e02012-04-26 16:29:39411 virtual void RequestToLockMouse(WebContents* web_contents,
[email protected]a9c81f02012-06-01 00:15:44412 bool user_gesture,
[email protected]f13b4202012-06-12 23:53:23413 bool last_unlocked_by_target) {}
[email protected]e9621112011-10-17 05:38:37414
415 // Notification that the page has lost the mouse lock.
[email protected]229eb7e2011-12-23 01:04:08416 virtual void LostMouseLock() {}
[email protected]e9621112011-10-17 05:38:37417
[email protected]f13b4202012-06-12 23:53:23418 // Asks permission to use the camera and/or microphone. If permission is
419 // granted, a call should be made to |callback| with the devices. If the
420 // request is denied, a call should be made to |callback| with an empty list
421 // of devices. |request| has the details of the request (e.g. which of audio
422 // and/or video devices are requested, and lists of available devices).
423 virtual void RequestMediaAccessPermission(
424 WebContents* web_contents,
[email protected]33662e52013-01-07 21:31:09425 const MediaStreamRequest& request,
[email protected]f13b4202012-06-12 23:53:23426 const MediaResponseCallback& callback) {}
427
[email protected]8c8fc292012-11-23 18:57:16428 // Requests permission to access the PPAPI broker. The delegate should return
429 // true and call the passed in |callback| with the result, or return false
430 // to indicate that it does not support asking for permission.
431 virtual bool RequestPpapiBrokerPermission(
432 WebContents* web_contents,
433 const GURL& url,
[email protected]a3ef4832013-02-02 05:12:33434 const base::FilePath& plugin_path,
[email protected]8c8fc292012-11-23 18:57:16435 const base::Callback<void(bool)>& callback);
436
[email protected]dc0fd432013-08-27 15:29:21437 // Returns the size for the new render view created for the pending entry in
438 // |web_contents|; if there's no size, returns an empty size.
439 // This is optional for implementations of WebContentsDelegate; if the
440 // delegate doesn't provide a size, the current WebContentsView's size will be
441 // used.
442 virtual gfx::Size GetSizeForNewRenderView(
443 const WebContents* web_contents) const;
444
[email protected]0dd3a0ab2011-02-18 08:17:44445 protected:
[email protected]674bc592011-12-20 23:00:42446 virtual ~WebContentsDelegate();
[email protected]1de2b8b2011-06-29 19:38:46447
448 private:
[email protected]8ff00d72012-10-23 19:12:21449 friend class WebContentsImpl;
[email protected]1de2b8b2011-06-29 19:38:46450
[email protected]674bc592011-12-20 23:00:42451 // Called when |this| becomes the WebContentsDelegate for |source|.
[email protected]2a6bc3e2011-12-28 23:51:33452 void Attach(WebContents* source);
[email protected]1de2b8b2011-06-29 19:38:46453
[email protected]674bc592011-12-20 23:00:42454 // Called when |this| is no longer the WebContentsDelegate for |source|.
[email protected]2a6bc3e2011-12-28 23:51:33455 void Detach(WebContents* source);
[email protected]1de2b8b2011-06-29 19:38:46456
[email protected]2a6bc3e2011-12-28 23:51:33457 // The WebContents that this is currently a delegate for.
458 std::set<WebContents*> attached_contents_;
[email protected]0dd3a0ab2011-02-18 08:17:44459};
460
[email protected]674bc592011-12-20 23:00:42461} // namespace content
462
463#endif // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_