[email protected] | 9f4f332 | 2012-01-18 22:29:56 | [diff] [blame] | 1 | // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
license.bot | bf09a50 | 2008-08-24 00:55:55 | [diff] [blame] | 2 | // Use of this source code is governed by a BSD-style license that can be |
| 3 | // found in the LICENSE file. |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 4 | |
[email protected] | 2cff005 | 2011-03-18 16:51:44 | [diff] [blame] | 5 | #ifndef CONTENT_RENDERER_RENDER_WIDGET_H_ |
| 6 | #define CONTENT_RENDERER_RENDER_WIDGET_H_ |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 7 | |
[email protected] | aa4117f | 2011-12-09 22:19:21 | [diff] [blame] | 8 | #include <deque> |
[email protected] | 0e241b4b | 2012-08-18 09:06:27 | [diff] [blame] | 9 | #include <map> |
[email protected] | 010ea08a | 2009-10-11 20:21:32 | [diff] [blame] | 10 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 11 | #include "base/basictypes.h" |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 12 | #include "base/callback.h" |
[email protected] | f3112a5 | 2011-09-30 23:47:49 | [diff] [blame] | 13 | #include "base/compiler_specific.h" |
[email protected] | 3b63f8f4 | 2011-03-28 01:54:15 | [diff] [blame] | 14 | #include "base/memory/ref_counted.h" |
[email protected] | 8704f89b | 2011-04-15 00:30:05 | [diff] [blame] | 15 | #include "base/memory/scoped_ptr.h" |
[email protected] | bffc830 | 2014-01-23 20:52:16 | [diff] [blame] | 16 | #include "base/observer_list.h" |
[email protected] | abb52216 | 2013-06-28 01:54:16 | [diff] [blame] | 17 | #include "base/time/time.h" |
[email protected] | f3112a5 | 2011-09-30 23:47:49 | [diff] [blame] | 18 | #include "content/common/content_export.h" |
[email protected] | c2809346d | 2014-03-20 00:11:03 | [diff] [blame] | 19 | #include "content/common/cursors/webcursor.h" |
[email protected] | ed7defa | 2013-03-12 21:29:59 | [diff] [blame] | 20 | #include "content/common/gpu/client/webgraphicscontext3d_command_buffer_impl.h" |
[email protected] | 9017d785 | 2013-11-21 17:47:35 | [diff] [blame] | 21 | #include "content/common/input/synthetic_gesture_params.h" |
fsamuel | 72464894f | 2015-12-15 06:59:31 | [diff] [blame] | 22 | #include "content/renderer/input/render_widget_input_handler.h" |
| 23 | #include "content/renderer/input/render_widget_input_handler_delegate.h" |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 24 | #include "content/renderer/message_delivery_policy.h" |
[email protected] | 4f86bdb | 2012-11-10 19:11:19 | [diff] [blame] | 25 | #include "ipc/ipc_listener.h" |
| 26 | #include "ipc/ipc_sender.h" |
mikhail.pozdnyakov | c0e251b | 2015-04-15 06:51:12 | [diff] [blame] | 27 | #include "third_party/WebKit/public/platform/WebDisplayMode.h" |
[email protected] | 5c30b5e0 | 2013-05-30 03:46:08 | [diff] [blame] | 28 | #include "third_party/WebKit/public/platform/WebRect.h" |
[email protected] | 2255a933 | 2013-06-17 05:12:31 | [diff] [blame] | 29 | #include "third_party/WebKit/public/web/WebCompositionUnderline.h" |
[email protected] | c27dd4f | 2014-05-22 18:05:19 | [diff] [blame] | 30 | #include "third_party/WebKit/public/web/WebInputEvent.h" |
[email protected] | 2255a933 | 2013-06-17 05:12:31 | [diff] [blame] | 31 | #include "third_party/WebKit/public/web/WebPopupType.h" |
| 32 | #include "third_party/WebKit/public/web/WebTextDirection.h" |
| 33 | #include "third_party/WebKit/public/web/WebTextInputInfo.h" |
[email protected] | 5d0bbdfa9 | 2013-12-10 00:35:51 | [diff] [blame] | 34 | #include "third_party/WebKit/public/web/WebTouchAction.h" |
[email protected] | 0e45bd0 | 2013-07-12 20:20:02 | [diff] [blame] | 35 | #include "third_party/WebKit/public/web/WebWidget.h" |
[email protected] | 2255a933 | 2013-06-17 05:12:31 | [diff] [blame] | 36 | #include "third_party/WebKit/public/web/WebWidgetClient.h" |
[email protected] | d65adb1 | 2010-04-28 17:26:49 | [diff] [blame] | 37 | #include "third_party/skia/include/core/SkBitmap.h" |
[email protected] | b256eca | 2013-07-11 10:57:40 | [diff] [blame] | 38 | #include "ui/base/ime/text_input_mode.h" |
[email protected] | ad26ef4 | 2011-06-17 07:59:45 | [diff] [blame] | 39 | #include "ui/base/ime/text_input_type.h" |
[email protected] | a09d53ce | 2014-01-31 00:46:42 | [diff] [blame] | 40 | #include "ui/base/ui_base_types.h" |
tfarina | 93bfa91 | 2014-12-05 14:23:15 | [diff] [blame] | 41 | #include "ui/gfx/geometry/rect.h" |
| 42 | #include "ui/gfx/geometry/vector2d.h" |
| 43 | #include "ui/gfx/geometry/vector2d_f.h" |
[email protected] | 08397d5 | 2011-02-05 01:53:38 | [diff] [blame] | 44 | #include "ui/gfx/native_widget_types.h" |
[email protected] | db4fc1e | 2013-09-06 20:01:51 | [diff] [blame] | 45 | #include "ui/gfx/range/range.h" |
[email protected] | d353541f | 2012-05-03 22:45:41 | [diff] [blame] | 46 | #include "ui/surface/transport_dib.h" |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 47 | |
[email protected] | aa4117f | 2011-12-09 22:19:21 | [diff] [blame] | 48 | struct ViewHostMsg_UpdateRect_Params; |
[email protected] | 0fdd501 | 2013-05-29 08:05:56 | [diff] [blame] | 49 | struct ViewMsg_Resize_Params; |
[email protected] | aa4117f | 2011-12-09 22:19:21 | [diff] [blame] | 50 | class ViewHostMsg_UpdateRect; |
| 51 | |
[email protected] | 48495594 | 2010-08-19 16:13:18 | [diff] [blame] | 52 | namespace IPC { |
| 53 | class SyncMessage; |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 54 | class SyncMessageFilter; |
[email protected] | 48495594 | 2010-08-19 16:13:18 | [diff] [blame] | 55 | } |
| 56 | |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 57 | namespace blink { |
[email protected] | 1919368 | 2014-04-03 15:01:43 | [diff] [blame] | 58 | struct WebDeviceEmulationParams; |
kenrb | a719983 | 2015-01-22 23:44:59 | [diff] [blame] | 59 | class WebFrameWidget; |
[email protected] | 41d8685 | 2012-11-07 12:23:24 | [diff] [blame] | 60 | class WebGestureEvent; |
[email protected] | f56c787 | 2013-06-18 12:31:57 | [diff] [blame] | 61 | class WebKeyboardEvent; |
kenrb | a719983 | 2015-01-22 23:44:59 | [diff] [blame] | 62 | class WebLocalFrame; |
[email protected] | 6a8ddba5 | 2010-09-05 04:38:06 | [diff] [blame] | 63 | class WebMouseEvent; |
donnd | a070f3c | 2015-01-16 19:54:11 | [diff] [blame] | 64 | class WebNode; |
| 65 | struct WebPoint; |
[email protected] | 2d0f2e9 | 2011-10-03 09:02:24 | [diff] [blame] | 66 | class WebTouchEvent; |
kenrb | a719983 | 2015-01-22 23:44:59 | [diff] [blame] | 67 | class WebView; |
[email protected] | 52647690 | 2011-10-06 20:34:06 | [diff] [blame] | 68 | } |
| 69 | |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 70 | namespace cc { |
ccameron | d4ba4790 | 2014-12-17 07:20:31 | [diff] [blame] | 71 | struct InputHandlerScrollResult; |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 72 | class OutputSurface; |
| 73 | class SwapPromise; |
| 74 | } |
[email protected] | ba91a79 | 2013-02-06 09:48:28 | [diff] [blame] | 75 | |
[email protected] | db4fc1e | 2013-09-06 20:01:51 | [diff] [blame] | 76 | namespace gfx { |
[email protected] | 4de6d169 | 2011-10-12 08:45:44 | [diff] [blame] | 77 | class Range; |
| 78 | } |
| 79 | |
alexclarke | 7fa9394 | 2015-10-21 15:37:11 | [diff] [blame] | 80 | namespace scheduler { |
| 81 | class RenderWidgetSchedulingState; |
| 82 | } |
| 83 | |
[email protected] | e9ff79c | 2012-10-19 21:31:26 | [diff] [blame] | 84 | namespace content { |
danakj | 6e3bf801 | 2014-12-16 18:27:53 | [diff] [blame] | 85 | class CompositorDependencies; |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 86 | class ExternalPopupMenu; |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 87 | class FrameSwapMessageQueue; |
changwan | f2a707b | 2015-10-30 08:22:16 | [diff] [blame] | 88 | class ImeEventGuard; |
[email protected] | adab233 | 2013-07-25 18:04:32 | [diff] [blame] | 89 | class PepperPluginInstanceImpl; |
[email protected] | bffc830 | 2014-01-23 20:52:16 | [diff] [blame] | 90 | class RenderFrameImpl; |
[email protected] | e3244ed | 2014-06-20 20:04:27 | [diff] [blame] | 91 | class RenderFrameProxy; |
[email protected] | ba91a79 | 2013-02-06 09:48:28 | [diff] [blame] | 92 | class RenderWidgetCompositor; |
[email protected] | e9ff79c | 2012-10-19 21:31:26 | [diff] [blame] | 93 | class RenderWidgetTest; |
[email protected] | 5b45ad4 | 2013-10-25 00:42:04 | [diff] [blame] | 94 | class ResizingModeSelector; |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 95 | struct ContextMenuParams; |
jdduke | c05612b | 2015-06-25 23:13:18 | [diff] [blame] | 96 | struct DidOverscrollParams; |
[email protected] | 29e2fb4 | 2013-07-19 01:13:47 | [diff] [blame] | 97 | struct WebPluginGeometry; |
[email protected] | e9ff79c | 2012-10-19 21:31:26 | [diff] [blame] | 98 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 99 | // RenderWidget provides a communication bridge between a WebWidget and |
| 100 | // a RenderWidgetHost, the latter of which lives in a different process. |
dcheng | d96a27a | 2015-07-24 20:17:32 | [diff] [blame] | 101 | // |
| 102 | // RenderWidget is used to implement: |
| 103 | // - RenderViewImpl (deprecated) |
| 104 | // - Fullscreen mode (RenderWidgetFullScreen) |
| 105 | // - Popup "menus" (like the color chooser and date picker) |
| 106 | // - Widgets for frames (for out-of-process iframe support) |
[email protected] | f3112a5 | 2011-09-30 23:47:49 | [diff] [blame] | 107 | class CONTENT_EXPORT RenderWidget |
[email protected] | c47317e | 2012-06-20 22:35:31 | [diff] [blame] | 108 | : public IPC::Listener, |
| 109 | public IPC::Sender, |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 110 | NON_EXPORTED_BASE(virtual public blink::WebWidgetClient), |
fsamuel | 72464894f | 2015-12-15 06:59:31 | [diff] [blame] | 111 | public RenderWidgetInputHandlerDelegate, |
[email protected] | f3112a5 | 2011-09-30 23:47:49 | [diff] [blame] | 112 | public base::RefCounted<RenderWidget> { |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 113 | public: |
| 114 | // Creates a new RenderWidget. The opener_id is the routing ID of the |
[email protected] | 38024409 | 2011-10-07 17:26:27 | [diff] [blame] | 115 | // RenderView that this widget lives inside. |
[email protected] | 0ebf387 | 2008-11-07 21:35:03 | [diff] [blame] | 116 | static RenderWidget* Create(int32 opener_id, |
danakj | 6e3bf801 | 2014-12-16 18:27:53 | [diff] [blame] | 117 | CompositorDependencies* compositor_deps, |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 118 | blink::WebPopupType popup_type, |
| 119 | const blink::WebScreenInfo& screen_info); |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 120 | |
kenrb | a719983 | 2015-01-22 23:44:59 | [diff] [blame] | 121 | // Creates a new RenderWidget that will be attached to a RenderFrame. |
| 122 | static RenderWidget* CreateForFrame(int routing_id, |
kenrb | a719983 | 2015-01-22 23:44:59 | [diff] [blame] | 123 | bool hidden, |
| 124 | const blink::WebScreenInfo& screen_info, |
| 125 | CompositorDependencies* compositor_deps, |
| 126 | blink::WebLocalFrame* frame); |
| 127 | |
dcheng | da9b4bb | 2015-07-20 20:58:08 | [diff] [blame] | 128 | // Closes a RenderWidget that was created by |CreateForFrame|. |
dcheng | 3ce04b6 | 2015-10-26 23:30:55 | [diff] [blame] | 129 | // TODO(avi): De-virtualize this once RenderViewImpl has-a RenderWidget. |
| 130 | // https://crbug.com/545684 |
| 131 | virtual void CloseForFrame(); |
[email protected] | 48495594 | 2010-08-19 16:13:18 | [diff] [blame] | 132 | |
[email protected] | 4ee6462 | 2014-03-21 22:34:15 | [diff] [blame] | 133 | int32 routing_id() const { return routing_id_; } |
danakj | 6e3bf801 | 2014-12-16 18:27:53 | [diff] [blame] | 134 | CompositorDependencies* compositor_deps() const { return compositor_deps_; } |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 135 | blink::WebWidget* webwidget() const { return webwidget_; } |
[email protected] | 93b9d69 | 2011-04-13 00:44:31 | [diff] [blame] | 136 | gfx::Size size() const { return size_; } |
mikhail.pozdnyakov | f2c902a | 2015-04-14 08:09:12 | [diff] [blame] | 137 | bool is_fullscreen_granted() const { return is_fullscreen_granted_; } |
mikhail.pozdnyakov | c0e251b | 2015-04-15 06:51:12 | [diff] [blame] | 138 | blink::WebDisplayMode display_mode() const { return display_mode_; } |
[email protected] | 204f1df | 2012-01-04 20:21:13 | [diff] [blame] | 139 | bool is_hidden() const { return is_hidden_; } |
[email protected] | 4ee6462 | 2014-03-21 22:34:15 | [diff] [blame] | 140 | // Temporary for debugging purposes... |
| 141 | bool closing() const { return closing_; } |
| 142 | bool is_swapped_out() { return is_swapped_out_; } |
simonhong | 628f981 | 2015-04-27 23:13:20 | [diff] [blame] | 143 | bool for_oopif() { return for_oopif_; } |
[email protected] | be1af066 | 2014-07-29 19:55:51 | [diff] [blame] | 144 | bool has_host_context_menu_location() { |
| 145 | return has_host_context_menu_location_; |
| 146 | } |
| 147 | gfx::Point host_context_menu_location() { |
| 148 | return host_context_menu_location_; |
[email protected] | 4ee6462 | 2014-03-21 22:34:15 | [diff] [blame] | 149 | } |
[email protected] | 589621b | 2010-09-23 22:01:07 | [diff] [blame] | 150 | |
kenrb | a719983 | 2015-01-22 23:44:59 | [diff] [blame] | 151 | // ScreenInfo exposed so it can be passed to subframe RenderWidgets. |
| 152 | blink::WebScreenInfo screen_info() const { return screen_info_; } |
| 153 | |
[email protected] | bffc830 | 2014-01-23 20:52:16 | [diff] [blame] | 154 | // Functions to track out-of-process frames for special notifications. |
[email protected] | e3244ed | 2014-06-20 20:04:27 | [diff] [blame] | 155 | void RegisterRenderFrameProxy(RenderFrameProxy* proxy); |
| 156 | void UnregisterRenderFrameProxy(RenderFrameProxy* proxy); |
[email protected] | bffc830 | 2014-01-23 20:52:16 | [diff] [blame] | 157 | |
[email protected] | de3c5d8 | 2014-05-28 22:12:59 | [diff] [blame] | 158 | // Functions to track all RenderFrame objects associated with this |
| 159 | // RenderWidget. |
| 160 | void RegisterRenderFrame(RenderFrameImpl* frame); |
| 161 | void UnregisterRenderFrame(RenderFrameImpl* frame); |
| 162 | |
[email protected] | a017938b | 2014-05-27 21:17:17 | [diff] [blame] | 163 | #if defined(VIDEO_HOLE) |
| 164 | void RegisterVideoHoleFrame(RenderFrameImpl* frame); |
| 165 | void UnregisterVideoHoleFrame(RenderFrameImpl* frame); |
| 166 | #endif // defined(VIDEO_HOLE) |
| 167 | |
[email protected] | c47317e | 2012-06-20 22:35:31 | [diff] [blame] | 168 | // IPC::Listener |
dcheng | 6d18e40 | 2014-10-21 12:32:52 | [diff] [blame] | 169 | bool OnMessageReceived(const IPC::Message& msg) override; |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 170 | |
[email protected] | c47317e | 2012-06-20 22:35:31 | [diff] [blame] | 171 | // IPC::Sender |
dcheng | 6d18e40 | 2014-10-21 12:32:52 | [diff] [blame] | 172 | bool Send(IPC::Message* msg) override; |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 173 | |
fsamuel | 72464894f | 2015-12-15 06:59:31 | [diff] [blame] | 174 | // RenderWidgetInputHandlerDelegate |
| 175 | void FocusChangeComplete() override; |
| 176 | bool HasTouchEventHandlersAt(const gfx::Point& point) const override; |
| 177 | void ObserveWheelEventAndResult(const blink::WebMouseWheelEvent& wheel_event, |
| 178 | const gfx::Vector2dF& wheel_unused_delta, |
| 179 | bool event_processed) override; |
| 180 | void OnDidHandleKeyEvent() override; |
| 181 | void OnDidOverscroll(const DidOverscrollParams& params) override; |
| 182 | void OnInputEventAck(scoped_ptr<InputEventAck> input_event_ack) override; |
| 183 | void UpdateTextInputState(ShowIme show_ime, |
| 184 | ChangeSource change_source) override; |
| 185 | bool WillHandleGestureEvent(const blink::WebGestureEvent& event) override; |
| 186 | bool WillHandleMouseEvent(const blink::WebMouseEvent& event) override; |
| 187 | |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 188 | // blink::WebWidgetClient |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 189 | void didAutoResize(const blink::WebSize& new_size) override; |
| 190 | void initializeLayerTreeView() override; |
| 191 | blink::WebLayerTreeView* layerTreeView() override; |
dglazkov | f0e1d6d | 2015-10-10 02:13:48 | [diff] [blame] | 192 | void didMeaningfulLayout(blink::WebMeaningfulLayout layout_type) override; |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 193 | void didFocus() override; |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 194 | void didChangeCursor(const blink::WebCursorInfo&) override; |
| 195 | void closeWidgetSoon() override; |
| 196 | void show(blink::WebNavigationPolicy) override; |
| 197 | blink::WebRect windowRect() override; |
| 198 | void setToolTipText(const blink::WebString& text, |
| 199 | blink::WebTextDirection hint) override; |
| 200 | void setWindowRect(const blink::WebRect&) override; |
| 201 | blink::WebRect windowResizerRect() override; |
| 202 | blink::WebRect rootWindowRect() override; |
| 203 | blink::WebScreenInfo screenInfo() override; |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 204 | void resetInputMethod() override; |
| 205 | void didHandleGestureEvent(const blink::WebGestureEvent& event, |
| 206 | bool event_cancelled) override; |
| 207 | void didOverscroll(const blink::WebFloatSize& unusedDelta, |
| 208 | const blink::WebFloatSize& accumulatedRootOverScroll, |
| 209 | const blink::WebFloatPoint& position, |
| 210 | const blink::WebFloatSize& velocity) override; |
| 211 | void showImeIfNeeded() override; |
[email protected] | 4873c7d | 2009-07-16 06:36:28 | [diff] [blame] | 212 | |
fsamuel | 72464894f | 2015-12-15 06:59:31 | [diff] [blame] | 213 | // Override point to obtain that the current input method state and caret |
| 214 | // position. |
| 215 | virtual ui::TextInputType GetTextInputType(); |
| 216 | virtual ui::TextInputType WebKitToUiTextInputType( |
| 217 | blink::WebTextInputType type); |
| 218 | |
oshima | f866dab | 2015-12-05 00:41:54 | [diff] [blame] | 219 | // Converts the |rect| from Viewport coordinates to Window coordinates. |
| 220 | // See RenderView::convertViewportToWindow for more details. |
| 221 | void convertViewportToWindow(blink::WebRect* rect); |
| 222 | |
donnd | a070f3c | 2015-01-16 19:54:11 | [diff] [blame] | 223 | #if defined(OS_ANDROID) |
| 224 | // Notifies that a tap was not consumed, so showing a UI for the unhandled |
| 225 | // tap may be needed. |
donnd | 57e54f5 | 2015-02-26 19:03:37 | [diff] [blame] | 226 | // Performs various checks on the given WebNode to apply heuristics to |
| 227 | // determine if triggering is appropriate. |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 228 | void showUnhandledTapUIIfNeeded(const blink::WebPoint& tapped_position, |
| 229 | const blink::WebNode& tapped_node, |
| 230 | bool page_changed) override; |
donnd | a070f3c | 2015-01-16 19:54:11 | [diff] [blame] | 231 | #endif |
| 232 | |
[email protected] | 7912e82 | 2014-04-16 02:37:03 | [diff] [blame] | 233 | // Begins the compositor's scheduler to start producing frames. |
| 234 | void StartCompositor(); |
| 235 | |
[email protected] | aeeedad | 2014-08-22 18:16:22 | [diff] [blame] | 236 | // Stop compositing. |
enne | f3c5814 | 2014-12-09 21:44:38 | [diff] [blame] | 237 | void WillCloseLayerTreeView(); |
[email protected] | aeeedad | 2014-08-22 18:16:22 | [diff] [blame] | 238 | |
[email protected] | 4873c7d | 2009-07-16 06:36:28 | [diff] [blame] | 239 | // Called when a plugin is moved. These events are queued up and sent with |
| 240 | // the next paint or scroll message to the host. |
[email protected] | 29e2fb4 | 2013-07-19 01:13:47 | [diff] [blame] | 241 | void SchedulePluginMove(const WebPluginGeometry& move); |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 242 | |
[email protected] | 26865477 | 2009-08-06 23:02:04 | [diff] [blame] | 243 | // Called when a plugin window has been destroyed, to make sure the currently |
| 244 | // pending moves don't try to reference it. |
| 245 | void CleanupWindowInPluginMoves(gfx::PluginWindowHandle window); |
| 246 | |
[email protected] | 24ed043 | 2013-04-24 07:50:31 | [diff] [blame] | 247 | RenderWidgetCompositor* compositor() const; |
| 248 | |
fsamuel | 72464894f | 2015-12-15 06:59:31 | [diff] [blame] | 249 | const RenderWidgetInputHandler& input_handler() const { |
| 250 | return input_handler_; |
| 251 | } |
| 252 | |
| 253 | void SetHandlingInputEventForTesting(bool handling_input_event); |
| 254 | |
| 255 | // When paused in debugger, we send ack for mouse event early. This ensures |
| 256 | // that we continue receiving mouse moves and pass them to debugger. Returns |
| 257 | // whether we are paused in mouse move event and have sent the ack. |
| 258 | bool SendAckForMouseMoveFromDebugger(); |
| 259 | |
| 260 | // When resumed from pause in debugger while handling mouse move, |
| 261 | // we should not send an extra ack (see SendAckForMouseMoveFromDebugger). |
| 262 | void IgnoreAckForMouseMoveFromDebugger(); |
| 263 | |
[email protected] | ebc0e1df | 2013-08-01 02:46:22 | [diff] [blame] | 264 | virtual scoped_ptr<cc::OutputSurface> CreateOutputSurface(bool fallback); |
[email protected] | ba91a79 | 2013-02-06 09:48:28 | [diff] [blame] | 265 | |
[email protected] | 79fa22e | 2013-08-23 15:18:12 | [diff] [blame] | 266 | // Callback for use with synthetic gestures (e.g. BeginSmoothScroll). |
| 267 | typedef base::Callback<void()> SyntheticGestureCompletionCallback; |
[email protected] | 0e241b4b | 2012-08-18 09:06:27 | [diff] [blame] | 268 | |
[email protected] | 9017d785 | 2013-11-21 17:47:35 | [diff] [blame] | 269 | // Send a synthetic gesture to the browser to be queued to the synthetic |
| 270 | // gesture controller. |
| 271 | void QueueSyntheticGesture( |
| 272 | scoped_ptr<SyntheticGestureParams> gesture_params, |
| 273 | const SyntheticGestureCompletionCallback& callback); |
[email protected] | 1e1dd18 | 2013-09-12 01:51:15 | [diff] [blame] | 274 | |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 275 | // Deliveres |message| together with compositor state change updates. The |
| 276 | // exact behavior depends on |policy|. |
| 277 | // This mechanism is not a drop-in replacement for IPC: messages sent this way |
| 278 | // will not be automatically available to BrowserMessageFilter, for example. |
| 279 | // FIFO ordering is preserved between messages enqueued with the same |
| 280 | // |policy|, the ordering between messages enqueued for different policies is |
| 281 | // undefined. |
| 282 | // |
| 283 | // |msg| message to send, ownership of |msg| is transferred. |
| 284 | // |policy| see the comment on MessageDeliveryPolicy. |
| 285 | void QueueMessage(IPC::Message* msg, MessageDeliveryPolicy policy); |
| 286 | |
changwan | f2a707b | 2015-10-30 08:22:16 | [diff] [blame] | 287 | // Handle start and finish of IME event guard. |
| 288 | void OnImeEventGuardStart(ImeEventGuard* guard); |
| 289 | void OnImeEventGuardFinish(ImeEventGuard* guard); |
[email protected] | 66fca5bc | 2013-05-23 06:58:29 | [diff] [blame] | 290 | |
[email protected] | 4ee6462 | 2014-03-21 22:34:15 | [diff] [blame] | 291 | // Returns whether we currently should handle an IME event. |
| 292 | bool ShouldHandleImeEvent(); |
| 293 | |
rouslan | f7ebd883 | 2015-01-22 01:54:14 | [diff] [blame] | 294 | // Called by the compositor when page scale animation completed. |
| 295 | virtual void DidCompletePageScaleAnimation() {} |
| 296 | |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 297 | // ScreenMetricsEmulator class manages screen emulation inside a render |
| 298 | // widget. This includes resizing, placing view on the screen at desired |
| 299 | // position, changing device scale factor, and scaling down the whole |
| 300 | // widget if required to fit into the browser window. |
| 301 | class ScreenMetricsEmulator; |
| 302 | |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 303 | void SetPopupOriginAdjustmentsForEmulation(ScreenMetricsEmulator* emulator); |
[email protected] | 2d6836f4 | 2014-07-02 17:25:31 | [diff] [blame] | 304 | gfx::Rect AdjustValidationMessageAnchor(const gfx::Rect& anchor); |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 305 | |
jdduke | 491a3f0c | 2015-06-15 23:30:26 | [diff] [blame] | 306 | // Indicates that the compositor is about to begin a frame. This is primarily |
| 307 | // to signal to flow control mechanisms that a frame is beginning, not to |
| 308 | // perform actual painting work. |
| 309 | void WillBeginCompositorFrame(); |
| 310 | |
| 311 | // Notifies about a compositor frame commit operation having finished. |
| 312 | virtual void DidCommitCompositorFrame(); |
| 313 | |
| 314 | // Notifies that the draw commands for a committed frame have been issued. |
| 315 | void DidCommitAndDrawCompositorFrame(); |
| 316 | |
| 317 | // Notifies that the compositor has posted a swapbuffers operation to the GPU |
| 318 | // process. |
| 319 | void DidCompleteSwapBuffers(); |
| 320 | |
| 321 | void ScheduleComposite(); |
[email protected] | 7d08a935 | 2013-10-15 08:24:56 | [diff] [blame] | 322 | void ScheduleCompositeWithForcedRedraw(); |
| 323 | |
[email protected] | 4d7e46a | 2013-11-08 05:33:40 | [diff] [blame] | 324 | // Called by the compositor in single-threaded mode when a swap is posted, |
| 325 | // completes or is aborted. |
| 326 | void OnSwapBuffersPosted(); |
| 327 | void OnSwapBuffersComplete(); |
| 328 | void OnSwapBuffersAborted(); |
| 329 | |
[email protected] | 7a4e253 | 2013-12-02 21:30:02 | [diff] [blame] | 330 | // Checks if the selection bounds have been changed. If they are changed, |
| 331 | // the new value will be sent to the browser process. |
| 332 | void UpdateSelectionBounds(); |
| 333 | |
dtrainor | 5ef644e | 2015-11-19 00:12:47 | [diff] [blame] | 334 | // Called by the compositor to forward a proto that represents serialized |
| 335 | // compositor state. |
| 336 | void ForwardCompositorProto(const std::vector<uint8_t>& proto); |
| 337 | |
[email protected] | e5e438d6 | 2014-03-27 21:47:16 | [diff] [blame] | 338 | virtual void GetSelectionBounds(gfx::Rect* start, gfx::Rect* end); |
| 339 | |
[email protected] | a09d53ce | 2014-01-31 00:46:42 | [diff] [blame] | 340 | void OnShowHostContextMenu(ContextMenuParams* params); |
[email protected] | 7a4e253 | 2013-12-02 21:30:02 | [diff] [blame] | 341 | |
[email protected] | 7a4e253 | 2013-12-02 21:30:02 | [diff] [blame] | 342 | // Checks if the composition range or composition character bounds have been |
| 343 | // changed. If they are changed, the new value will be sent to the browser |
yukawa | 5f21c6a | 2014-10-27 17:09:30 | [diff] [blame] | 344 | // process. This method does nothing when the browser process is not able to |
| 345 | // handle composition range and composition character bounds. |
[email protected] | 7a4e253 | 2013-12-02 21:30:02 | [diff] [blame] | 346 | void UpdateCompositionInfo(bool should_update_range); |
[email protected] | 7a4e253 | 2013-12-02 21:30:02 | [diff] [blame] | 347 | |
enne | f3c5814 | 2014-12-09 21:44:38 | [diff] [blame] | 348 | bool host_closing() const { return host_closing_; } |
| 349 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 350 | protected: |
[email protected] | 8085dbc8 | 2008-09-26 22:53:44 | [diff] [blame] | 351 | // Friend RefCounted so that the dtor can be non-public. Using this class |
| 352 | // without ref-counting is an error. |
| 353 | friend class base::RefCounted<RenderWidget>; |
[email protected] | 7339cd2 | 2010-10-27 00:11:20 | [diff] [blame] | 354 | // For unit tests. |
[email protected] | e9ff79c | 2012-10-19 21:31:26 | [diff] [blame] | 355 | friend class RenderWidgetTest; |
[email protected] | 8085dbc8 | 2008-09-26 22:53:44 | [diff] [blame] | 356 | |
[email protected] | 61e2b3cc | 2012-03-02 16:13:34 | [diff] [blame] | 357 | enum ResizeAck { |
| 358 | SEND_RESIZE_ACK, |
| 359 | NO_RESIZE_ACK, |
| 360 | }; |
| 361 | |
dcheng | 35d31c11 | 2015-07-22 00:17:36 | [diff] [blame] | 362 | RenderWidget(CompositorDependencies* compositor_deps, |
| 363 | blink::WebPopupType popup_type, |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 364 | const blink::WebScreenInfo& screen_info, |
[email protected] | 1ac10dca | 2013-08-20 20:47:04 | [diff] [blame] | 365 | bool swapped_out, |
[email protected] | 7912e82 | 2014-04-16 02:37:03 | [diff] [blame] | 366 | bool hidden, |
| 367 | bool never_visible); |
[email protected] | ce2b28e | 2012-08-09 15:53:57 | [diff] [blame] | 368 | |
dcheng | 6d18e40 | 2014-10-21 12:32:52 | [diff] [blame] | 369 | ~RenderWidget() override; |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 370 | |
dcheng | da9b4bb | 2015-07-20 20:58:08 | [diff] [blame] | 371 | static blink::WebWidget* CreateWebFrameWidget(RenderWidget* render_widget, |
| 372 | blink::WebLocalFrame* frame); |
| 373 | |
| 374 | // Creates a WebWidget based on the popup type. |
| 375 | static blink::WebWidget* CreateWebWidget(RenderWidget* render_widget); |
| 376 | |
piman | c4af307 | 2015-10-02 03:45:59 | [diff] [blame] | 377 | // Initializes this view with the given opener. |
dcheng | 35d31c11 | 2015-07-22 00:17:36 | [diff] [blame] | 378 | bool Init(int32 opener_id); |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 379 | |
[email protected] | 48495594 | 2010-08-19 16:13:18 | [diff] [blame] | 380 | // Called by Init and subclasses to perform initialization. |
[email protected] | a635f94 | 2012-12-07 10:34:29 | [diff] [blame] | 381 | bool DoInit(int32 opener_id, |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 382 | blink::WebWidget* web_widget, |
[email protected] | 48495594 | 2010-08-19 16:13:18 | [diff] [blame] | 383 | IPC::SyncMessage* create_widget_message); |
| 384 | |
[email protected] | 992db4c | 2011-05-12 15:37:15 | [diff] [blame] | 385 | // Sets whether this RenderWidget has been swapped out to be displayed by |
| 386 | // a RenderWidget in a different process. If so, no new IPC messages will be |
| 387 | // sent (only ACKs) and the process is free to exit when there are no other |
| 388 | // active RenderWidgets. |
| 389 | void SetSwappedOut(bool is_swapped_out); |
| 390 | |
[email protected] | 949b659 | 2014-08-20 13:17:52 | [diff] [blame] | 391 | // Allows the process to exit once the unload handler has finished, if there |
| 392 | // are no other active RenderWidgets. |
| 393 | void WasSwappedOut(); |
| 394 | |
[email protected] | 2533ce1 | 2009-05-09 00:02:24 | [diff] [blame] | 395 | void DoDeferredClose(); |
dgozman | cf9039cd | 2015-04-06 12:01:31 | [diff] [blame] | 396 | void NotifyOnClose(); |
dcheng | da9b4bb | 2015-07-20 20:58:08 | [diff] [blame] | 397 | |
| 398 | // Close the underlying WebWidget. |
| 399 | virtual void Close(); |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 400 | |
[email protected] | 61e2b3cc | 2012-03-02 16:13:34 | [diff] [blame] | 401 | // Resizes the render widget. |
| 402 | void Resize(const gfx::Size& new_size, |
[email protected] | 60d47ac | 2013-03-01 23:42:44 | [diff] [blame] | 403 | const gfx::Size& physical_backing_size, |
dtrainor | cb7779b8 | 2014-12-04 01:08:02 | [diff] [blame] | 404 | bool top_controls_shrink_blink_size, |
| 405 | float top_controls_height, |
[email protected] | bb6378fe | 2014-04-28 21:19:44 | [diff] [blame] | 406 | const gfx::Size& visible_viewport_size, |
[email protected] | 61e2b3cc | 2012-03-02 16:13:34 | [diff] [blame] | 407 | const gfx::Rect& resizer_rect, |
mikhail.pozdnyakov | f2c902a | 2015-04-14 08:09:12 | [diff] [blame] | 408 | bool is_fullscreen_granted, |
mikhail.pozdnyakov | c0e251b | 2015-04-15 06:51:12 | [diff] [blame] | 409 | blink::WebDisplayMode display_mode, |
[email protected] | 61e2b3cc | 2012-03-02 16:13:34 | [diff] [blame] | 410 | ResizeAck resize_ack); |
[email protected] | 9265016 | 2013-10-30 03:31:02 | [diff] [blame] | 411 | // Used to force the size of a window when running layout tests. |
bokan | c007c3a | 2015-02-03 07:15:56 | [diff] [blame] | 412 | void SetWindowRectSynchronously(const gfx::Rect& new_window_rect); |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 413 | virtual void SetScreenMetricsEmulationParameters( |
dgozman | 9260b0a1 | 2015-03-16 13:45:20 | [diff] [blame] | 414 | bool enabled, |
| 415 | const blink::WebDeviceEmulationParams& params); |
[email protected] | 5390786 | 2014-03-25 15:42:40 | [diff] [blame] | 416 | #if defined(OS_MACOSX) || defined(OS_ANDROID) |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 417 | void SetExternalPopupOriginAdjustmentsForEmulation( |
| 418 | ExternalPopupMenu* popup, ScreenMetricsEmulator* emulator); |
[email protected] | 5390786 | 2014-03-25 15:42:40 | [diff] [blame] | 419 | #endif |
[email protected] | 61e2b3cc | 2012-03-02 16:13:34 | [diff] [blame] | 420 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 421 | // RenderWidget IPC message handlers |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 422 | void OnHandleInputEvent(const blink::WebInputEvent* event, |
jdduke | 0cf1e66 | 2015-10-15 22:43:28 | [diff] [blame] | 423 | const ui::LatencyInfo& latency_info); |
[email protected] | 34202de | 2013-05-06 23:36:22 | [diff] [blame] | 424 | void OnCursorVisibilityChange(bool is_visible); |
[email protected] | c084330e0 | 2013-04-27 01:08:15 | [diff] [blame] | 425 | void OnMouseCaptureLost(); |
| 426 | virtual void OnSetFocus(bool enable); |
nasko | c288745f | 2015-05-01 22:54:21 | [diff] [blame] | 427 | void OnClose(); |
[email protected] | fc4404d | 2012-11-07 19:53:30 | [diff] [blame] | 428 | void OnCreatingNewAck(); |
[email protected] | 0fdd501 | 2013-05-29 08:05:56 | [diff] [blame] | 429 | virtual void OnResize(const ViewMsg_Resize_Params& params); |
dgozman | 9260b0a1 | 2015-03-16 13:45:20 | [diff] [blame] | 430 | void OnEnableDeviceEmulation(const blink::WebDeviceEmulationParams& params); |
| 431 | void OnDisableDeviceEmulation(); |
noel | 89949e6 | 2014-09-30 01:12:41 | [diff] [blame] | 432 | void OnColorProfile(const std::vector<char>& color_profile); |
[email protected] | b5913d7 | 2012-02-07 22:26:54 | [diff] [blame] | 433 | void OnChangeResizeRect(const gfx::Rect& resizer_rect); |
[email protected] | 941e455 | 2010-02-01 21:23:43 | [diff] [blame] | 434 | virtual void OnWasHidden(); |
[email protected] | 3399dd82 | 2014-08-09 11:14:24 | [diff] [blame] | 435 | virtual void OnWasShown(bool needs_repainting, |
| 436 | const ui::LatencyInfo& latency_info); |
[email protected] | 8400e03 | 2010-02-26 18:50:11 | [diff] [blame] | 437 | void OnCreateVideoAck(int32 video_id); |
| 438 | void OnUpdateVideoAck(int32 video_id); |
[email protected] | 2533ce1 | 2009-05-09 00:02:24 | [diff] [blame] | 439 | void OnRequestMoveAck(); |
[email protected] | 56ea1a6 | 2011-05-30 07:05:57 | [diff] [blame] | 440 | virtual void OnImeSetComposition( |
[email protected] | fcf75d4 | 2013-12-03 20:11:26 | [diff] [blame] | 441 | const base::string16& text, |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 442 | const std::vector<blink::WebCompositionUnderline>& underlines, |
[email protected] | fa7b1dc | 2010-06-23 17:53:04 | [diff] [blame] | 443 | int selection_start, |
| 444 | int selection_end); |
[email protected] | fcf75d4 | 2013-12-03 20:11:26 | [diff] [blame] | 445 | virtual void OnImeConfirmComposition(const base::string16& text, |
[email protected] | db4fc1e | 2013-09-06 20:01:51 | [diff] [blame] | 446 | const gfx::Range& replacement_range, |
[email protected] | 0e45bd0 | 2013-07-12 20:20:02 | [diff] [blame] | 447 | bool keep_selection); |
oshima | d527903 | 2015-12-16 18:22:33 | [diff] [blame^] | 448 | // Called when the device scale factor is changed, or the layer tree is |
| 449 | // initialized. |
| 450 | virtual void OnDeviceScaleFactorChanged(); |
| 451 | |
[email protected] | 0bc1f57 | 2013-04-17 01:46:31 | [diff] [blame] | 452 | void OnRepaint(gfx::Size size_to_paint); |
[email protected] | 79fa22e | 2013-08-23 15:18:12 | [diff] [blame] | 453 | void OnSyntheticGestureCompleted(); |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 454 | void OnSetTextDirection(blink::WebTextDirection direction); |
[email protected] | 872ae5b | 2011-05-26 20:20:50 | [diff] [blame] | 455 | void OnGetFPS(); |
[email protected] | 80ad862 | 2012-11-07 16:33:03 | [diff] [blame] | 456 | void OnUpdateScreenRects(const gfx::Rect& view_screen_rect, |
| 457 | const gfx::Rect& window_screen_rect); |
[email protected] | 2384b6c | 2013-02-28 23:58:51 | [diff] [blame] | 458 | void OnShowImeIfNeeded(); |
kenrb | b4e2a3b | 2015-05-14 15:05:05 | [diff] [blame] | 459 | void OnSetSurfaceIdNamespace(uint32_t surface_id_namespace); |
dtrainor | 5ef644e | 2015-11-19 00:12:47 | [diff] [blame] | 460 | void OnHandleCompositorProto(const std::vector<uint8_t>& proto); |
[email protected] | 0d1ebed1 | 2013-08-05 22:01:13 | [diff] [blame] | 461 | |
[email protected] | adb36231 | 2014-06-28 06:04:24 | [diff] [blame] | 462 | #if defined(OS_ANDROID) |
changwan | 3a84116 | 2015-08-11 02:53:37 | [diff] [blame] | 463 | // Called when we send IME event that expects an ACK. |
| 464 | void OnImeEventSentForAck(const blink::WebTextInputInfo& info); |
[email protected] | 0d1ebed1 | 2013-08-05 22:01:13 | [diff] [blame] | 465 | |
| 466 | // Called by the browser process for every required IME acknowledgement. |
| 467 | void OnImeEventAck(); |
[email protected] | 105dffb4 | 2013-02-20 03:46:21 | [diff] [blame] | 468 | #endif |
[email protected] | 0d1ebed1 | 2013-08-05 22:01:13 | [diff] [blame] | 469 | |
[email protected] | 847a258 | 2013-03-09 02:29:51 | [diff] [blame] | 470 | // Notify the compositor about a change in viewport size. This should be |
| 471 | // used only with auto resize mode WebWidgets, as normal WebWidgets should |
| 472 | // go through OnResize. |
[email protected] | 97e1bf7 | 2013-03-06 14:06:05 | [diff] [blame] | 473 | void AutoResizeCompositor(); |
| 474 | |
[email protected] | 468ac58 | 2012-11-20 00:53:19 | [diff] [blame] | 475 | virtual void SetDeviceScaleFactor(float device_scale_factor); |
[email protected] | 28ed6b3 | 2014-06-08 02:16:27 | [diff] [blame] | 476 | virtual bool SetDeviceColorProfile(const std::vector<char>& color_profile); |
noel | db4df15 | 2014-09-16 17:45:20 | [diff] [blame] | 477 | virtual void ResetDeviceColorProfileForTesting(); |
[email protected] | 468ac58 | 2012-11-20 00:53:19 | [diff] [blame] | 478 | |
[email protected] | fcdc564 | 2014-05-09 14:32:24 | [diff] [blame] | 479 | virtual void OnOrientationChange(); |
| 480 | |
[email protected] | 29ed96a | 2012-02-04 18:12:16 | [diff] [blame] | 481 | // Override points to notify derived classes that a paint has happened. |
[email protected] | 0704ac3 | 2013-10-03 15:24:22 | [diff] [blame] | 482 | // DidInitiatePaint happens when that has completed, and subsequent rendering |
| 483 | // won't affect the painted content. DidFlushPaint happens once we've received |
| 484 | // the ACK that the screen has been updated. For a given paint operation, |
| 485 | // these overrides will always be called in the order DidInitiatePaint, |
| 486 | // DidFlushPaint. |
[email protected] | 00c3961 | 2010-03-06 02:53:28 | [diff] [blame] | 487 | virtual void DidInitiatePaint() {} |
| 488 | virtual void DidFlushPaint() {} |
[email protected] | a2f6bc11 | 2009-06-27 16:27:25 | [diff] [blame] | 489 | |
[email protected] | ed7defa | 2013-03-12 21:29:59 | [diff] [blame] | 490 | virtual GURL GetURLForGraphicsContext3D(); |
[email protected] | 6522577 | 2011-05-12 21:10:24 | [diff] [blame] | 491 | |
[email protected] | d54169e9 | 2011-01-21 09:19:52 | [diff] [blame] | 492 | // Gets the scroll offset of this widget, if this widget has a notion of |
| 493 | // scroll offset. |
[email protected] | ceb36f7d | 2012-10-31 18:33:24 | [diff] [blame] | 494 | virtual gfx::Vector2d GetScrollOffset(); |
[email protected] | d54169e9 | 2011-01-21 09:19:52 | [diff] [blame] | 495 | |
[email protected] | bee16aab | 2009-08-26 15:55:03 | [diff] [blame] | 496 | // Sets the "hidden" state of this widget. All accesses to is_hidden_ should |
| 497 | // use this method so that we can properly inform the RenderThread of our |
| 498 | // state. |
| 499 | void SetHidden(bool hidden); |
| 500 | |
[email protected] | 2b624c56 | 2011-10-27 22:58:26 | [diff] [blame] | 501 | void DidToggleFullscreen(); |
| 502 | |
[email protected] | 67474193 | 2009-02-04 23:44:46 | [diff] [blame] | 503 | bool next_paint_is_resize_ack() const; |
[email protected] | 67474193 | 2009-02-04 23:44:46 | [diff] [blame] | 504 | void set_next_paint_is_resize_ack(); |
[email protected] | 67474193 | 2009-02-04 23:44:46 | [diff] [blame] | 505 | void set_next_paint_is_repaint_ack(); |
[email protected] | ec7dc11 | 2008-08-06 05:30:12 | [diff] [blame] | 506 | |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 507 | // QueueMessage implementation extracted into a static method for easy |
| 508 | // testing. |
| 509 | static scoped_ptr<cc::SwapPromise> QueueMessageImpl( |
| 510 | IPC::Message* msg, |
| 511 | MessageDeliveryPolicy policy, |
| 512 | FrameSwapMessageQueue* frame_swap_message_queue, |
| 513 | scoped_refptr<IPC::SyncMessageFilter> sync_message_filter, |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 514 | int source_frame_number); |
| 515 | |
[email protected] | 58b48a0d | 2012-06-13 07:01:35 | [diff] [blame] | 516 | // Override point to obtain that the current composition character bounds. |
| 517 | // In the case of surrogate pairs, the character is treated as two characters: |
| 518 | // the bounds for first character is actual one, and the bounds for second |
| 519 | // character is zero width rectangle. |
| 520 | virtual void GetCompositionCharacterBounds( |
| 521 | std::vector<gfx::Rect>* character_bounds); |
| 522 | |
[email protected] | 88dbe32f | 2013-06-20 23:31:36 | [diff] [blame] | 523 | // Returns the range of the text that is being composed or the selection if |
| 524 | // the composition does not exist. |
[email protected] | db4fc1e | 2013-09-06 20:01:51 | [diff] [blame] | 525 | virtual void GetCompositionRange(gfx::Range* range); |
[email protected] | 88dbe32f | 2013-06-20 23:31:36 | [diff] [blame] | 526 | |
[email protected] | 58b48a0d | 2012-06-13 07:01:35 | [diff] [blame] | 527 | // Returns true if the composition range or composition character bounds |
| 528 | // should be sent to the browser process. |
| 529 | bool ShouldUpdateCompositionInfo( |
[email protected] | db4fc1e | 2013-09-06 20:01:51 | [diff] [blame] | 530 | const gfx::Range& range, |
[email protected] | 58b48a0d | 2012-06-13 07:01:35 | [diff] [blame] | 531 | const std::vector<gfx::Rect>& bounds); |
| 532 | |
[email protected] | ad26ef4 | 2011-06-17 07:59:45 | [diff] [blame] | 533 | // Override point to obtain that the current input method state about |
| 534 | // composition text. |
| 535 | virtual bool CanComposeInline(); |
[email protected] | 56ea1a6 | 2011-05-30 07:05:57 | [diff] [blame] | 536 | |
[email protected] | 2533ce1 | 2009-05-09 00:02:24 | [diff] [blame] | 537 | // Set the pending window rect. |
| 538 | // Because the real render_widget is hosted in another process, there is |
| 539 | // a time period where we may have set a new window rect which has not yet |
| 540 | // been processed by the browser. So we maintain a pending window rect |
| 541 | // size. If JS code sets the WindowRect, and then immediately calls |
| 542 | // GetWindowRect() we'll use this pending window rect as the size. |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 543 | void SetPendingWindowRect(const blink::WebRect& r); |
[email protected] | 2533ce1 | 2009-05-09 00:02:24 | [diff] [blame] | 544 | |
[email protected] | ce6689f | 2013-03-29 12:52:55 | [diff] [blame] | 545 | // Check whether the WebWidget has any touch event handlers registered. |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 546 | void hasTouchEventHandlers(bool has_handlers) override; |
[email protected] | ce6689f | 2013-03-29 12:52:55 | [diff] [blame] | 547 | |
[email protected] | 5d0bbdfa9 | 2013-12-10 00:35:51 | [diff] [blame] | 548 | // Tell the browser about the actions permitted for a new touch point. |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 549 | void setTouchAction(blink::WebTouchAction touch_action) override; |
[email protected] | 5d0bbdfa9 | 2013-12-10 00:35:51 | [diff] [blame] | 550 | |
[email protected] | 90f2415 | 2014-04-09 12:41:36 | [diff] [blame] | 551 | // Called when value of focused text field gets dirty, e.g. value is modified |
| 552 | // by script, not by user input. |
avi | 5c77d21 | 2015-09-25 20:08:25 | [diff] [blame] | 553 | void didUpdateTextOfFocusedElementByNonUserInput() override; |
[email protected] | 90f2415 | 2014-04-09 12:41:36 | [diff] [blame] | 554 | |
[email protected] | ed7defa | 2013-03-12 21:29:59 | [diff] [blame] | 555 | // Creates a 3D context associated with this view. |
jbauman | 5e420d3 | 2015-08-05 09:33:01 | [diff] [blame] | 556 | scoped_ptr<WebGraphicsContext3DCommandBufferImpl> CreateGraphicsContext3D( |
| 557 | bool compositor); |
[email protected] | ed7defa | 2013-03-12 21:29:59 | [diff] [blame] | 558 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 559 | // Routing ID that allows us to communicate to the parent browser process |
| 560 | // RenderWidgetHost. When MSG_ROUTING_NONE, no messages may be sent. |
| 561 | int32 routing_id_; |
| 562 | |
danakj | 6e3bf801 | 2014-12-16 18:27:53 | [diff] [blame] | 563 | // Dependencies for initializing a compositor, including flags for optional |
| 564 | // features. |
dcheng | 35d31c11 | 2015-07-22 00:17:36 | [diff] [blame] | 565 | CompositorDependencies* const compositor_deps_; |
danakj | 6e3bf801 | 2014-12-16 18:27:53 | [diff] [blame] | 566 | |
[email protected] | c5b3b5e | 2009-02-13 06:41:11 | [diff] [blame] | 567 | // We are responsible for destroying this object via its Close method. |
[email protected] | 4ee6462 | 2014-03-21 22:34:15 | [diff] [blame] | 568 | // May be NULL when the window is closing. |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 569 | blink::WebWidget* webwidget_; |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 570 | |
[email protected] | 8926c60 | 2013-01-23 05:32:06 | [diff] [blame] | 571 | // This is lazily constructed and must not outlive webwidget_. |
[email protected] | ba91a79 | 2013-02-06 09:48:28 | [diff] [blame] | 572 | scoped_ptr<RenderWidgetCompositor> compositor_; |
[email protected] | 8926c60 | 2013-01-23 05:32:06 | [diff] [blame] | 573 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 574 | // Set to the ID of the view that initiated creating this view, if any. When |
| 575 | // the view was initiated by the browser (the common case), this will be |
| 576 | // MSG_ROUTING_NONE. This is used in determining ownership when opening |
| 577 | // child tabs. See RenderWidget::createWebViewWithRequest. |
| 578 | // |
| 579 | // This ID may refer to an invalid view if that view is closed before this |
| 580 | // view is. |
| 581 | int32 opener_id_; |
| 582 | |
bokan | c007c3a | 2015-02-03 07:15:56 | [diff] [blame] | 583 | // The rect where this view should be initially shown. |
| 584 | gfx::Rect initial_rect_; |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 585 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 586 | // We store the current cursor object so we can avoid spamming SetCursor |
| 587 | // messages. |
| 588 | WebCursor current_cursor_; |
[email protected] | 88efb7ec | 2009-07-14 16:32:59 | [diff] [blame] | 589 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 590 | // The size of the RenderWidget. |
| 591 | gfx::Size size_; |
| 592 | |
[email protected] | 60d47ac | 2013-03-01 23:42:44 | [diff] [blame] | 593 | // The size of the view's backing surface in non-DPI-adjusted pixels. |
| 594 | gfx::Size physical_backing_size_; |
| 595 | |
dtrainor | cb7779b8 | 2014-12-04 01:08:02 | [diff] [blame] | 596 | // Whether or not Blink's viewport size should be shrunk by the height of the |
| 597 | // URL-bar (always false on platforms where URL-bar hiding isn't supported). |
| 598 | bool top_controls_shrink_blink_size_; |
| 599 | |
| 600 | // The height of the top controls (always 0 on platforms where URL-bar hiding |
| 601 | // isn't supported). |
| 602 | float top_controls_height_; |
[email protected] | d908376 | 2013-03-24 01:36:40 | [diff] [blame] | 603 | |
[email protected] | bb6378fe | 2014-04-28 21:19:44 | [diff] [blame] | 604 | // The size of the visible viewport in DPI-adjusted pixels. |
| 605 | gfx::Size visible_viewport_size_; |
| 606 | |
[email protected] | f21c613a | 2009-02-12 14:46:17 | [diff] [blame] | 607 | // The area that must be reserved for drawing the resize corner. |
| 608 | gfx::Rect resizer_rect_; |
| 609 | |
[email protected] | 53d3f30 | 2009-12-21 04:42:05 | [diff] [blame] | 610 | // Flags for the next ViewHostMsg_UpdateRect message. |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 611 | int next_paint_flags_; |
| 612 | |
[email protected] | 847a258 | 2013-03-09 02:29:51 | [diff] [blame] | 613 | // Whether the WebWidget is in auto resize mode, which is used for example |
| 614 | // by extension popups. |
| 615 | bool auto_resize_mode_; |
| 616 | |
[email protected] | ea3ee0a | 2012-05-15 03:43:09 | [diff] [blame] | 617 | // True if we need to send an UpdateRect message to notify the browser about |
| 618 | // an already-completed auto-resize. |
| 619 | bool need_update_rect_for_auto_resize_; |
| 620 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 621 | // Set to true if we should ignore RenderWidget::Show calls. |
| 622 | bool did_show_; |
| 623 | |
| 624 | // Indicates that we shouldn't bother generated paint events. |
| 625 | bool is_hidden_; |
| 626 | |
[email protected] | 7912e82 | 2014-04-16 02:37:03 | [diff] [blame] | 627 | // Indicates that we are never visible, so never produce graphical output. |
sievers | 71c62dd5 | 2015-10-07 01:44:39 | [diff] [blame] | 628 | const bool compositor_never_visible_; |
[email protected] | 7912e82 | 2014-04-16 02:37:03 | [diff] [blame] | 629 | |
mikhail.pozdnyakov | f2c902a | 2015-04-14 08:09:12 | [diff] [blame] | 630 | // Indicates whether tab-initiated fullscreen was granted. |
| 631 | bool is_fullscreen_granted_; |
[email protected] | ee41e7d2 | 2011-10-14 19:34:09 | [diff] [blame] | 632 | |
mikhail.pozdnyakov | c0e251b | 2015-04-15 06:51:12 | [diff] [blame] | 633 | // Indicates the display mode. |
| 634 | blink::WebDisplayMode display_mode_; |
| 635 | |
changwan | f2a707b | 2015-10-30 08:22:16 | [diff] [blame] | 636 | // It is possible that one ImeEventGuard is nested inside another |
| 637 | // ImeEventGuard. We keep track of the outermost one, and update it as needed. |
| 638 | ImeEventGuard* ime_event_guard_; |
[email protected] | e8f775f | 2013-02-14 21:00:50 | [diff] [blame] | 639 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 640 | // True if we have requested this widget be closed. No more messages will |
| 641 | // be sent, except for a Close. |
| 642 | bool closing_; |
| 643 | |
[email protected] | aeeedad | 2014-08-22 18:16:22 | [diff] [blame] | 644 | // True if it is known that the host is in the process of being shut down. |
| 645 | bool host_closing_; |
| 646 | |
[email protected] | 992db4c | 2011-05-12 15:37:15 | [diff] [blame] | 647 | // Whether this RenderWidget is currently swapped out, such that the view is |
| 648 | // being rendered by another process. If all RenderWidgets in a process are |
| 649 | // swapped out, the process can exit. |
| 650 | bool is_swapped_out_; |
| 651 | |
simonhong | 628f981 | 2015-04-27 23:13:20 | [diff] [blame] | 652 | // TODO(simonhong): Remove this when we enable BeginFrame scheduling for |
| 653 | // OOPIF(crbug.com/471411). |
| 654 | // Whether this RenderWidget is for an out-of-process iframe or not. |
| 655 | bool for_oopif_; |
| 656 | |
[email protected] | 5b739cb | 2012-08-21 20:35:21 | [diff] [blame] | 657 | // Stores information about the current text input. |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 658 | blink::WebTextInputInfo text_input_info_; |
[email protected] | 5b739cb | 2012-08-21 20:35:21 | [diff] [blame] | 659 | |
[email protected] | fa7b1dc | 2010-06-23 17:53:04 | [diff] [blame] | 660 | // Stores the current text input type of |webwidget_|. |
[email protected] | ad26ef4 | 2011-06-17 07:59:45 | [diff] [blame] | 661 | ui::TextInputType text_input_type_; |
| 662 | |
[email protected] | b256eca | 2013-07-11 10:57:40 | [diff] [blame] | 663 | // Stores the current text input mode of |webwidget_|. |
| 664 | ui::TextInputMode text_input_mode_; |
| 665 | |
shuchen | 82ce8c5 | 2014-10-23 01:55:20 | [diff] [blame] | 666 | // Stores the current text input flags of |webwidget_|. |
| 667 | int text_input_flags_; |
| 668 | |
[email protected] | 86ba5fcb | 2013-09-04 00:36:53 | [diff] [blame] | 669 | // Stores the current type of composition text rendering of |webwidget_|. |
| 670 | bool can_compose_inline_; |
| 671 | |
[email protected] | e99ef6f | 2011-10-16 01:13:00 | [diff] [blame] | 672 | // Stores the current selection bounds. |
[email protected] | 7c8873e | 2013-02-05 08:03:01 | [diff] [blame] | 673 | gfx::Rect selection_focus_rect_; |
| 674 | gfx::Rect selection_anchor_rect_; |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 675 | |
[email protected] | 58b48a0d | 2012-06-13 07:01:35 | [diff] [blame] | 676 | // Stores the current composition character bounds. |
| 677 | std::vector<gfx::Rect> composition_character_bounds_; |
| 678 | |
| 679 | // Stores the current composition range. |
[email protected] | db4fc1e | 2013-09-06 20:01:51 | [diff] [blame] | 680 | gfx::Range composition_range_; |
[email protected] | 58b48a0d | 2012-06-13 07:01:35 | [diff] [blame] | 681 | |
[email protected] | 3e2b375b | 2010-04-07 17:03:12 | [diff] [blame] | 682 | // The kind of popup this widget represents, NONE if not a popup. |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 683 | blink::WebPopupType popup_type_; |
[email protected] | 0ebf387 | 2008-11-07 21:35:03 | [diff] [blame] | 684 | |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 685 | // Holds all the needed plugin window moves for a scroll. |
[email protected] | 29e2fb4 | 2013-07-19 01:13:47 | [diff] [blame] | 686 | typedef std::vector<WebPluginGeometry> WebPluginGeometryVector; |
[email protected] | 26865477 | 2009-08-06 23:02:04 | [diff] [blame] | 687 | WebPluginGeometryVector plugin_window_moves_; |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 688 | |
[email protected] | 80ad862 | 2012-11-07 16:33:03 | [diff] [blame] | 689 | // While we are waiting for the browser to update window sizes, we track the |
| 690 | // pending size temporarily. |
[email protected] | 2533ce1 | 2009-05-09 00:02:24 | [diff] [blame] | 691 | int pending_window_rect_count_; |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 692 | blink::WebRect pending_window_rect_; |
[email protected] | 2533ce1 | 2009-05-09 00:02:24 | [diff] [blame] | 693 | |
[email protected] | 80ad862 | 2012-11-07 16:33:03 | [diff] [blame] | 694 | // The screen rects of the view and the window that contains it. |
| 695 | gfx::Rect view_screen_rect_; |
| 696 | gfx::Rect window_screen_rect_; |
| 697 | |
fsamuel | 72464894f | 2015-12-15 06:59:31 | [diff] [blame] | 698 | RenderWidgetInputHandler input_handler_; |
[email protected] | 12fbad81 | 2009-09-01 18:21:24 | [diff] [blame] | 699 | |
[email protected] | fd84779 | 2013-10-24 17:12:35 | [diff] [blame] | 700 | // The time spent in input handlers this frame. Used to throttle input acks. |
| 701 | base::TimeDelta total_input_handling_time_this_frame_; |
| 702 | |
[email protected] | 842f1065 | 2012-06-06 01:54:04 | [diff] [blame] | 703 | // Properties of the screen hosting this RenderWidget instance. |
[email protected] | 180ef24 | 2013-11-07 06:50:46 | [diff] [blame] | 704 | blink::WebScreenInfo screen_info_; |
[email protected] | 842f1065 | 2012-06-06 01:54:04 | [diff] [blame] | 705 | |
[email protected] | f1cccb3 | 2012-06-06 18:29:59 | [diff] [blame] | 706 | // The device scale factor. This value is computed from the DPI entries in |
| 707 | // |screen_info_| on some platforms, and defaults to 1 on other platforms. |
[email protected] | faec7b1 | 2012-06-19 14:42:13 | [diff] [blame] | 708 | float device_scale_factor_; |
[email protected] | f1cccb3 | 2012-06-06 18:29:59 | [diff] [blame] | 709 | |
[email protected] | 28ed6b3 | 2014-06-08 02:16:27 | [diff] [blame] | 710 | // The device color profile on supported platforms. |
| 711 | std::vector<char> device_color_profile_; |
| 712 | |
[email protected] | 9017d785 | 2013-11-21 17:47:35 | [diff] [blame] | 713 | // State associated with synthetic gestures. Synthetic gestures are processed |
| 714 | // in-order, so a queue is sufficient to identify the correct state for a |
| 715 | // completed gesture. |
| 716 | std::queue<SyntheticGestureCompletionCallback> |
| 717 | pending_synthetic_gesture_callbacks_; |
[email protected] | 0e241b4b | 2012-08-18 09:06:27 | [diff] [blame] | 718 | |
[email protected] | 53b4cc1 | 2013-07-18 23:02:30 | [diff] [blame] | 719 | uint32 next_output_surface_id_; |
| 720 | |
[email protected] | 0d1ebed1 | 2013-08-05 22:01:13 | [diff] [blame] | 721 | #if defined(OS_ANDROID) |
[email protected] | 90f2415 | 2014-04-09 12:41:36 | [diff] [blame] | 722 | // Indicates value in the focused text field is in dirty state, i.e. modified |
| 723 | // by script etc., not by user input. |
| 724 | bool text_field_is_dirty_; |
| 725 | |
changwan | 3a84116 | 2015-08-11 02:53:37 | [diff] [blame] | 726 | // Stores the history of text input infos from the last ACK'ed one from the |
| 727 | // current one. The size is the number of pending ACKs plus one, since we |
| 728 | // intentionally keep the last ack'd value to know what the browser is |
| 729 | // currently aware of. |
| 730 | std::deque<blink::WebTextInputInfo> text_input_info_history_; |
[email protected] | 0d1ebed1 | 2013-08-05 22:01:13 | [diff] [blame] | 731 | #endif |
| 732 | |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 733 | scoped_ptr<ScreenMetricsEmulator> screen_metrics_emulator_; |
| 734 | |
| 735 | // Popups may be displaced when screen metrics emulation is enabled. |
| 736 | // These values are used to properly adjust popup position. |
danakj | 2ef31b8 | 2015-10-21 18:18:02 | [diff] [blame] | 737 | gfx::Point popup_view_origin_for_emulation_; |
| 738 | gfx::Point popup_screen_origin_for_emulation_; |
[email protected] | b2e4c7013 | 2013-10-03 02:07:51 | [diff] [blame] | 739 | float popup_origin_scale_for_emulation_; |
| 740 | |
[email protected] | 586871b | 2014-07-22 17:05:11 | [diff] [blame] | 741 | scoped_refptr<FrameSwapMessageQueue> frame_swap_message_queue_; |
[email protected] | 5b45ad4 | 2013-10-25 00:42:04 | [diff] [blame] | 742 | scoped_ptr<ResizingModeSelector> resizing_mode_selector_; |
| 743 | |
[email protected] | e3244ed | 2014-06-20 20:04:27 | [diff] [blame] | 744 | // Lists of RenderFrameProxy objects that need to be notified of |
| 745 | // compositing-related events (e.g. DidCommitCompositorFrame). |
brettw | 236d317 | 2015-06-03 16:31:43 | [diff] [blame] | 746 | base::ObserverList<RenderFrameProxy> render_frame_proxies_; |
[email protected] | a017938b | 2014-05-27 21:17:17 | [diff] [blame] | 747 | #if defined(VIDEO_HOLE) |
brettw | 236d317 | 2015-06-03 16:31:43 | [diff] [blame] | 748 | base::ObserverList<RenderFrameImpl> video_hole_frames_; |
[email protected] | a017938b | 2014-05-27 21:17:17 | [diff] [blame] | 749 | #endif // defined(VIDEO_HOLE) |
[email protected] | bffc830 | 2014-01-23 20:52:16 | [diff] [blame] | 750 | |
[email protected] | de3c5d8 | 2014-05-28 22:12:59 | [diff] [blame] | 751 | // A list of RenderFrames associated with this RenderWidget. Notifications |
| 752 | // are sent to each frame in the list for events such as changing |
| 753 | // visibility state for example. |
brettw | 236d317 | 2015-06-03 16:31:43 | [diff] [blame] | 754 | base::ObserverList<RenderFrameImpl> render_frames_; |
[email protected] | de3c5d8 | 2014-05-28 22:12:59 | [diff] [blame] | 755 | |
[email protected] | be1af066 | 2014-07-29 19:55:51 | [diff] [blame] | 756 | bool has_host_context_menu_location_; |
| 757 | gfx::Point host_context_menu_location_; |
[email protected] | a09d53ce | 2014-01-31 00:46:42 | [diff] [blame] | 758 | |
alexclarke | 7fa9394 | 2015-10-21 15:37:11 | [diff] [blame] | 759 | scoped_ptr<scheduler::RenderWidgetSchedulingState> |
| 760 | render_widget_scheduling_state_; |
| 761 | |
[email protected] | 05d47875 | 2009-04-08 23:38:16 | [diff] [blame] | 762 | DISALLOW_COPY_AND_ASSIGN(RenderWidget); |
initial.commit | 09911bf | 2008-07-26 23:55:29 | [diff] [blame] | 763 | }; |
| 764 | |
[email protected] | e9ff79c | 2012-10-19 21:31:26 | [diff] [blame] | 765 | } // namespace content |
| 766 | |
[email protected] | 2cff005 | 2011-03-18 16:51:44 | [diff] [blame] | 767 | #endif // CONTENT_RENDERER_RENDER_WIDGET_H_ |