1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 // IPC messages for page rendering.
6 // Multiply-included message file, hence no include guard.
8 #include "base/memory/shared_memory.h"
9 #include "base/process/process.h"
10 #include "base/strings/string16.h"
11 #include "cc/output/begin_frame_args.h"
12 #include "cc/output/compositor_frame.h"
13 #include "cc/output/compositor_frame_ack.h"
14 #include "content/common/browser_rendering_stats.h"
15 #include "content/common/content_export.h"
16 #include "content/common/content_param_traits.h"
17 #include "content/common/cookie_data.h"
18 #include "content/common/navigation_gesture.h"
19 #include "content/common/pepper_renderer_instance_data.h"
20 #include "content/common/view_message_enums.h"
21 #include "content/common/webplugin_geometry.h"
22 #include "content/port/common/input_event_ack_state.h"
23 #include "content/public/common/common_param_traits.h"
24 #include "content/public/common/context_menu_params.h"
25 #include "content/public/common/favicon_url.h"
26 #include "content/public/common/file_chooser_params.h"
27 #include "content/public/common/frame_navigate_params.h"
28 #include "content/public/common/javascript_message_type.h"
29 #include "content/public/common/menu_item.h"
30 #include "content/public/common/page_state.h"
31 #include "content/public/common/page_zoom.h"
32 #include "content/public/common/referrer.h"
33 #include "content/public/common/renderer_preferences.h"
34 #include "content/public/common/stop_find_action.h"
35 #include "content/public/common/three_d_api_types.h"
36 #include "content/public/common/window_container_type.h"
37 #include "ipc/ipc_channel_handle.h"
38 #include "ipc/ipc_message_macros.h"
39 #include "ipc/ipc_platform_file.h"
40 #include "media/audio/audio_parameters.h"
41 #include "media/base/channel_layout.h"
42 #include "media/base/media_log_event.h"
43 #include "third_party/WebKit/public/platform/WebFloatPoint.h"
44 #include "third_party/WebKit/public/platform/WebFloatRect.h"
45 #include "third_party/WebKit/public/web/WebCompositionUnderline.h"
46 #include "third_party/WebKit/public/web/WebFindOptions.h"
47 #include "third_party/WebKit/public/web/WebMediaPlayerAction.h"
48 #include "third_party/WebKit/public/web/WebPluginAction.h"
49 #include "third_party/WebKit/public/web/WebPopupType.h"
50 #include "third_party/WebKit/public/web/WebScreenInfo.h"
51 #include "third_party/WebKit/public/web/WebTextDirection.h"
52 #include "third_party/skia/include/core/SkBitmap.h"
53 #include "ui/base/ime/text_input_mode.h"
54 #include "ui/base/ime/text_input_type.h"
55 #include "ui/base/ui_base_types.h"
56 #include "ui/gfx/point.h"
57 #include "ui/gfx/range/range.h"
58 #include "ui/gfx/rect.h"
59 #include "ui/gfx/rect_f.h"
60 #include "ui/gfx/vector2d.h"
61 #include "ui/gfx/vector2d_f.h"
62 #include "ui/shell_dialogs/selected_file_info.h"
64 #if defined(OS_MACOSX)
65 #include "content/common/mac/font_descriptor.h"
68 #undef IPC_MESSAGE_EXPORT
69 #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
71 #define IPC_MESSAGE_START ViewMsgStart
73 IPC_ENUM_TRAITS(AccessibilityMode)
74 IPC_ENUM_TRAITS(ViewMsg_Navigate_Type::Value)
75 IPC_ENUM_TRAITS(WebKit::WebContextMenuData::MediaType)
76 IPC_ENUM_TRAITS(WebKit::WebMediaPlayerAction::Type)
77 IPC_ENUM_TRAITS(WebKit::WebPluginAction::Type)
78 IPC_ENUM_TRAITS(WebKit::WebPopupType)
79 IPC_ENUM_TRAITS(WebKit::WebTextDirection)
80 IPC_ENUM_TRAITS(WindowContainerType)
81 IPC_ENUM_TRAITS(content::FaviconURL::IconType)
82 IPC_ENUM_TRAITS(content::FileChooserParams::Mode)
83 IPC_ENUM_TRAITS(content::JavaScriptMessageType)
84 IPC_ENUM_TRAITS(content::MenuItem::Type)
85 IPC_ENUM_TRAITS(content::NavigationGesture)
86 IPC_ENUM_TRAITS(content::PageZoom)
87 IPC_ENUM_TRAITS(content::RendererPreferencesHintingEnum)
88 IPC_ENUM_TRAITS(content::RendererPreferencesSubpixelRenderingEnum)
89 IPC_ENUM_TRAITS_MAX_VALUE(content::TapMultipleTargetsStrategy,
90 content::TAP_MULTIPLE_TARGETS_STRATEGY_MAX)
91 IPC_ENUM_TRAITS(content::StopFindAction)
92 IPC_ENUM_TRAITS(content::ThreeDAPIType)
93 IPC_ENUM_TRAITS(media::ChannelLayout)
94 IPC_ENUM_TRAITS(media::MediaLogEvent::Type)
95 IPC_ENUM_TRAITS(ui::MenuSourceType)
96 IPC_ENUM_TRAITS_MAX_VALUE(ui::TextInputMode, ui::TEXT_INPUT_MODE_MAX)
97 IPC_ENUM_TRAITS(ui::TextInputType)
99 #if defined(OS_MACOSX)
100 IPC_STRUCT_TRAITS_BEGIN(FontDescriptor)
101 IPC_STRUCT_TRAITS_MEMBER(font_name)
102 IPC_STRUCT_TRAITS_MEMBER(font_point_size)
103 IPC_STRUCT_TRAITS_END()
106 IPC_STRUCT_TRAITS_BEGIN(WebKit::WebCompositionUnderline)
107 IPC_STRUCT_TRAITS_MEMBER(startOffset)
108 IPC_STRUCT_TRAITS_MEMBER(endOffset)
109 IPC_STRUCT_TRAITS_MEMBER(color)
110 IPC_STRUCT_TRAITS_MEMBER(thick)
111 IPC_STRUCT_TRAITS_END()
113 IPC_STRUCT_TRAITS_BEGIN(WebKit::WebFindOptions)
114 IPC_STRUCT_TRAITS_MEMBER(forward)
115 IPC_STRUCT_TRAITS_MEMBER(matchCase)
116 IPC_STRUCT_TRAITS_MEMBER(findNext)
117 IPC_STRUCT_TRAITS_END()
119 IPC_STRUCT_TRAITS_BEGIN(WebKit::WebMediaPlayerAction)
120 IPC_STRUCT_TRAITS_MEMBER(type)
121 IPC_STRUCT_TRAITS_MEMBER(enable)
122 IPC_STRUCT_TRAITS_END()
124 IPC_STRUCT_TRAITS_BEGIN(WebKit::WebPluginAction)
125 IPC_STRUCT_TRAITS_MEMBER(type)
126 IPC_STRUCT_TRAITS_MEMBER(enable)
127 IPC_STRUCT_TRAITS_END()
129 IPC_STRUCT_TRAITS_BEGIN(WebKit::WebFloatPoint)
130 IPC_STRUCT_TRAITS_MEMBER(x)
131 IPC_STRUCT_TRAITS_MEMBER(y)
132 IPC_STRUCT_TRAITS_END()
134 IPC_STRUCT_TRAITS_BEGIN(WebKit::WebFloatRect)
135 IPC_STRUCT_TRAITS_MEMBER(x)
136 IPC_STRUCT_TRAITS_MEMBER(y)
137 IPC_STRUCT_TRAITS_MEMBER(width)
138 IPC_STRUCT_TRAITS_MEMBER(height)
139 IPC_STRUCT_TRAITS_END()
141 IPC_STRUCT_TRAITS_BEGIN(WebKit::WebScreenInfo)
142 IPC_STRUCT_TRAITS_MEMBER(deviceScaleFactor)
143 IPC_STRUCT_TRAITS_MEMBER(depth)
144 IPC_STRUCT_TRAITS_MEMBER(depthPerComponent)
145 IPC_STRUCT_TRAITS_MEMBER(isMonochrome)
146 IPC_STRUCT_TRAITS_MEMBER(rect)
147 IPC_STRUCT_TRAITS_MEMBER(availableRect)
148 IPC_STRUCT_TRAITS_END()
150 IPC_STRUCT_TRAITS_BEGIN(content::MenuItem)
151 IPC_STRUCT_TRAITS_MEMBER(label)
152 IPC_STRUCT_TRAITS_MEMBER(tool_tip)
153 IPC_STRUCT_TRAITS_MEMBER(type)
154 IPC_STRUCT_TRAITS_MEMBER(action)
155 IPC_STRUCT_TRAITS_MEMBER(rtl)
156 IPC_STRUCT_TRAITS_MEMBER(has_directional_override)
157 IPC_STRUCT_TRAITS_MEMBER(enabled)
158 IPC_STRUCT_TRAITS_MEMBER(checked)
159 IPC_STRUCT_TRAITS_MEMBER(submenu)
160 IPC_STRUCT_TRAITS_END()
162 IPC_STRUCT_TRAITS_BEGIN(content::ContextMenuParams)
163 IPC_STRUCT_TRAITS_MEMBER(media_type)
164 IPC_STRUCT_TRAITS_MEMBER(x)
165 IPC_STRUCT_TRAITS_MEMBER(y)
166 IPC_STRUCT_TRAITS_MEMBER(link_url)
167 IPC_STRUCT_TRAITS_MEMBER(link_text)
168 IPC_STRUCT_TRAITS_MEMBER(unfiltered_link_url)
169 IPC_STRUCT_TRAITS_MEMBER(src_url)
170 IPC_STRUCT_TRAITS_MEMBER(has_image_contents)
171 IPC_STRUCT_TRAITS_MEMBER(page_url)
172 IPC_STRUCT_TRAITS_MEMBER(keyword_url)
173 IPC_STRUCT_TRAITS_MEMBER(frame_url)
174 IPC_STRUCT_TRAITS_MEMBER(frame_page_state)
175 IPC_STRUCT_TRAITS_MEMBER(media_flags)
176 IPC_STRUCT_TRAITS_MEMBER(selection_text)
177 IPC_STRUCT_TRAITS_MEMBER(misspelled_word)
178 IPC_STRUCT_TRAITS_MEMBER(misspelling_hash)
179 IPC_STRUCT_TRAITS_MEMBER(dictionary_suggestions)
180 IPC_STRUCT_TRAITS_MEMBER(speech_input_enabled)
181 IPC_STRUCT_TRAITS_MEMBER(spellcheck_enabled)
182 IPC_STRUCT_TRAITS_MEMBER(is_editable)
183 #if defined(OS_MACOSX)
184 IPC_STRUCT_TRAITS_MEMBER(writing_direction_default)
185 IPC_STRUCT_TRAITS_MEMBER(writing_direction_left_to_right)
186 IPC_STRUCT_TRAITS_MEMBER(writing_direction_right_to_left)
188 IPC_STRUCT_TRAITS_MEMBER(edit_flags)
189 IPC_STRUCT_TRAITS_MEMBER(security_info)
190 IPC_STRUCT_TRAITS_MEMBER(frame_charset)
191 IPC_STRUCT_TRAITS_MEMBER(referrer_policy)
192 IPC_STRUCT_TRAITS_MEMBER(custom_context)
193 IPC_STRUCT_TRAITS_MEMBER(custom_items)
194 IPC_STRUCT_TRAITS_MEMBER(source_type)
195 #if defined(OS_ANDROID)
196 IPC_STRUCT_TRAITS_MEMBER(selection_start)
197 IPC_STRUCT_TRAITS_MEMBER(selection_end)
199 IPC_STRUCT_TRAITS_END()
201 IPC_STRUCT_TRAITS_BEGIN(content::CustomContextMenuContext)
202 IPC_STRUCT_TRAITS_MEMBER(is_pepper_menu)
203 IPC_STRUCT_TRAITS_MEMBER(request_id)
204 IPC_STRUCT_TRAITS_MEMBER(render_widget_id)
205 IPC_STRUCT_TRAITS_END()
207 IPC_STRUCT_TRAITS_BEGIN(content::FaviconURL)
208 IPC_STRUCT_TRAITS_MEMBER(icon_url)
209 IPC_STRUCT_TRAITS_MEMBER(icon_type)
210 IPC_STRUCT_TRAITS_END()
212 IPC_STRUCT_TRAITS_BEGIN(content::FileChooserParams)
213 IPC_STRUCT_TRAITS_MEMBER(mode)
214 IPC_STRUCT_TRAITS_MEMBER(title)
215 IPC_STRUCT_TRAITS_MEMBER(default_file_name)
216 IPC_STRUCT_TRAITS_MEMBER(accept_types)
217 #if defined(OS_ANDROID)
218 IPC_STRUCT_TRAITS_MEMBER(capture)
220 IPC_STRUCT_TRAITS_END()
222 IPC_STRUCT_TRAITS_BEGIN(content::FrameNavigateParams)
223 IPC_STRUCT_TRAITS_MEMBER(page_id)
224 IPC_STRUCT_TRAITS_MEMBER(url)
225 IPC_STRUCT_TRAITS_MEMBER(base_url)
226 IPC_STRUCT_TRAITS_MEMBER(referrer)
227 IPC_STRUCT_TRAITS_MEMBER(transition)
228 IPC_STRUCT_TRAITS_MEMBER(redirects)
229 IPC_STRUCT_TRAITS_MEMBER(should_update_history)
230 IPC_STRUCT_TRAITS_MEMBER(searchable_form_url)
231 IPC_STRUCT_TRAITS_MEMBER(searchable_form_encoding)
232 IPC_STRUCT_TRAITS_MEMBER(contents_mime_type)
233 IPC_STRUCT_TRAITS_MEMBER(socket_address)
234 IPC_STRUCT_TRAITS_END()
236 IPC_STRUCT_TRAITS_BEGIN(content::PepperRendererInstanceData)
237 IPC_STRUCT_TRAITS_MEMBER(render_process_id)
238 IPC_STRUCT_TRAITS_MEMBER(render_view_id)
239 IPC_STRUCT_TRAITS_MEMBER(document_url)
240 IPC_STRUCT_TRAITS_MEMBER(plugin_url)
241 IPC_STRUCT_TRAITS_END()
243 IPC_STRUCT_TRAITS_BEGIN(content::RendererPreferences)
244 IPC_STRUCT_TRAITS_MEMBER(can_accept_load_drops)
245 IPC_STRUCT_TRAITS_MEMBER(should_antialias_text)
246 IPC_STRUCT_TRAITS_MEMBER(hinting)
247 IPC_STRUCT_TRAITS_MEMBER(use_autohinter)
248 IPC_STRUCT_TRAITS_MEMBER(use_bitmaps)
249 IPC_STRUCT_TRAITS_MEMBER(subpixel_rendering)
250 IPC_STRUCT_TRAITS_MEMBER(use_subpixel_positioning)
251 IPC_STRUCT_TRAITS_MEMBER(focus_ring_color)
252 IPC_STRUCT_TRAITS_MEMBER(thumb_active_color)
253 IPC_STRUCT_TRAITS_MEMBER(thumb_inactive_color)
254 IPC_STRUCT_TRAITS_MEMBER(track_color)
255 IPC_STRUCT_TRAITS_MEMBER(active_selection_bg_color)
256 IPC_STRUCT_TRAITS_MEMBER(active_selection_fg_color)
257 IPC_STRUCT_TRAITS_MEMBER(inactive_selection_bg_color)
258 IPC_STRUCT_TRAITS_MEMBER(inactive_selection_fg_color)
259 IPC_STRUCT_TRAITS_MEMBER(browser_handles_non_local_top_level_requests)
260 IPC_STRUCT_TRAITS_MEMBER(browser_handles_all_top_level_requests)
261 IPC_STRUCT_TRAITS_MEMBER(caret_blink_interval)
262 IPC_STRUCT_TRAITS_MEMBER(use_custom_colors)
263 IPC_STRUCT_TRAITS_MEMBER(enable_referrers)
264 IPC_STRUCT_TRAITS_MEMBER(enable_do_not_track)
265 IPC_STRUCT_TRAITS_MEMBER(default_zoom_level)
266 IPC_STRUCT_TRAITS_MEMBER(user_agent_override)
267 IPC_STRUCT_TRAITS_MEMBER(accept_languages)
268 IPC_STRUCT_TRAITS_MEMBER(report_frame_name_changes)
269 IPC_STRUCT_TRAITS_MEMBER(touchpad_fling_profile)
270 IPC_STRUCT_TRAITS_MEMBER(touchscreen_fling_profile)
271 IPC_STRUCT_TRAITS_MEMBER(tap_multiple_targets_strategy)
272 IPC_STRUCT_TRAITS_MEMBER(disable_client_blocked_error_page)
273 IPC_STRUCT_TRAITS_MEMBER(plugin_fullscreen_allowed)
274 IPC_STRUCT_TRAITS_END()
276 IPC_STRUCT_TRAITS_BEGIN(content::CookieData)
277 IPC_STRUCT_TRAITS_MEMBER(name)
278 IPC_STRUCT_TRAITS_MEMBER(value)
279 IPC_STRUCT_TRAITS_MEMBER(domain)
280 IPC_STRUCT_TRAITS_MEMBER(path)
281 IPC_STRUCT_TRAITS_MEMBER(expires)
282 IPC_STRUCT_TRAITS_MEMBER(http_only)
283 IPC_STRUCT_TRAITS_MEMBER(secure)
284 IPC_STRUCT_TRAITS_MEMBER(session)
285 IPC_STRUCT_TRAITS_END()
287 IPC_STRUCT_TRAITS_BEGIN(content::WebPluginGeometry)
288 IPC_STRUCT_TRAITS_MEMBER(window)
289 IPC_STRUCT_TRAITS_MEMBER(window_rect)
290 IPC_STRUCT_TRAITS_MEMBER(clip_rect)
291 IPC_STRUCT_TRAITS_MEMBER(cutout_rects)
292 IPC_STRUCT_TRAITS_MEMBER(rects_valid)
293 IPC_STRUCT_TRAITS_MEMBER(visible)
294 IPC_STRUCT_TRAITS_END()
296 IPC_STRUCT_TRAITS_BEGIN(media::MediaLogEvent)
297 IPC_STRUCT_TRAITS_MEMBER(id)
298 IPC_STRUCT_TRAITS_MEMBER(type)
299 IPC_STRUCT_TRAITS_MEMBER(params)
300 IPC_STRUCT_TRAITS_MEMBER(time)
301 IPC_STRUCT_TRAITS_END()
303 IPC_STRUCT_TRAITS_BEGIN(ui::SelectedFileInfo)
304 IPC_STRUCT_TRAITS_MEMBER(file_path)
305 IPC_STRUCT_TRAITS_MEMBER(local_path)
306 IPC_STRUCT_TRAITS_MEMBER(display_name)
307 IPC_STRUCT_TRAITS_END()
309 IPC_STRUCT_TRAITS_BEGIN(content::BrowserRenderingStats)
310 IPC_STRUCT_TRAITS_MEMBER(input_event_count)
311 IPC_STRUCT_TRAITS_MEMBER(total_input_latency)
312 IPC_STRUCT_TRAITS_MEMBER(touch_ui_count)
313 IPC_STRUCT_TRAITS_MEMBER(total_touch_ui_latency)
314 IPC_STRUCT_TRAITS_MEMBER(touch_acked_count)
315 IPC_STRUCT_TRAITS_MEMBER(total_touch_acked_latency)
316 IPC_STRUCT_TRAITS_MEMBER(scroll_update_count)
317 IPC_STRUCT_TRAITS_MEMBER(total_scroll_update_latency)
318 IPC_STRUCT_TRAITS_END()
320 IPC_STRUCT_BEGIN(ViewHostMsg_CreateWindow_Params)
321 // Routing ID of the view initiating the open.
322 IPC_STRUCT_MEMBER(int, opener_id)
324 // True if this open request came in the context of a user gesture.
325 IPC_STRUCT_MEMBER(bool, user_gesture)
327 // Type of window requested.
328 IPC_STRUCT_MEMBER(WindowContainerType, window_container_type)
330 // The session storage namespace ID this view should use.
331 IPC_STRUCT_MEMBER(int64, session_storage_namespace_id)
333 // The name of the resulting frame that should be created (empty if none
334 // has been specified).
335 IPC_STRUCT_MEMBER(string16, frame_name)
337 // The frame identifier of the frame initiating the open.
338 IPC_STRUCT_MEMBER(int64, opener_frame_id)
340 // The URL of the frame initiating the open.
341 IPC_STRUCT_MEMBER(GURL, opener_url)
343 // The URL of the top frame containing the opener.
344 IPC_STRUCT_MEMBER(GURL, opener_top_level_frame_url)
346 // The security origin of the frame initiating the open.
347 IPC_STRUCT_MEMBER(GURL, opener_security_origin)
349 // Whether the opener will be suppressed in the new window, in which case
350 // scripting the new window is not allowed.
351 IPC_STRUCT_MEMBER(bool, opener_suppressed)
353 // Whether the window should be opened in the foreground, background, etc.
354 IPC_STRUCT_MEMBER(WindowOpenDisposition, disposition)
356 // The URL that will be loaded in the new window (empty if none has been
358 IPC_STRUCT_MEMBER(GURL, target_url)
360 // The referrer that will be used to load |target_url| (empty if none has
362 IPC_STRUCT_MEMBER(content::Referrer, referrer)
364 // The window features to use for the new view.
365 IPC_STRUCT_MEMBER(WebKit::WebWindowFeatures, features)
368 IPC_STRUCT_BEGIN(ViewHostMsg_CreateWorker_Params)
369 // URL for the worker script.
370 IPC_STRUCT_MEMBER(GURL, url)
372 // Name for a SharedWorker, otherwise empty string.
373 IPC_STRUCT_MEMBER(string16, name)
375 // The ID of the parent document (unique within parent renderer).
376 IPC_STRUCT_MEMBER(unsigned long long, document_id)
378 // RenderView routing id used to send messages back to the parent.
379 IPC_STRUCT_MEMBER(int, render_view_route_id)
381 // The route ID to associate with the worker. If MSG_ROUTING_NONE is passed,
382 // a new unique ID is created and assigned to the worker.
383 IPC_STRUCT_MEMBER(int, route_id)
385 // The ID of the appcache the main shared worker script resource was loaded
386 // from, only valid for shared workers.
387 IPC_STRUCT_MEMBER(int64, script_resource_appcache_id)
390 IPC_STRUCT_BEGIN(ViewHostMsg_DateTimeDialogValue_Params)
391 IPC_STRUCT_MEMBER(int, dialog_type)
392 IPC_STRUCT_MEMBER(int, year)
393 IPC_STRUCT_MEMBER(int, month)
394 IPC_STRUCT_MEMBER(int, day)
395 IPC_STRUCT_MEMBER(int, hour)
396 IPC_STRUCT_MEMBER(int, minute)
397 IPC_STRUCT_MEMBER(int, second)
398 IPC_STRUCT_MEMBER(int, milli)
399 IPC_STRUCT_MEMBER(int, week)
400 IPC_STRUCT_MEMBER(double, minimum)
401 IPC_STRUCT_MEMBER(double, maximum)
402 IPC_STRUCT_MEMBER(double, step)
405 IPC_STRUCT_BEGIN(ViewHostMsg_DidFailProvisionalLoadWithError_Params)
406 // The frame ID for the failure report.
407 IPC_STRUCT_MEMBER(int64, frame_id)
408 // The WebFrame's uniqueName().
409 IPC_STRUCT_MEMBER(string16, frame_unique_name)
410 // True if this is the top-most frame.
411 IPC_STRUCT_MEMBER(bool, is_main_frame)
412 // Error code as reported in the DidFailProvisionalLoad callback.
413 IPC_STRUCT_MEMBER(int, error_code)
414 // An error message generated from the error_code. This can be an empty
415 // string if we were unable to find a meaningful description.
416 IPC_STRUCT_MEMBER(string16, error_description)
417 // The URL that the error is reported for.
418 IPC_STRUCT_MEMBER(GURL, url)
419 // True if the failure is the result of navigating to a POST again
420 // and we're going to show the POST interstitial.
421 IPC_STRUCT_MEMBER(bool, showing_repost_interstitial)
424 // Parameters structure for ViewHostMsg_FrameNavigate, which has too many data
425 // parameters to be reasonably put in a predefined IPC message.
426 IPC_STRUCT_BEGIN_WITH_PARENT(ViewHostMsg_FrameNavigate_Params,
427 content::FrameNavigateParams)
428 IPC_STRUCT_TRAITS_PARENT(content::FrameNavigateParams)
429 // The frame ID for this navigation. The frame ID uniquely identifies the
430 // frame the navigation happened in for a given renderer.
431 IPC_STRUCT_MEMBER(int64, frame_id)
433 // The WebFrame's uniqueName().
434 IPC_STRUCT_MEMBER(string16, frame_unique_name)
436 // Information regarding the security of the connection (empty if the
437 // connection was not secure).
438 IPC_STRUCT_MEMBER(std::string, security_info)
440 // The gesture that initiated this navigation.
441 IPC_STRUCT_MEMBER(content::NavigationGesture, gesture)
443 // True if this was a post request.
444 IPC_STRUCT_MEMBER(bool, is_post)
446 // The POST body identifier. -1 if it doesn't exist.
447 IPC_STRUCT_MEMBER(int64, post_id)
449 // Whether the frame navigation resulted in no change to the documents within
450 // the page. For example, the navigation may have just resulted in scrolling
451 // to a named anchor.
452 IPC_STRUCT_MEMBER(bool, was_within_same_page)
454 // The status code of the HTTP request.
455 IPC_STRUCT_MEMBER(int, http_status_code)
457 // True if the connection was proxied. In this case, socket_address
458 // will represent the address of the proxy, rather than the remote host.
459 IPC_STRUCT_MEMBER(bool, was_fetched_via_proxy)
461 // Serialized history item state to store in the navigation entry.
462 IPC_STRUCT_MEMBER(content::PageState, page_state)
464 // Original request's URL.
465 IPC_STRUCT_MEMBER(GURL, original_request_url)
467 // User agent override used to navigate.
468 IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
470 // Notifies the browser that for this navigation, the session history was
471 // successfully cleared.
472 IPC_STRUCT_MEMBER(bool, history_list_was_cleared)
475 IPC_STRUCT_BEGIN(ViewHostMsg_OpenURL_Params)
476 IPC_STRUCT_MEMBER(GURL, url)
477 IPC_STRUCT_MEMBER(content::Referrer, referrer)
478 IPC_STRUCT_MEMBER(WindowOpenDisposition, disposition)
479 IPC_STRUCT_MEMBER(int64, frame_id)
480 IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
481 IPC_STRUCT_MEMBER(bool, user_gesture)
484 IPC_STRUCT_BEGIN(ViewHostMsg_SelectionBounds_Params)
485 IPC_STRUCT_MEMBER(gfx::Rect, anchor_rect)
486 IPC_STRUCT_MEMBER(WebKit::WebTextDirection, anchor_dir)
487 IPC_STRUCT_MEMBER(gfx::Rect, focus_rect)
488 IPC_STRUCT_MEMBER(WebKit::WebTextDirection, focus_dir)
489 IPC_STRUCT_MEMBER(bool, is_anchor_first)
492 // This message is used for supporting popup menus on Mac OS X using native
493 // Cocoa controls. The renderer sends us this message which we use to populate
495 IPC_STRUCT_BEGIN(ViewHostMsg_ShowPopup_Params)
496 // Position on the screen.
497 IPC_STRUCT_MEMBER(gfx::Rect, bounds)
499 // The height of each item in the menu.
500 IPC_STRUCT_MEMBER(int, item_height)
502 // The size of the font to use for those items.
503 IPC_STRUCT_MEMBER(double, item_font_size)
505 // The currently selected (displayed) item in the menu.
506 IPC_STRUCT_MEMBER(int, selected_item)
508 // The entire list of items in the popup menu.
509 IPC_STRUCT_MEMBER(std::vector<content::MenuItem>, popup_items)
511 // Whether items should be right-aligned.
512 IPC_STRUCT_MEMBER(bool, right_aligned)
514 // Whether this is a multi-select popup.
515 IPC_STRUCT_MEMBER(bool, allow_multiple_selection)
518 IPC_STRUCT_BEGIN(ViewHostMsg_TextInputState_Params)
519 // The type of input field
520 IPC_STRUCT_MEMBER(ui::TextInputType, type)
522 // The value of the input field
523 IPC_STRUCT_MEMBER(std::string, value)
525 // The cursor position of the current selection start, or the caret position
526 // if nothing is selected
527 IPC_STRUCT_MEMBER(int, selection_start)
529 // The cursor position of the current selection end, or the caret position
530 // if nothing is selected
531 IPC_STRUCT_MEMBER(int, selection_end)
533 // The start position of the current composition, or -1 if there is none
534 IPC_STRUCT_MEMBER(int, composition_start)
536 // The end position of the current composition, or -1 if there is none
537 IPC_STRUCT_MEMBER(int, composition_end)
539 // Whether or not inline composition can be performed for the current input.
540 IPC_STRUCT_MEMBER(bool, can_compose_inline)
542 // Whether or not the IME should be shown as a result of this update. Even if
543 // true, the IME will only be shown if the type is appropriate (e.g. not
544 // TEXT_INPUT_TYPE_NONE).
545 IPC_STRUCT_MEMBER(bool, show_ime_if_needed)
547 // Whether an acknowledgement is required for this update.
548 IPC_STRUCT_MEMBER(bool, require_ack)
551 IPC_STRUCT_BEGIN(ViewHostMsg_UpdateRect_Params)
552 // The bitmap to be painted into the view at the locations specified by
554 IPC_STRUCT_MEMBER(TransportDIB::Id, bitmap)
556 // The position and size of the bitmap.
557 IPC_STRUCT_MEMBER(gfx::Rect, bitmap_rect)
559 // The scroll delta. Only one of the delta components can be non-zero, and if
560 // they are both zero, then it means there is no scrolling and the scroll_rect
562 IPC_STRUCT_MEMBER(gfx::Vector2d, scroll_delta)
564 // The rectangular region to scroll.
565 IPC_STRUCT_MEMBER(gfx::Rect, scroll_rect)
567 // The scroll offset of the render view.
568 IPC_STRUCT_MEMBER(gfx::Vector2d, scroll_offset)
570 // The regions of the bitmap (in view coords) that contain updated pixels.
571 // In the case of scrolling, this includes the scroll damage rect.
572 IPC_STRUCT_MEMBER(std::vector<gfx::Rect>, copy_rects)
574 // The size of the RenderView when this message was generated. This is
575 // included so the host knows how large the view is from the perspective of
576 // the renderer process. This is necessary in case a resize operation is in
577 // progress. If auto-resize is enabled, this should update the corresponding
579 IPC_STRUCT_MEMBER(gfx::Size, view_size)
581 // New window locations for plugin child windows.
582 IPC_STRUCT_MEMBER(std::vector<content::WebPluginGeometry>,
585 // The following describes the various bits that may be set in flags:
587 // ViewHostMsg_UpdateRect_Flags::IS_RESIZE_ACK
588 // Indicates that this is a response to a ViewMsg_Resize message.
590 // ViewHostMsg_UpdateRect_Flags::IS_RESTORE_ACK
591 // Indicates that this is a response to a ViewMsg_WasShown message.
593 // ViewHostMsg_UpdateRect_Flags::IS_REPAINT_ACK
594 // Indicates that this is a response to a ViewMsg_Repaint message.
596 // If flags is zero, then this message corresponds to an unsolicited paint
597 // request by the render view. Any of the above bits may be set in flags,
598 // which would indicate that this paint message is an ACK for multiple
600 IPC_STRUCT_MEMBER(int, flags)
602 // Whether or not the renderer expects a ViewMsg_UpdateRect_ACK for this
603 // update. True for 2D painting, but false for accelerated compositing.
604 IPC_STRUCT_MEMBER(bool, needs_ack)
606 // All the above coordinates are in DIP. This is the scale factor needed
607 // to convert them to pixels.
608 IPC_STRUCT_MEMBER(float, scale_factor)
610 // The latency information for the frame. Only valid when accelerated
611 // compositing is disabled.
612 IPC_STRUCT_MEMBER(ui::LatencyInfo, latency_info)
615 IPC_STRUCT_BEGIN(ViewMsg_Navigate_Params)
616 // The page_id for this navigation, or -1 if it is a new navigation. Back,
617 // Forward, and Reload navigations should have a valid page_id. If the load
618 // succeeds, then this page_id will be reflected in the resultant
619 // ViewHostMsg_FrameNavigate message.
620 IPC_STRUCT_MEMBER(int32, page_id)
622 // If page_id is -1, then pending_history_list_offset will also be -1.
623 // Otherwise, it contains the offset into the history list corresponding to
624 // the current navigation.
625 IPC_STRUCT_MEMBER(int, pending_history_list_offset)
627 // Informs the RenderView of where its current page contents reside in
628 // session history and the total size of the session history list.
629 IPC_STRUCT_MEMBER(int, current_history_list_offset)
630 IPC_STRUCT_MEMBER(int, current_history_list_length)
632 // Informs the RenderView the session history should be cleared. In that
633 // case, the RenderView needs to notify the browser that the clearing was
634 // succesful when the navigation commits.
635 IPC_STRUCT_MEMBER(bool, should_clear_history_list)
638 IPC_STRUCT_MEMBER(GURL, url)
640 // Base URL for use in WebKit's SubstituteData.
641 // Is only used with data: URLs.
642 IPC_STRUCT_MEMBER(GURL, base_url_for_data_url)
644 // History URL for use in WebKit's SubstituteData.
645 // Is only used with data: URLs.
646 IPC_STRUCT_MEMBER(GURL, history_url_for_data_url)
648 // The URL to send in the "Referer" header field. Can be empty if there is
650 IPC_STRUCT_MEMBER(content::Referrer, referrer)
652 // Any redirect URLs that occurred before |url|. Useful for cross-process
653 // navigations; defaults to empty.
654 IPC_STRUCT_MEMBER(std::vector<GURL>, redirects)
656 // The type of transition.
657 IPC_STRUCT_MEMBER(content::PageTransition, transition)
659 // Opaque history state (received by ViewHostMsg_UpdateState).
660 IPC_STRUCT_MEMBER(content::PageState, page_state)
662 // Type of navigation.
663 IPC_STRUCT_MEMBER(ViewMsg_Navigate_Type::Value, navigation_type)
665 // The time the request was created
666 IPC_STRUCT_MEMBER(base::Time, request_time)
668 // Extra headers (separated by \n) to send during the request.
669 IPC_STRUCT_MEMBER(std::string, extra_headers)
671 // The following two members identify a previous request that has been
672 // created before this navigation is being transferred to a new render view.
673 // This serves the purpose of recycling the old request.
674 // Unless this refers to a transferred navigation, these values are -1 and -1.
675 IPC_STRUCT_MEMBER(int, transferred_request_child_id)
676 IPC_STRUCT_MEMBER(int, transferred_request_request_id)
678 // Whether or not we should allow the url to download.
679 IPC_STRUCT_MEMBER(bool, allow_download)
681 // Whether or not the user agent override string should be used.
682 IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
684 // True if this was a post request.
685 IPC_STRUCT_MEMBER(bool, is_post)
687 // If is_post is true, holds the post_data information from browser. Empty
689 IPC_STRUCT_MEMBER(std::vector<unsigned char>, browser_initiated_post_data)
691 // Whether or not this url should be allowed to access local file://
693 IPC_STRUCT_MEMBER(bool, can_load_local_resources)
695 // If not empty, which frame to navigate.
696 IPC_STRUCT_MEMBER(std::string, frame_to_navigate)
698 // The navigationStart time to expose to JS for this navigation.
699 IPC_STRUCT_MEMBER(base::TimeTicks, browser_navigation_start)
702 IPC_STRUCT_BEGIN(ViewMsg_New_Params)
703 // Renderer-wide preferences.
704 IPC_STRUCT_MEMBER(content::RendererPreferences, renderer_preferences)
706 // Preferences for this view.
707 IPC_STRUCT_MEMBER(WebPreferences, web_preferences)
709 // The ID of the view to be created.
710 IPC_STRUCT_MEMBER(int32, view_id)
712 // The ID of the main frame hosted in the view.
713 IPC_STRUCT_MEMBER(int32, main_frame_routing_id)
715 // The ID of the rendering surface.
716 IPC_STRUCT_MEMBER(int32, surface_id)
718 // The session storage namespace ID this view should use.
719 IPC_STRUCT_MEMBER(int64, session_storage_namespace_id)
721 // The name of the frame associated with this view (or empty if none).
722 IPC_STRUCT_MEMBER(string16, frame_name)
724 // The route ID of the opener RenderView if we need to set one
725 // (MSG_ROUTING_NONE otherwise).
726 IPC_STRUCT_MEMBER(int, opener_route_id)
728 // Whether the RenderView should initially be swapped out.
729 IPC_STRUCT_MEMBER(bool, swapped_out)
731 // Whether the RenderView should initially be hidden.
732 IPC_STRUCT_MEMBER(bool, hidden)
734 // The initial page ID to use for this view, which must be larger than any
735 // existing navigation that might be loaded in the view. Page IDs are unique
736 // to a view and are only updated by the renderer after this initial value.
737 IPC_STRUCT_MEMBER(int32, next_page_id)
739 // The properties of the screen associated with the view.
740 IPC_STRUCT_MEMBER(WebKit::WebScreenInfo, screen_info)
742 // The accessibility mode of the renderer.
743 IPC_STRUCT_MEMBER(AccessibilityMode, accessibility_mode)
745 // Specifies whether partially swapping composited buffers is
746 // allowed for a renderer. Partial swaps will be used if they are both
747 // allowed and supported.
748 IPC_STRUCT_MEMBER(bool, allow_partial_swap)
751 IPC_STRUCT_BEGIN(ViewMsg_PostMessage_Params)
752 // The serialized script value.
753 IPC_STRUCT_MEMBER(string16, data)
755 // When sent to the browser, this is the routing ID of the source frame in
756 // the source process. The browser replaces it with the routing ID of the
757 // equivalent (swapped out) frame in the destination process.
758 IPC_STRUCT_MEMBER(int, source_routing_id)
760 // The origin of the source frame.
761 IPC_STRUCT_MEMBER(string16, source_origin)
763 // The origin for the message's target.
764 IPC_STRUCT_MEMBER(string16, target_origin)
766 // Information about the MessagePorts this message contains.
767 IPC_STRUCT_MEMBER(std::vector<int>, message_port_ids)
768 IPC_STRUCT_MEMBER(std::vector<int>, new_routing_ids)
771 // Messages sent from the browser to the renderer.
773 // Tells the renderer to cancel an opened date/time dialog.
774 IPC_MESSAGE_ROUTED0(ViewMsg_CancelDateTimeDialog)
776 // Get all savable resource links from current webpage, include main
777 // frame and sub-frame.
778 IPC_MESSAGE_ROUTED1(ViewMsg_GetAllSavableResourceLinksForCurrentPage,
779 GURL /* url of page which is needed to save */)
781 // Get html data by serializing all frames of current page with lists
782 // which contain all resource links that have local copy.
783 IPC_MESSAGE_ROUTED3(ViewMsg_GetSerializedHtmlDataForCurrentPageWithLocalLinks,
784 std::vector<GURL> /* urls that have local copy */,
785 std::vector<base::FilePath> /* paths of local copy */,
786 base::FilePath /* local directory path */)
788 // Tells the render side that a ViewHostMsg_LockMouse message has been
789 // processed. |succeeded| indicates whether the mouse has been successfully
791 IPC_MESSAGE_ROUTED1(ViewMsg_LockMouse_ACK,
792 bool /* succeeded */)
793 // Tells the render side that the mouse has been unlocked.
794 IPC_MESSAGE_ROUTED0(ViewMsg_MouseLockLost)
796 // Screen was rotated. Dispatched to the onorientationchange javascript API.
797 IPC_MESSAGE_ROUTED1(ViewMsg_OrientationChangeEvent,
798 int /* orientation */)
800 // Sent by the browser when the parameters for vsync alignment have changed.
801 IPC_MESSAGE_ROUTED2(ViewMsg_UpdateVSyncParameters,
802 base::TimeTicks /* timebase */,
803 base::TimeDelta /* interval */)
805 // Set the top-level frame to the provided name.
806 IPC_MESSAGE_ROUTED1(ViewMsg_SetName,
807 std::string /* frame_name */)
809 // Sent to the RenderView when a new tab is swapped into an existing
810 // tab and the histories need to be merged. The existing tab has a history of
811 // |merged_history_length| which precedes the history of the new tab. All
812 // page_ids >= |minimum_page_id| in the new tab are appended to the history.
814 // For example, suppose the history of page_ids in the new tab's RenderView
815 // is [4 7 8]. This is merged into an existing tab with 3 history items, and
816 // all pages in the new tab with page_id >= 7 are to be preserved.
817 // The resulting page history is [-1 -1 -1 7 8].
818 IPC_MESSAGE_ROUTED2(ViewMsg_SetHistoryLengthAndPrune,
819 int, /* merge_history_length */
820 int32 /* minimum_page_id */)
822 // Tells the renderer the browser's notion of its process ID.
823 // Some subsystems, like LatencyInfo, require this to be known to the renderer.
824 IPC_MESSAGE_CONTROL1(ViewMsg_SetRendererProcessID,
825 base::ProcessId /* process_id */)
827 // Tells the renderer to create a new view.
828 // This message is slightly different, the view it takes (via
829 // ViewMsg_New_Params) is the view to create, the message itself is sent as a
830 // non-view control message.
831 IPC_MESSAGE_CONTROL1(ViewMsg_New,
834 // Reply in response to ViewHostMsg_ShowView or ViewHostMsg_ShowWidget.
835 // similar to the new command, but used when the renderer created a view
836 // first, and we need to update it.
837 IPC_MESSAGE_ROUTED0(ViewMsg_CreatingNew_ACK)
839 // Sends updated preferences to the renderer.
840 IPC_MESSAGE_ROUTED1(ViewMsg_SetRendererPrefs,
841 content::RendererPreferences)
843 // This passes a set of webkit preferences down to the renderer.
844 IPC_MESSAGE_ROUTED1(ViewMsg_UpdateWebPreferences,
847 // Informs the renderer that the timezone has changed.
848 IPC_MESSAGE_ROUTED0(ViewMsg_TimezoneChange)
850 // Tells the render view to close.
851 IPC_MESSAGE_ROUTED0(ViewMsg_Close)
853 IPC_STRUCT_BEGIN(ViewMsg_Resize_Params)
854 IPC_STRUCT_MEMBER(WebKit::WebScreenInfo, screen_info)
855 IPC_STRUCT_MEMBER(gfx::Size, new_size)
856 IPC_STRUCT_MEMBER(gfx::Size, physical_backing_size)
857 IPC_STRUCT_MEMBER(float, overdraw_bottom_height)
858 IPC_STRUCT_MEMBER(gfx::Rect, resizer_rect)
859 IPC_STRUCT_MEMBER(bool, is_fullscreen)
862 // Tells the render view to change its size. A ViewHostMsg_UpdateRect message
863 // is generated in response provided new_size is not empty and not equal to
864 // the view's current size. The generated ViewHostMsg_UpdateRect message will
865 // have the IS_RESIZE_ACK flag set. It also receives the resizer rect so that
866 // we don't have to fetch it every time WebKit asks for it.
867 IPC_MESSAGE_ROUTED1(ViewMsg_Resize,
868 ViewMsg_Resize_Params /* params */)
870 // Tells the render view that the resize rect has changed.
871 IPC_MESSAGE_ROUTED1(ViewMsg_ChangeResizeRect,
872 gfx::Rect /* resizer_rect */)
874 // Sent to inform the view that it was hidden. This allows it to reduce its
875 // resource utilization.
876 IPC_MESSAGE_ROUTED0(ViewMsg_WasHidden)
878 // Tells the render view that it is no longer hidden (see WasHidden), and the
879 // render view is expected to respond with a full repaint if needs_repainting
880 // is true. In that case, the generated ViewHostMsg_UpdateRect message will
881 // have the IS_RESTORE_ACK flag set. If needs_repainting is false, then this
882 // message does not trigger a message in response.
883 IPC_MESSAGE_ROUTED1(ViewMsg_WasShown,
884 bool /* needs_repainting */)
886 // Sent to inform the view that it was swapped out. This allows the process to
887 // exit if no other views are using it.
888 IPC_MESSAGE_ROUTED0(ViewMsg_WasSwappedOut)
890 // Sent to render the view into the supplied transport DIB, resize
891 // the web widget to match the |page_size|, scale it by the
892 // appropriate scale to make it fit the |desired_size|, and return
893 // it. In response to this message, the host generates a
894 // ViewHostMsg_PaintAtSize_ACK message. Note that the DIB *must* be
895 // the right size to receive an RGBA image at the |desired_size|.
896 // |tag| is sent along with ViewHostMsg_PaintAtSize_ACK unmodified to
897 // identify the PaintAtSize message the ACK belongs to.
898 IPC_MESSAGE_ROUTED4(ViewMsg_PaintAtSize,
899 TransportDIB::Handle /* dib_handle */,
901 gfx::Size /* page_size */,
902 gfx::Size /* desired_size */)
904 // Tells the render view that a ViewHostMsg_UpdateRect message was processed.
905 // This signals the render view that it can send another UpdateRect message.
906 IPC_MESSAGE_ROUTED0(ViewMsg_UpdateRect_ACK)
908 // Tells the render view that a SwapBuffers was completed. Typically,
909 // SwapBuffers requests go from renderer -> GPU process -> browser. Most
910 // platforms still use the GfxCxt3D Echo for receiving the SwapBuffers Ack.
911 // Using Echo routes the ack from browser -> GPU process -> renderer, while this
912 // Ack goes directly from browser -> renderer. This is not used for the threaded
914 IPC_MESSAGE_ROUTED0(ViewMsg_SwapBuffers_ACK)
916 // Tells the render widget that a smooth scroll completed.
917 IPC_MESSAGE_ROUTED0(ViewMsg_SyntheticGestureCompleted)
919 // Tells the renderer to focus the first (last if reverse is true) focusable
921 IPC_MESSAGE_ROUTED1(ViewMsg_SetInitialFocus,
924 // Executes custom context menu action that was provided from WebKit.
925 IPC_MESSAGE_ROUTED2(ViewMsg_CustomContextMenuAction,
926 content::CustomContextMenuContext /* custom_context */,
927 unsigned /* action */)
929 // Sent in response to a ViewHostMsg_ContextMenu to let the renderer know that
930 // the menu has been closed.
931 IPC_MESSAGE_ROUTED1(ViewMsg_ContextMenuClosed,
932 content::CustomContextMenuContext /* custom_context */)
934 // Sent to inform the renderer to invoke a context menu.
935 // The parameter specifies the location in the render view's coordinates.
936 IPC_MESSAGE_ROUTED1(ViewMsg_ShowContextMenu,
937 gfx::Point /* location where menu should be shown */)
939 // Tells the renderer to perform the specified navigation, interrupting any
940 // existing navigation.
941 IPC_MESSAGE_ROUTED1(ViewMsg_Navigate, ViewMsg_Navigate_Params)
943 IPC_MESSAGE_ROUTED0(ViewMsg_Stop)
945 // Tells the renderer to reload the current focused frame
946 IPC_MESSAGE_ROUTED0(ViewMsg_ReloadFrame)
948 // Sent when the user wants to search for a word on the page (find in page).
949 IPC_MESSAGE_ROUTED3(ViewMsg_Find,
950 int /* request_id */,
951 string16 /* search_text */,
952 WebKit::WebFindOptions)
954 // This message notifies the renderer that the user has closed the FindInPage
955 // window (and what action to take regarding the selection).
956 IPC_MESSAGE_ROUTED1(ViewMsg_StopFinding,
957 content::StopFindAction /* action */)
959 // Informs the renderer about various statistics the browser has (e.g.
960 // latency) regarding the frames that have been displayed.
961 IPC_MESSAGE_ROUTED1(ViewMsg_SetBrowserRenderingStats,
962 content::BrowserRenderingStats /* stats */)
964 // Replaces a date time input field.
965 IPC_MESSAGE_ROUTED1(ViewMsg_ReplaceDateTime,
966 ViewHostMsg_DateTimeDialogValue_Params /* value */)
968 // Copies the image at location x, y to the clipboard (if there indeed is an
969 // image at that location).
970 IPC_MESSAGE_ROUTED2(ViewMsg_CopyImageAt,
974 // Tells the renderer to perform the given action on the media player
975 // located at the given point.
976 IPC_MESSAGE_ROUTED2(ViewMsg_MediaPlayerActionAt,
977 gfx::Point, /* location */
978 WebKit::WebMediaPlayerAction)
980 // Tells the renderer to perform the given action on the plugin located at
982 IPC_MESSAGE_ROUTED2(ViewMsg_PluginActionAt,
983 gfx::Point, /* location */
984 WebKit::WebPluginAction)
986 // Request for the renderer to evaluate an xpath to a frame and execute a
987 // javascript: url in that frame's context. The message is completely
988 // asynchronous and no corresponding response message is sent back.
990 // frame_xpath contains the modified xpath notation to identify an inner
991 // subframe (starting from the root frame). It is a concatenation of
992 // number of smaller xpaths delimited by '\n'. Each chunk in the string can
993 // be evaluated to a frame in its parent-frame's context.
995 // Example: /html/body/iframe/\n/html/body/div/iframe/\n/frameset/frame[0]
996 // can be broken into 3 xpaths
997 // /html/body/iframe evaluates to an iframe within the root frame
998 // /html/body/div/iframe evaluates to an iframe within the level-1 iframe
999 // /frameset/frame[0] evaluates to first frame within the level-2 iframe
1001 // jscript_url is the string containing the javascript: url to be executed
1002 // in the target frame's context. The string should start with "javascript:"
1003 // and continue with a valid JS text.
1005 // If the fourth parameter is true the result is sent back to the renderer
1006 // using the message ViewHostMsg_ScriptEvalResponse.
1007 // ViewHostMsg_ScriptEvalResponse is passed the ID parameter so that the
1008 // client can uniquely identify the request.
1009 IPC_MESSAGE_ROUTED4(ViewMsg_ScriptEvalRequest,
1010 string16, /* frame_xpath */
1011 string16, /* jscript_url */
1013 bool /* If true, result is sent back. */)
1015 // Posts a message from a frame in another process to the current renderer.
1016 IPC_MESSAGE_ROUTED1(ViewMsg_PostMessageEvent,
1017 ViewMsg_PostMessage_Params)
1019 // Requests that the RenderView's main frame sets its opener to null.
1020 IPC_MESSAGE_ROUTED0(ViewMsg_DisownOpener)
1022 // Request for the renderer to evaluate an xpath to a frame and insert css
1023 // into that frame's document. See ViewMsg_ScriptEvalRequest for details on
1024 // allowed xpath expressions.
1025 IPC_MESSAGE_ROUTED2(ViewMsg_CSSInsertRequest,
1026 string16, /* frame_xpath */
1027 std::string /* css string */)
1029 // Change the zoom level for the current main frame. If the level actually
1030 // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
1031 // telling it what url got zoomed and what its current zoom level is.
1032 IPC_MESSAGE_ROUTED1(ViewMsg_Zoom,
1033 content::PageZoom /* function */)
1035 // Set the zoom level for the current main frame. If the level actually
1036 // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
1037 // telling it what url got zoomed and what its current zoom level is.
1038 IPC_MESSAGE_ROUTED1(ViewMsg_SetZoomLevel,
1039 double /* zoom_level */)
1041 // Zooms the page by the factor defined in the renderer.
1042 IPC_MESSAGE_ROUTED3(ViewMsg_ZoomFactor,
1044 int /* zoom center_x */,
1045 int /* zoom center_y */)
1047 // Set the zoom level for a particular url that the renderer is in the
1048 // process of loading. This will be stored, to be used if the load commits
1049 // and ignored otherwise.
1050 IPC_MESSAGE_ROUTED2(ViewMsg_SetZoomLevelForLoadingURL,
1052 double /* zoom_level */)
1054 // Set the zoom level for a particular url, so all render views
1055 // displaying this url can update their zoom levels to match.
1056 // If scheme is empty, then only host is used for matching.
1057 IPC_MESSAGE_CONTROL3(ViewMsg_SetZoomLevelForCurrentURL,
1058 std::string /* scheme */,
1059 std::string /* host */,
1060 double /* zoom_level */)
1062 // Change encoding of page in the renderer.
1063 IPC_MESSAGE_ROUTED1(ViewMsg_SetPageEncoding,
1064 std::string /*new encoding name*/)
1066 // Reset encoding of page in the renderer back to default.
1067 IPC_MESSAGE_ROUTED0(ViewMsg_ResetPageEncodingToDefault)
1069 // Used to tell a render view whether it should expose various bindings
1070 // that allow JS content extended privileges. See BindingsPolicy for valid
1072 IPC_MESSAGE_ROUTED1(ViewMsg_AllowBindings,
1073 int /* enabled_bindings_flags */)
1075 // Tell the renderer to add a property to the WebUI binding object. This
1076 // only works if we allowed WebUI bindings.
1077 IPC_MESSAGE_ROUTED2(ViewMsg_SetWebUIProperty,
1078 std::string /* property_name */,
1079 std::string /* property_value_json */)
1081 // This message starts/stop monitoring the input method status of the focused
1082 // edit control of a renderer process.
1084 // * is_active (bool)
1085 // Indicates if an input method is active in the browser process.
1086 // The possible actions when a renderer process receives this message are
1089 // true Start sending IPC message ViewHostMsg_ImeUpdateTextInputState
1090 // to notify the input method status of the focused edit control.
1091 // false Stop sending IPC message ViewHostMsg_ImeUpdateTextInputState.
1092 IPC_MESSAGE_ROUTED1(ViewMsg_SetInputMethodActive,
1093 bool /* is_active */)
1095 // This message sends a string being composed with an input method.
1096 IPC_MESSAGE_ROUTED4(
1097 ViewMsg_ImeSetComposition,
1098 string16, /* text */
1099 std::vector<WebKit::WebCompositionUnderline>, /* underlines */
1100 int, /* selectiont_start */
1101 int /* selection_end */)
1103 // This message confirms an ongoing composition.
1104 IPC_MESSAGE_ROUTED3(ViewMsg_ImeConfirmComposition,
1105 string16 /* text */,
1106 gfx::Range /* replacement_range */,
1107 bool /* keep_selection */)
1109 // Sets the text composition to be between the given start and end offsets
1110 // in the currently focused editable field.
1111 IPC_MESSAGE_ROUTED3(ViewMsg_SetCompositionFromExistingText,
1114 std::vector<WebKit::WebCompositionUnderline> /* underlines */)
1116 // Selects between the given start and end offsets in the currently focused
1118 IPC_MESSAGE_ROUTED2(ViewMsg_SetEditableSelectionOffsets,
1122 // Deletes the current selection plus the specified number of characters before
1123 // and after the selection or caret.
1124 IPC_MESSAGE_ROUTED2(ViewMsg_ExtendSelectionAndDelete,
1128 // Used to notify the render-view that we have received a target URL. Used
1129 // to prevent target URLs spamming the browser.
1130 IPC_MESSAGE_ROUTED0(ViewMsg_UpdateTargetURL_ACK)
1133 // Sets the alternate error page URL (link doctor) for the renderer process.
1134 IPC_MESSAGE_ROUTED1(ViewMsg_SetAltErrorPageURL,
1137 // Notifies the color chooser client that the user selected a color.
1138 IPC_MESSAGE_ROUTED2(ViewMsg_DidChooseColorResponse, unsigned, SkColor)
1140 // Notifies the color chooser client that the color chooser has ended.
1141 IPC_MESSAGE_ROUTED1(ViewMsg_DidEndColorChooser, unsigned)
1143 IPC_MESSAGE_ROUTED1(ViewMsg_RunFileChooserResponse,
1144 std::vector<ui::SelectedFileInfo>)
1146 // Provides the results of directory enumeration.
1147 IPC_MESSAGE_ROUTED2(ViewMsg_EnumerateDirectoryResponse,
1148 int /* request_id */,
1149 std::vector<base::FilePath> /* files_in_directory */)
1151 // When a renderer sends a ViewHostMsg_Focus to the browser process,
1152 // the browser has the option of sending a ViewMsg_CantFocus back to
1154 IPC_MESSAGE_ROUTED0(ViewMsg_CantFocus)
1156 // Instructs the renderer to invoke the frame's shouldClose method, which
1157 // runs the onbeforeunload event handler. Expects the result to be returned
1158 // via ViewHostMsg_ShouldClose.
1159 IPC_MESSAGE_ROUTED0(ViewMsg_ShouldClose)
1161 // Instructs the renderer to swap out for a cross-site transition, including
1162 // running the unload event handler. Expects a SwapOut_ACK message when
1164 IPC_MESSAGE_ROUTED0(ViewMsg_SwapOut)
1166 // Instructs the renderer to close the current page, including running the
1167 // onunload event handler.
1169 // Expects a ClosePage_ACK message when finished.
1170 IPC_MESSAGE_ROUTED0(ViewMsg_ClosePage)
1172 // Notifies the renderer about ui theme changes
1173 IPC_MESSAGE_ROUTED0(ViewMsg_ThemeChanged)
1175 // Notifies the renderer that a paint is to be generated for the rectangle
1177 IPC_MESSAGE_ROUTED1(ViewMsg_Repaint,
1178 gfx::Size /* The view size to be repainted */)
1180 // Notification that a move or resize renderer's containing window has
1182 IPC_MESSAGE_ROUTED0(ViewMsg_MoveOrResizeStarted)
1184 IPC_MESSAGE_ROUTED2(ViewMsg_UpdateScreenRects,
1185 gfx::Rect /* view_screen_rect */,
1186 gfx::Rect /* window_screen_rect */)
1188 // Reply to ViewHostMsg_RequestMove, ViewHostMsg_ShowView, and
1189 // ViewHostMsg_ShowWidget to inform the renderer that the browser has
1190 // processed the move. The browser may have ignored the move, but it finished
1191 // processing. This is used because the renderer keeps a temporary cache of
1192 // the widget position while these asynchronous operations are in progress.
1193 IPC_MESSAGE_ROUTED0(ViewMsg_Move_ACK)
1195 // Used to instruct the RenderView to send back updates to the preferred size.
1196 IPC_MESSAGE_ROUTED0(ViewMsg_EnablePreferredSizeChangedMode)
1198 // Used to instruct the RenderView to automatically resize and send back
1199 // updates for the new size.
1200 IPC_MESSAGE_ROUTED2(ViewMsg_EnableAutoResize,
1201 gfx::Size /* min_size */,
1202 gfx::Size /* max_size */)
1204 // Used to instruct the RenderView to disalbe automatically resize.
1205 IPC_MESSAGE_ROUTED1(ViewMsg_DisableAutoResize,
1206 gfx::Size /* new_size */)
1208 // Changes the text direction of the currently selected input field (if any).
1209 IPC_MESSAGE_ROUTED1(ViewMsg_SetTextDirection,
1210 WebKit::WebTextDirection /* direction */)
1212 // Tells the renderer to clear the focused node (if any).
1213 IPC_MESSAGE_ROUTED0(ViewMsg_ClearFocusedNode)
1215 // Make the RenderView transparent and render it onto a custom background. The
1216 // background will be tiled in both directions if it is not large enough.
1217 IPC_MESSAGE_ROUTED1(ViewMsg_SetBackground,
1218 SkBitmap /* background */)
1220 // Used to tell the renderer not to add scrollbars with height and
1221 // width below a threshold.
1222 IPC_MESSAGE_ROUTED1(ViewMsg_DisableScrollbarsForSmallWindows,
1223 gfx::Size /* disable_scrollbar_size_limit */)
1225 // Activate/deactivate the RenderView (i.e., set its controls' tint
1226 // accordingly, etc.).
1227 IPC_MESSAGE_ROUTED1(ViewMsg_SetActive,
1230 // Response message to ViewHostMsg_CreateShared/DedicatedWorker.
1231 // Sent when the worker has started.
1232 IPC_MESSAGE_ROUTED0(ViewMsg_WorkerCreated)
1234 // The response to ViewHostMsg_AsyncOpenPepperFile.
1235 IPC_MESSAGE_ROUTED2(ViewMsg_AsyncOpenPepperFile_ACK,
1236 base::PlatformFileError /* error_code */,
1237 IPC::PlatformFileForTransit /* file descriptor */)
1239 // Tells the renderer that the network state has changed and that
1240 // window.navigator.onLine should be updated for all WebViews.
1241 IPC_MESSAGE_CONTROL1(ViewMsg_NetworkStateChanged,
1244 // Reply to ViewHostMsg_OpenChannelToPpapiBroker
1245 // Tells the renderer that the channel to the broker has been created.
1246 IPC_MESSAGE_ROUTED2(ViewMsg_PpapiBrokerChannelCreated,
1247 base::ProcessId /* broker_pid */,
1248 IPC::ChannelHandle /* handle */)
1250 // Reply to ViewHostMsg_RequestPpapiBrokerPermission.
1251 // Tells the renderer whether permission to access to PPAPI broker was granted
1253 IPC_MESSAGE_ROUTED1(ViewMsg_PpapiBrokerPermissionResult,
1256 // Tells the renderer to empty its plugin list cache, optional reloading
1257 // pages containing plugins.
1258 IPC_MESSAGE_CONTROL1(ViewMsg_PurgePluginListCache,
1259 bool /* reload_pages */)
1261 // Used to instruct the RenderView to go into "view source" mode.
1262 IPC_MESSAGE_ROUTED0(ViewMsg_EnableViewSourceMode)
1264 // Instructs the renderer to save the current page to MHTML.
1265 IPC_MESSAGE_ROUTED2(ViewMsg_SavePageAsMHTML,
1267 IPC::PlatformFileForTransit /* file handle */)
1269 // Temporary message to diagnose an unexpected condition in WebContentsImpl.
1270 IPC_MESSAGE_CONTROL1(ViewMsg_TempCrashWithData,
1273 // Change the accessibility mode in the renderer process.
1274 IPC_MESSAGE_ROUTED1(ViewMsg_SetAccessibilityMode,
1277 // An acknowledge to ViewHostMsg_MultipleTargetsTouched to notify the renderer
1278 // process to release the magnified image.
1279 IPC_MESSAGE_ROUTED1(ViewMsg_ReleaseDisambiguationPopupDIB,
1280 TransportDIB::Handle /* DIB handle */)
1282 // Notifies the renderer that a snapshot has been retrieved.
1283 IPC_MESSAGE_ROUTED3(ViewMsg_WindowSnapshotCompleted,
1284 int /* snapshot_id */,
1285 gfx::Size /* size */,
1286 std::vector<unsigned char> /* png */)
1288 // Tells the renderer to suspend/resume the webkit timers.
1289 IPC_MESSAGE_CONTROL1(ViewMsg_SetWebKitSharedTimersSuspended,
1292 #if defined(OS_ANDROID)
1293 // Sent when the browser wants the bounding boxes of the current find matches.
1295 // If match rects are already cached on the browser side, |current_version|
1296 // should be the version number from the ViewHostMsg_FindMatchRects_Reply
1297 // they came in, so the renderer can tell if it needs to send updated rects.
1298 // Otherwise just pass -1 to always receive the list of rects.
1300 // There must be an active search string (it is probably most useful to call
1301 // this immediately after a ViewHostMsg_Find_Reply message arrives with
1302 // final_update set to true).
1303 IPC_MESSAGE_ROUTED1(ViewMsg_FindMatchRects,
1304 int /* current_version */)
1306 // External popup menus.
1307 IPC_MESSAGE_ROUTED2(ViewMsg_SelectPopupMenuItems,
1308 bool /* user canceled the popup */,
1309 std::vector<int> /* selected indices */)
1311 // Tells the renderer to try to revert to the zoom level we were at before
1312 // ViewMsg_ScrollFocusedEditableNodeIntoView was called.
1313 IPC_MESSAGE_ROUTED0(ViewMsg_UndoScrollFocusedEditableNodeIntoView)
1315 // Notifies the renderer whether hiding/showing the top controls is enabled
1316 // and whether or not to animate to the proper state.
1317 IPC_MESSAGE_ROUTED3(ViewMsg_UpdateTopControlsState,
1318 bool /* enable_hiding */,
1319 bool /* enable_showing */,
1322 IPC_MESSAGE_ROUTED0(ViewMsg_ShowImeIfNeeded)
1324 // Sent by the browser when the renderer should generate a new frame.
1325 IPC_MESSAGE_ROUTED1(ViewMsg_BeginFrame,
1326 cc::BeginFrameArgs /* args */)
1328 // Sent by the browser when an IME update that requires acknowledgement has been
1329 // processed on the browser side.
1330 IPC_MESSAGE_ROUTED0(ViewMsg_ImeEventAck)
1332 // Sent by the browser when we should pause video playback.
1333 IPC_MESSAGE_ROUTED0(ViewMsg_PauseVideo);
1335 #elif defined(OS_MACOSX)
1336 // Let the RenderView know its window has changed visibility.
1337 IPC_MESSAGE_ROUTED1(ViewMsg_SetWindowVisibility,
1338 bool /* visibile */)
1340 // Let the RenderView know its window's frame has changed.
1341 IPC_MESSAGE_ROUTED2(ViewMsg_WindowFrameChanged,
1342 gfx::Rect /* window frame */,
1343 gfx::Rect /* content view frame */)
1345 // Message sent from the browser to the renderer when the user starts or stops
1346 // resizing the view.
1347 IPC_MESSAGE_ROUTED1(ViewMsg_SetInLiveResize,
1350 // Tell the renderer that plugin IME has completed.
1351 IPC_MESSAGE_ROUTED2(ViewMsg_PluginImeCompositionCompleted,
1352 string16 /* text */,
1353 int /* plugin_id */)
1355 // External popup menus.
1356 IPC_MESSAGE_ROUTED1(ViewMsg_SelectPopupMenuItem,
1357 int /* selected index, -1 means no selection */)
1360 // Sent by the browser as a reply to ViewHostMsg_SwapCompositorFrame.
1361 IPC_MESSAGE_ROUTED2(ViewMsg_SwapCompositorFrameAck,
1362 uint32 /* output_surface_id */,
1363 cc::CompositorFrameAck /* ack */)
1365 // Sent by browser to tell renderer compositor that some resources that were
1366 // given to the browser in a swap are not being used anymore.
1367 IPC_MESSAGE_ROUTED2(ViewMsg_ReclaimCompositorResources,
1368 uint32 /* output_surface_id */,
1369 cc::CompositorFrameAck /* ack */)
1371 // Sent by the browser to ask the renderer for a snapshot of the current view.
1372 IPC_MESSAGE_ROUTED1(ViewMsg_Snapshot,
1373 gfx::Rect /* src_subrect */)
1375 // -----------------------------------------------------------------------------
1376 // Messages sent from the renderer to the browser.
1378 // Sent by the renderer when it is creating a new window. The browser creates
1379 // a tab for it and responds with a ViewMsg_CreatingNew_ACK. If route_id is
1380 // MSG_ROUTING_NONE, the view couldn't be created.
1381 IPC_SYNC_MESSAGE_CONTROL1_4(ViewHostMsg_CreateWindow,
1382 ViewHostMsg_CreateWindow_Params,
1384 int /* main_frame_route_id */,
1385 int32 /* surface_id */,
1386 int64 /* cloned_session_storage_namespace_id */)
1388 // Similar to ViewHostMsg_CreateWindow, except used for sub-widgets, like
1389 // <select> dropdowns. This message is sent to the WebContentsImpl that
1390 // contains the widget being created.
1391 IPC_SYNC_MESSAGE_CONTROL2_2(ViewHostMsg_CreateWidget,
1392 int /* opener_id */,
1393 WebKit::WebPopupType /* popup type */,
1395 int32 /* surface_id */)
1397 // Similar to ViewHostMsg_CreateWidget except the widget is a full screen
1399 IPC_SYNC_MESSAGE_CONTROL1_2(ViewHostMsg_CreateFullscreenWidget,
1400 int /* opener_id */,
1402 int32 /* surface_id */)
1404 // Asks the browser for a unique routing ID.
1405 IPC_SYNC_MESSAGE_CONTROL0_1(ViewHostMsg_GenerateRoutingID,
1406 int /* routing_id */)
1408 // Asks the browser for the default audio hardware configuration.
1409 IPC_SYNC_MESSAGE_CONTROL0_2(ViewHostMsg_GetAudioHardwareConfig,
1410 media::AudioParameters /* input parameters */,
1411 media::AudioParameters /* output parameters */)
1413 // Asks the browser for CPU usage of the renderer process in percents.
1414 IPC_SYNC_MESSAGE_CONTROL0_1(ViewHostMsg_GetCPUUsage,
1415 int /* CPU usage in percents */)
1417 // Asks the browser for the user's monitor profile.
1418 IPC_SYNC_MESSAGE_CONTROL0_1(ViewHostMsg_GetMonitorColorProfile,
1419 std::vector<char> /* profile */)
1421 // Asks the browser for the renderer process memory size stats.
1422 IPC_SYNC_MESSAGE_CONTROL0_2(ViewHostMsg_GetProcessMemorySizes,
1423 size_t /* private_bytes */,
1424 size_t /* shared_bytes */)
1426 // These three messages are sent to the parent RenderViewHost to display the
1427 // page/widget that was created by
1428 // CreateWindow/CreateWidget/CreateFullscreenWidget. routing_id
1429 // refers to the id that was returned from the Create message above.
1430 // The initial_position parameter is a rectangle in screen coordinates.
1432 // FUTURE: there will probably be flags here to control if the result is
1434 IPC_MESSAGE_ROUTED4(ViewHostMsg_ShowView,
1436 WindowOpenDisposition /* disposition */,
1437 gfx::Rect /* initial_pos */,
1438 bool /* opened_by_user_gesture */)
1440 IPC_MESSAGE_ROUTED2(ViewHostMsg_ShowWidget,
1442 gfx::Rect /* initial_pos */)
1444 // Message to show a full screen widget.
1445 IPC_MESSAGE_ROUTED1(ViewHostMsg_ShowFullscreenWidget,
1448 // This message is sent after ViewHostMsg_ShowView to cause the RenderView
1449 // to run in a modal fashion until it is closed.
1450 IPC_SYNC_MESSAGE_ROUTED1_0(ViewHostMsg_RunModal,
1451 int /* opener_id */)
1453 // Indicates the renderer is ready in response to a ViewMsg_New or
1454 // a ViewMsg_CreatingNew_ACK.
1455 IPC_MESSAGE_ROUTED0(ViewHostMsg_RenderViewReady)
1457 // Indicates the renderer process is gone. This actually is sent by the
1458 // browser process to itself, but keeps the interface cleaner.
1459 IPC_MESSAGE_ROUTED2(ViewHostMsg_RenderProcessGone,
1460 int, /* this really is base::TerminationStatus */
1461 int /* exit_code */)
1463 // Sent by the renderer process to request that the browser close the view.
1464 // This corresponds to the window.close() API, and the browser may ignore
1465 // this message. Otherwise, the browser will generates a ViewMsg_Close
1466 // message to close the view.
1467 IPC_MESSAGE_ROUTED0(ViewHostMsg_Close)
1469 // Send in response to a ViewMsg_UpdateScreenRects so that the renderer can
1470 // throttle these messages.
1471 IPC_MESSAGE_ROUTED0(ViewHostMsg_UpdateScreenRects_ACK)
1473 // Sent by the renderer process to request that the browser move the view.
1474 // This corresponds to the window.resizeTo() and window.moveTo() APIs, and
1475 // the browser may ignore this message.
1476 IPC_MESSAGE_ROUTED1(ViewHostMsg_RequestMove,
1477 gfx::Rect /* position */)
1479 // Notifies the browser that a frame in the view has changed. This message
1480 // has a lot of parameters and is packed/unpacked by functions defined in
1481 // render_messages.h.
1482 IPC_MESSAGE_ROUTED1(ViewHostMsg_FrameNavigate,
1483 ViewHostMsg_FrameNavigate_Params)
1485 // Used to tell the parent that the user right clicked on an area of the
1486 // content area, and a context menu should be shown for it. The params
1487 // object contains information about the node(s) that were selected when the
1488 // user right clicked.
1489 IPC_MESSAGE_ROUTED1(ViewHostMsg_ContextMenu, content::ContextMenuParams)
1491 // Message to show a popup menu using native cocoa controls (Mac only).
1492 IPC_MESSAGE_ROUTED1(ViewHostMsg_ShowPopup,
1493 ViewHostMsg_ShowPopup_Params)
1495 // Response from ViewMsg_ScriptEvalRequest. The ID is the parameter supplied
1496 // to ViewMsg_ScriptEvalRequest. The result has the value returned by the
1497 // script as its only element, one of Null, Boolean, Integer, Real, Date, or
1499 IPC_MESSAGE_ROUTED2(ViewHostMsg_ScriptEvalResponse,
1501 base::ListValue /* result */)
1503 // Result of string search in the page.
1504 // Response to ViewMsg_Find with the results of the requested find-in-page
1505 // search, the number of matches found and the selection rect (in screen
1506 // coordinates) for the string found. If |final_update| is false, it signals
1507 // that this is not the last Find_Reply message - more will be sent as the
1508 // scoping effort continues.
1509 IPC_MESSAGE_ROUTED5(ViewHostMsg_Find_Reply,
1510 int /* request_id */,
1511 int /* number of matches */,
1512 gfx::Rect /* selection_rect */,
1513 int /* active_match_ordinal */,
1514 bool /* final_update */)
1516 // Provides the result from running OnMsgShouldClose. |proceed| matches the
1517 // return value of the the frame's shouldClose method (which includes the
1518 // onbeforeunload handler): true if the user decided to proceed with leaving
1520 IPC_MESSAGE_ROUTED3(ViewHostMsg_ShouldClose_ACK,
1522 base::TimeTicks /* before_unload_start_time */,
1523 base::TimeTicks /* before_unload_end_time */)
1525 // Indicates that the current renderer has swapped out, after a SwapOut
1527 IPC_MESSAGE_ROUTED0(ViewHostMsg_SwapOut_ACK)
1529 // Indicates that the current page has been closed, after a ClosePage
1531 IPC_MESSAGE_ROUTED0(ViewHostMsg_ClosePage_ACK)
1533 // Notifies the browser that media has started/stopped playing.
1534 IPC_MESSAGE_ROUTED4(ViewHostMsg_MediaNotification,
1535 int64 /* player_cookie, distinguishes instances */,
1536 bool /* has_video */,
1537 bool /* has_audio */,
1538 bool /* is_playing */)
1540 // Notifies the browser that we have session history information.
1541 // page_id: unique ID that allows us to distinguish between history entries.
1542 IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateState,
1543 int32 /* page_id */,
1544 content::PageState /* state */)
1546 // Notifies the browser that a document has been loaded in a frame.
1547 IPC_MESSAGE_ROUTED1(ViewHostMsg_DocumentLoadedInFrame,
1548 int64 /* frame_id */)
1550 // Notifies the browser that a frame finished loading.
1551 IPC_MESSAGE_ROUTED3(ViewHostMsg_DidFinishLoad,
1552 int64 /* frame_id */,
1553 GURL /* validated_url */,
1554 bool /* is_main_frame */)
1556 // Changes the title for the page in the UI when the page is navigated or the
1558 IPC_MESSAGE_ROUTED3(ViewHostMsg_UpdateTitle,
1559 int32 /* page_id */,
1560 string16 /* title */,
1561 WebKit::WebTextDirection /* title direction */)
1563 // Change the encoding name of the page in UI when the page has detected
1564 // proper encoding name.
1565 IPC_MESSAGE_ROUTED1(ViewHostMsg_UpdateEncoding,
1566 std::string /* new encoding name */)
1568 // Notifies the browser that we want to show a destination url for a potential
1569 // action (e.g. when the user is hovering over a link).
1570 IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateTargetURL,
1574 // Sent when the renderer starts loading the page. This corresponds to
1575 // WebKit's notion of the throbber starting. Note that sometimes you may get
1576 // duplicates of these during a single load.
1577 IPC_MESSAGE_ROUTED0(ViewHostMsg_DidStartLoading)
1579 // Sent when the renderer is done loading a page. This corresponds to WebKit's
1580 // notion of the throbber stopping.
1581 IPC_MESSAGE_ROUTED0(ViewHostMsg_DidStopLoading)
1583 // Sent when the renderer main frame has made progress loading.
1584 IPC_MESSAGE_ROUTED1(ViewHostMsg_DidChangeLoadProgress,
1585 double /* load_progress */)
1587 // Sent when the renderer main frame sets its opener to null, disowning it for
1588 // the lifetime of the window.
1589 IPC_MESSAGE_ROUTED0(ViewHostMsg_DidDisownOpener)
1591 // Sent when the document element is available for the top-level frame. This
1592 // happens after the page starts loading, but before all resources are
1594 IPC_MESSAGE_ROUTED0(ViewHostMsg_DocumentAvailableInMainFrame)
1596 // Sent when after the onload handler has been invoked for the document
1597 // in the top-level frame.
1598 IPC_MESSAGE_ROUTED1(ViewHostMsg_DocumentOnLoadCompletedInMainFrame,
1599 int32 /* page_id */)
1601 // Sent when the renderer loads a resource from its memory cache.
1602 // The security info is non empty if the resource was originally loaded over
1603 // a secure connection.
1604 // Note: May only be sent once per URL per frame per committed load.
1605 IPC_MESSAGE_ROUTED5(ViewHostMsg_DidLoadResourceFromMemoryCache,
1607 std::string /* security info */,
1608 std::string /* http method */,
1609 std::string /* mime type */,
1610 ResourceType::Type /* resource type */)
1612 // Sent when the renderer displays insecure content in a secure page.
1613 IPC_MESSAGE_ROUTED0(ViewHostMsg_DidDisplayInsecureContent)
1615 // Sent when the renderer runs insecure content in a secure origin.
1616 IPC_MESSAGE_ROUTED2(ViewHostMsg_DidRunInsecureContent,
1617 std::string /* security_origin */,
1618 GURL /* target URL */)
1620 IPC_MESSAGE_ROUTED5(ViewHostMsg_DidFailLoadWithError,
1621 int64 /* frame_id */,
1622 GURL /* validated_url */,
1623 bool /* is_main_frame */,
1624 int /* error_code */,
1625 string16 /* error_description */)
1627 // Sent when the renderer fails a provisional load with an error.
1628 IPC_MESSAGE_ROUTED1(ViewHostMsg_DidFailProvisionalLoadWithError,
1629 ViewHostMsg_DidFailProvisionalLoadWithError_Params)
1631 // Tells the render view that a ViewHostMsg_PaintAtSize message was
1632 // processed, and the DIB is ready for use. |tag| has the same value that
1633 // the tag sent along with ViewMsg_PaintAtSize.
1634 IPC_MESSAGE_ROUTED2(ViewHostMsg_PaintAtSize_ACK,
1636 gfx::Size /* size */)
1638 // Sent to update part of the view. In response to this message, the host
1639 // generates a ViewMsg_UpdateRect_ACK message.
1640 IPC_MESSAGE_ROUTED1(ViewHostMsg_UpdateRect,
1641 ViewHostMsg_UpdateRect_Params)
1643 // Sent to unblock the browser's UI thread if it is waiting on an UpdateRect,
1644 // which may get delayed until the browser's UI unblocks.
1645 IPC_MESSAGE_ROUTED0(ViewHostMsg_UpdateIsDelayed)
1647 // Sent by the renderer when accelerated compositing is enabled or disabled to
1648 // notify the browser whether or not is should do painting.
1649 IPC_MESSAGE_ROUTED1(ViewHostMsg_DidActivateAcceleratedCompositing,
1650 bool /* true if the accelerated compositor is actve */)
1652 IPC_STRUCT_BEGIN(ViewHostMsg_BeginSmoothScroll_Params)
1653 IPC_STRUCT_MEMBER(bool, scroll_down)
1654 IPC_STRUCT_MEMBER(int32, pixels_to_scroll)
1655 IPC_STRUCT_MEMBER(int32, mouse_event_x)
1656 IPC_STRUCT_MEMBER(int32, mouse_event_y)
1659 IPC_MESSAGE_ROUTED1(ViewHostMsg_BeginSmoothScroll,
1660 ViewHostMsg_BeginSmoothScroll_Params /* params */)
1662 IPC_STRUCT_BEGIN(ViewHostMsg_BeginPinch_Params)
1663 IPC_STRUCT_MEMBER(bool, zoom_in)
1664 IPC_STRUCT_MEMBER(int32, pixels_to_move)
1665 IPC_STRUCT_MEMBER(int32, anchor_x)
1666 IPC_STRUCT_MEMBER(int32, anchor_y)
1669 IPC_MESSAGE_ROUTED1(ViewHostMsg_BeginPinch,
1670 ViewHostMsg_BeginPinch_Params /* params */)
1672 IPC_MESSAGE_ROUTED0(ViewHostMsg_Focus)
1673 IPC_MESSAGE_ROUTED0(ViewHostMsg_Blur)
1675 // Message sent from renderer to the browser when focus changes inside the
1676 // webpage. The parameter says whether the newly focused element needs
1677 // keyboard input (true for textfields, text areas and content editable divs).
1678 IPC_MESSAGE_ROUTED1(ViewHostMsg_FocusedNodeChanged,
1679 bool /* is_editable_node */)
1681 IPC_MESSAGE_ROUTED1(ViewHostMsg_SetCursor,
1684 // Used to set a cookie. The cookie is set asynchronously, but will be
1685 // available to a subsequent ViewHostMsg_GetCookies request.
1686 IPC_MESSAGE_ROUTED3(ViewHostMsg_SetCookie,
1688 GURL /* first_party_for_cookies */,
1689 std::string /* cookie */)
1691 // Used to get cookies for the given URL. This may block waiting for a
1692 // previous SetCookie message to be processed.
1693 IPC_SYNC_MESSAGE_ROUTED2_1(ViewHostMsg_GetCookies,
1695 GURL /* first_party_for_cookies */,
1696 std::string /* cookies */)
1698 // Used to get raw cookie information for the given URL. This may block
1699 // waiting for a previous SetCookie message to be processed.
1700 IPC_SYNC_MESSAGE_CONTROL2_1(ViewHostMsg_GetRawCookies,
1702 GURL /* first_party_for_cookies */,
1703 std::vector<content::CookieData>
1706 // Used to delete cookie for the given URL and name
1707 IPC_SYNC_MESSAGE_CONTROL2_0(ViewHostMsg_DeleteCookie,
1709 std::string /* cookie_name */)
1711 // Used to check if cookies are enabled for the given URL. This may block
1712 // waiting for a previous SetCookie message to be processed.
1713 IPC_SYNC_MESSAGE_CONTROL2_1(ViewHostMsg_CookiesEnabled,
1715 GURL /* first_party_for_cookies */,
1716 bool /* cookies_enabled */)
1718 // Used to get the list of plugins
1719 IPC_SYNC_MESSAGE_CONTROL1_1(ViewHostMsg_GetPlugins,
1721 std::vector<content::WebPluginInfo> /* plugins */)
1723 // Return information about a plugin for the given URL and MIME
1724 // type. If there is no matching plugin, |found| is false.
1725 // |actual_mime_type| is the actual mime type supported by the
1727 IPC_SYNC_MESSAGE_CONTROL4_3(ViewHostMsg_GetPluginInfo,
1728 int /* routing_id */,
1730 GURL /* page_url */,
1731 std::string /* mime_type */,
1733 content::WebPluginInfo /* plugin info */,
1734 std::string /* actual_mime_type */)
1736 // A renderer sends this to the browser process when it wants to
1737 // create a plugin. The browser will create the plugin process if
1738 // necessary, and will return a handle to the channel on success.
1739 // On error an empty string is returned.
1740 IPC_SYNC_MESSAGE_CONTROL4_2(ViewHostMsg_OpenChannelToPlugin,
1741 int /* routing_id */,
1743 GURL /* page_url */,
1744 std::string /* mime_type */,
1745 IPC::ChannelHandle /* channel_handle */,
1746 content::WebPluginInfo /* info */)
1749 IPC_MESSAGE_ROUTED1(ViewHostMsg_WindowlessPluginDummyWindowCreated,
1750 gfx::NativeViewId /* dummy_activation_window */)
1752 IPC_MESSAGE_ROUTED1(ViewHostMsg_WindowlessPluginDummyWindowDestroyed,
1753 gfx::NativeViewId /* dummy_activation_window */)
1756 // Get the list of proxies to use for |url|, as a semicolon delimited list
1757 // of "<TYPE> <HOST>:<PORT>" | "DIRECT".
1758 IPC_SYNC_MESSAGE_CONTROL1_2(ViewHostMsg_ResolveProxy,
1761 std::string /* proxy list */)
1763 // A renderer sends this to the browser process when it wants to create a
1764 // worker. The browser will create the worker process if necessary, and
1765 // will return the route id on success. On error returns MSG_ROUTING_NONE.
1766 IPC_SYNC_MESSAGE_CONTROL1_1(ViewHostMsg_CreateWorker,
1767 ViewHostMsg_CreateWorker_Params,
1770 // This message is sent to the browser to see if an instance of this shared
1771 // worker already exists. If so, it returns exists == true. If a
1772 // non-empty name is passed, also validates that the url matches the url of
1773 // the existing worker. If a matching worker is found, the passed-in
1774 // document_id is associated with that worker, to ensure that the worker
1775 // stays alive until the document is detached.
1776 // The route_id returned can be used to forward messages to the worker via
1777 // ForwardToWorker if it exists, otherwise it should be passed in to any
1778 // future call to CreateWorker to avoid creating duplicate workers.
1779 IPC_SYNC_MESSAGE_CONTROL1_3(ViewHostMsg_LookupSharedWorker,
1780 ViewHostMsg_CreateWorker_Params,
1783 bool /* url_mismatch */)
1785 // A renderer sends this to the browser process when a document has been
1786 // detached. The browser will use this to constrain the lifecycle of worker
1787 // processes (SharedWorkers are shut down when their last associated document
1789 IPC_MESSAGE_CONTROL1(ViewHostMsg_DocumentDetached,
1790 uint64 /* document_id */)
1792 // Wraps an IPC message that's destined to the worker on the renderer->browser
1794 IPC_MESSAGE_CONTROL1(ViewHostMsg_ForwardToWorker,
1795 IPC::Message /* message */)
1797 // Tells the browser that a specific Appcache manifest in the current page
1799 IPC_MESSAGE_ROUTED2(ViewHostMsg_AppCacheAccessed,
1800 GURL /* manifest url */,
1801 bool /* blocked by policy */)
1803 // Initiates a download based on user actions like 'ALT+click'.
1804 IPC_MESSAGE_ROUTED3(ViewHostMsg_DownloadUrl,
1806 content::Referrer /* referrer */,
1807 string16 /* suggested_name */)
1809 // Used to go to the session history entry at the given offset (ie, -1 will
1810 // return the "back" item).
1811 IPC_MESSAGE_ROUTED1(ViewHostMsg_GoToEntryAtOffset,
1812 int /* offset (from current) of history item to get */)
1814 // Sent from an inactive renderer for the browser to route to the active
1815 // renderer, instructing it to close.
1816 IPC_MESSAGE_ROUTED0(ViewHostMsg_RouteCloseEvent)
1818 // Sent to the browser from an inactive renderer to post a message to the
1820 IPC_MESSAGE_ROUTED1(ViewHostMsg_RouteMessageEvent,
1821 ViewMsg_PostMessage_Params)
1823 IPC_SYNC_MESSAGE_ROUTED4_2(ViewHostMsg_RunJavaScriptMessage,
1824 string16 /* in - alert message */,
1825 string16 /* in - default prompt */,
1826 GURL /* in - originating page URL */,
1827 content::JavaScriptMessageType /* in - type */,
1828 bool /* out - success */,
1829 string16 /* out - user_input field */)
1831 // Requests that the given URL be opened in the specified manner.
1832 IPC_MESSAGE_ROUTED1(ViewHostMsg_OpenURL, ViewHostMsg_OpenURL_Params)
1834 // Notifies that the preferred size of the content changed.
1835 IPC_MESSAGE_ROUTED1(ViewHostMsg_DidContentsPreferredSizeChange,
1836 gfx::Size /* pref_size */)
1838 // Notifies that the scroll offset changed.
1839 // This is different from ViewHostMsg_UpdateRect in that ViewHostMsg_UpdateRect
1840 // is not sent at all when threaded compositing is enabled while
1841 // ViewHostMsg_DidChangeScrollOffset works properly in this case.
1842 IPC_MESSAGE_ROUTED0(ViewHostMsg_DidChangeScrollOffset)
1844 // Notifies that the pinned-to-side state of the content changed.
1845 IPC_MESSAGE_ROUTED2(ViewHostMsg_DidChangeScrollOffsetPinningForMainFrame,
1846 bool /* pinned_to_left */,
1847 bool /* pinned_to_right */)
1849 // Notifies that the scrollbars-visible state of the content changed.
1850 IPC_MESSAGE_ROUTED2(ViewHostMsg_DidChangeScrollbarsForMainFrame,
1851 bool /* has_horizontal_scrollbar */,
1852 bool /* has_vertical_scrollbar */)
1854 // Notifies that the number of JavaScript scroll handlers changed.
1855 IPC_MESSAGE_ROUTED1(ViewHostMsg_DidChangeNumWheelEvents,
1858 // Notifies whether there are JavaScript touch event handlers or not.
1859 IPC_MESSAGE_ROUTED1(ViewHostMsg_HasTouchEventHandlers,
1860 bool /* has_handlers */)
1862 // A message from HTML-based UI. When (trusted) Javascript calls
1863 // send(message, args), this message is sent to the browser.
1864 IPC_MESSAGE_ROUTED3(ViewHostMsg_WebUISend,
1865 GURL /* source_url */,
1866 std::string /* message */,
1867 base::ListValue /* args */)
1869 // A renderer sends this to the browser process when it wants to create a ppapi
1870 // plugin. The browser will create the plugin process if necessary, and will
1871 // return a handle to the channel on success.
1873 // The plugin_child_id is the ChildProcessHost ID assigned in the browser
1874 // process. This ID is valid only in the context of the browser process and is
1875 // used to identify the proper process when the renderer notifies it that the
1878 // On error an empty string and null handles are returned.
1879 IPC_SYNC_MESSAGE_CONTROL1_3(ViewHostMsg_OpenChannelToPepperPlugin,
1880 base::FilePath /* path */,
1881 IPC::ChannelHandle /* handle to channel */,
1882 base::ProcessId /* plugin_pid */,
1883 int /* plugin_child_id */)
1885 // Notification that a plugin has created a new plugin instance. The parameters
1887 // -The plugin process ID that we're creating the instance for.
1888 // -The instance ID of the instance being created.
1889 // -A PepperRendererInstanceData struct which contains properties from the
1890 // renderer which are associated with the plugin instance. This includes the
1891 // routing ID of the associated render view and the URL of plugin.
1892 // -Whether the plugin we're creating an instance for is external or internal.
1894 // This message must be sync even though it returns no parameters to avoid
1895 // a race condition with the plugin process. The plugin process sends messages
1896 // to the browser that assume the browser knows about the instance. We need to
1897 // make sure that the browser actually knows about the instance before we tell
1898 // the plugin to run.
1899 IPC_SYNC_MESSAGE_CONTROL4_0(
1900 ViewHostMsg_DidCreateOutOfProcessPepperInstance,
1901 int /* plugin_child_id */,
1902 int32 /* pp_instance */,
1903 content::PepperRendererInstanceData /* creation_data */,
1904 bool /* is_external */)
1906 // Notification that a plugin has destroyed an instance. This is the opposite of
1907 // the "DidCreate" message above.
1908 IPC_MESSAGE_CONTROL3(ViewHostMsg_DidDeleteOutOfProcessPepperInstance,
1909 int /* plugin_child_id */,
1910 int32 /* pp_instance */,
1911 bool /* is_external */)
1913 // Message from the renderer to the browser indicating the in-process instance
1914 // has been created.
1915 IPC_MESSAGE_CONTROL2(ViewHostMsg_DidCreateInProcessInstance,
1916 int32 /* instance */,
1917 content::PepperRendererInstanceData /* instance_data */)
1919 // Message from the renderer to the browser indicating the in-process instance
1920 // has been destroyed.
1921 IPC_MESSAGE_CONTROL1(ViewHostMsg_DidDeleteInProcessInstance,
1922 int32 /* instance */)
1924 // A renderer sends this to the browser process when it wants to
1925 // create a ppapi broker. The browser will create the broker process
1926 // if necessary, and will return a handle to the channel on success.
1927 // On error an empty string is returned.
1928 // The browser will respond with ViewMsg_PpapiBrokerChannelCreated.
1929 IPC_MESSAGE_CONTROL2(ViewHostMsg_OpenChannelToPpapiBroker,
1930 int /* routing_id */,
1931 base::FilePath /* path */)
1933 // Opens a Pepper file asynchronously. The response returns a file descriptor
1934 // and an error code from base/platform_file.h.
1935 IPC_MESSAGE_CONTROL3(ViewHostMsg_AsyncOpenPepperFile,
1936 int /* routing_id */,
1937 base::FilePath /* file path */,
1938 int /* pp_open_flags */)
1940 // A renderer sends this to the browser process when it wants to access a PPAPI
1941 // broker. In contrast to ViewHostMsg_OpenChannelToPpapiBroker, this is called
1942 // for every connection.
1943 // The browser will respond with ViewMsg_PpapiBrokerPermissionResult.
1944 IPC_MESSAGE_ROUTED3(ViewHostMsg_RequestPpapiBrokerPermission,
1945 int /* routing_id */,
1946 GURL /* document_url */,
1947 base::FilePath /* plugin_path */)
1949 #if defined(USE_X11)
1950 // A renderer sends this when it needs a browser-side widget for
1951 // hosting a windowed plugin. id is the XID of the plugin window, for which
1952 // the container is created.
1953 IPC_SYNC_MESSAGE_ROUTED1_0(ViewHostMsg_CreatePluginContainer,
1954 gfx::PluginWindowHandle /* id */)
1956 // Destroy a plugin container previously created using CreatePluginContainer.
1957 // id is the XID of the plugin window corresponding to the container that is
1959 IPC_SYNC_MESSAGE_ROUTED1_0(ViewHostMsg_DestroyPluginContainer,
1960 gfx::PluginWindowHandle /* id */)
1963 // Send the tooltip text for the current mouse position to the browser.
1964 IPC_MESSAGE_ROUTED2(ViewHostMsg_SetTooltipText,
1965 string16 /* tooltip text string */,
1966 WebKit::WebTextDirection /* text direction hint */)
1968 IPC_MESSAGE_ROUTED0(ViewHostMsg_SelectRange_ACK)
1969 IPC_MESSAGE_ROUTED0(ViewHostMsg_MoveCaret_ACK)
1971 // Notification that the text selection has changed.
1972 // Note: The secound parameter is the character based offset of the string16
1973 // text in the document.
1974 IPC_MESSAGE_ROUTED3(ViewHostMsg_SelectionChanged,
1975 string16 /* text covers the selection range */,
1976 size_t /* the offset of the text in the document */,
1977 gfx::Range /* selection range in the document */)
1979 // Notification that the selection bounds have changed.
1980 IPC_MESSAGE_ROUTED1(ViewHostMsg_SelectionBoundsChanged,
1981 ViewHostMsg_SelectionBounds_Params)
1983 // Asks the browser to open the color chooser.
1984 IPC_MESSAGE_ROUTED2(ViewHostMsg_OpenColorChooser,
1986 SkColor /* color */)
1988 // Asks the browser to end the color chooser.
1989 IPC_MESSAGE_ROUTED1(ViewHostMsg_EndColorChooser, int /* id */)
1991 // Change the selected color in the color chooser.
1992 IPC_MESSAGE_ROUTED2(ViewHostMsg_SetSelectedColorInColorChooser,
1994 SkColor /* color */)
1996 // Asks the browser to display the file chooser. The result is returned in a
1997 // ViewHost_RunFileChooserResponse message.
1998 IPC_MESSAGE_ROUTED1(ViewHostMsg_RunFileChooser,
1999 content::FileChooserParams)
2001 // Asks the browser to enumerate a directory. This is equivalent to running
2002 // the file chooser in directory-enumeration mode and having the user select
2003 // the given directory. The result is returned in a
2004 // ViewMsg_EnumerateDirectoryResponse message.
2005 IPC_MESSAGE_ROUTED2(ViewHostMsg_EnumerateDirectory,
2006 int /* request_id */,
2007 base::FilePath /* file_path */)
2009 // Tells the browser to move the focus to the next (previous if reverse is
2010 // true) focusable element.
2011 IPC_MESSAGE_ROUTED1(ViewHostMsg_TakeFocus,
2014 // Required for opening a date/time dialog
2015 IPC_MESSAGE_ROUTED1(ViewHostMsg_OpenDateTimeDialog,
2016 ViewHostMsg_DateTimeDialogValue_Params /* value */)
2018 IPC_MESSAGE_ROUTED3(ViewHostMsg_TextInputTypeChanged,
2019 ui::TextInputType /* TextInputType of the focused node */,
2020 ui::TextInputMode /* TextInputMode of the focused node */,
2021 bool /* can_compose_inline in the focused node */)
2023 // Required for updating text input state.
2024 IPC_MESSAGE_ROUTED1(ViewHostMsg_TextInputStateChanged,
2025 ViewHostMsg_TextInputState_Params /* input state params */)
2027 // Required for cancelling an ongoing input method composition.
2028 IPC_MESSAGE_ROUTED0(ViewHostMsg_ImeCancelComposition)
2030 // WebKit and JavaScript error messages to log to the console
2032 IPC_MESSAGE_ROUTED4(ViewHostMsg_AddMessageToConsole,
2033 int32, /* log level */
2035 int32, /* line number */
2036 string16 /* source id */ )
2038 // Sent by the renderer process to indicate that a plugin instance has crashed.
2039 // Note: |plugin_pid| should not be trusted. The corresponding process has
2040 // probably died. Moreover, the ID may have been reused by a new process. Any
2041 // usage other than displaying it in a prompt to the user is very likely to be
2043 IPC_MESSAGE_ROUTED2(ViewHostMsg_CrashedPlugin,
2044 base::FilePath /* plugin_path */,
2045 base::ProcessId /* plugin_pid */)
2047 // Displays a box to confirm that the user wants to navigate away from the
2048 // page. Replies true if yes, false otherwise, the reply string is ignored,
2049 // but is included so that we can use OnJavaScriptMessageBoxClosed.
2050 IPC_SYNC_MESSAGE_ROUTED3_2(ViewHostMsg_RunBeforeUnloadConfirm,
2051 GURL, /* in - originating frame URL */
2052 string16 /* in - alert message */,
2053 bool /* in - is a reload */,
2054 bool /* out - success */,
2055 string16 /* out - This is ignored.*/)
2057 // Sent when a provisional load on the main frame redirects.
2058 IPC_MESSAGE_ROUTED3(ViewHostMsg_DidRedirectProvisionalLoad,
2060 GURL /* last url */,
2061 GURL /* url redirected to */)
2063 // Sent when the renderer changes the zoom level for a particular url, so the
2064 // browser can update its records. If remember is true, then url is used to
2065 // update the zoom level for all pages in that site. Otherwise, the render
2066 // view's id is used so that only the menu is updated.
2067 IPC_MESSAGE_ROUTED3(ViewHostMsg_DidZoomURL,
2068 double /* zoom_level */,
2069 bool /* remember */,
2072 // Updates the minimum/maximum allowed zoom percent for this tab from the
2073 // default values. If |remember| is true, then the zoom setting is applied to
2074 // other pages in the site and is saved, otherwise it only applies to this
2076 IPC_MESSAGE_ROUTED3(ViewHostMsg_UpdateZoomLimits,
2077 int /* minimum_percent */,
2078 int /* maximum_percent */,
2079 bool /* remember */)
2081 // Notify the browser that this render process can or can't be suddenly
2083 IPC_MESSAGE_CONTROL1(ViewHostMsg_SuddenTerminationChanged,
2086 // Informs the browser of updated frame names.
2087 IPC_MESSAGE_ROUTED3(ViewHostMsg_UpdateFrameName,
2089 bool /* is_top_level */,
2090 std::string /* name */)
2093 IPC_STRUCT_BEGIN(ViewHostMsg_CompositorSurfaceBuffersSwapped_Params)
2094 IPC_STRUCT_MEMBER(int32, surface_id)
2095 IPC_STRUCT_MEMBER(uint64, surface_handle)
2096 IPC_STRUCT_MEMBER(int32, route_id)
2097 IPC_STRUCT_MEMBER(gfx::Size, size)
2098 IPC_STRUCT_MEMBER(float, scale_factor)
2099 IPC_STRUCT_MEMBER(int32, gpu_process_host_id)
2100 IPC_STRUCT_MEMBER(ui::LatencyInfo, latency_info)
2103 // This message is synthesized by GpuProcessHost to pass through a swap message
2104 // to the RenderWidgetHelper. This allows GetBackingStore to block for either a
2105 // software or GPU frame.
2106 IPC_MESSAGE_ROUTED1(
2107 ViewHostMsg_CompositorSurfaceBuffersSwapped,
2108 ViewHostMsg_CompositorSurfaceBuffersSwapped_Params /* params */)
2110 IPC_MESSAGE_ROUTED2(ViewHostMsg_SwapCompositorFrame,
2111 uint32 /* output_surface_id */,
2112 cc::CompositorFrame /* frame */)
2114 // Sent by the compositor when input scroll events are dropped due to bounds
2115 // restricions on the root scroll offset.
2116 IPC_MESSAGE_ROUTED2(ViewHostMsg_DidOverscroll,
2117 gfx::Vector2dF /* accumulated_overscroll */,
2118 gfx::Vector2dF /* current_fling_velocity */)
2120 // Reply to a snapshot request containing whether snapshotting succeeded and the
2121 // SkBitmap if it succeeded.
2122 IPC_MESSAGE_ROUTED2(ViewHostMsg_Snapshot,
2124 SkBitmap /* bitmap */)
2126 //---------------------------------------------------------------------------
2127 // Request for cryptographic operation messages:
2128 // These are messages from the renderer to the browser to perform a
2129 // cryptographic operation.
2131 // Asks the browser process to generate a keypair for grabbing a client
2132 // certificate from a CA (<keygen> tag), and returns the signed public
2133 // key and challenge string.
2134 IPC_SYNC_MESSAGE_CONTROL3_1(ViewHostMsg_Keygen,
2135 uint32 /* key size index */,
2136 std::string /* challenge string */,
2137 GURL /* URL of requestor */,
2138 std::string /* signed public key and challenge */)
2140 // Message sent from the renderer to the browser to request that the browser
2141 // cache |data| associated with |url|.
2142 IPC_MESSAGE_CONTROL3(ViewHostMsg_DidGenerateCacheableMetadata,
2144 double /* expected_response_time */,
2145 std::vector<char> /* data */)
2147 // Displays a JavaScript out-of-memory message in the infobar.
2148 IPC_MESSAGE_ROUTED0(ViewHostMsg_JSOutOfMemory)
2150 // Register a new handler for URL requests with the given scheme.
2151 IPC_MESSAGE_ROUTED4(ViewHostMsg_RegisterProtocolHandler,
2152 std::string /* scheme */,
2154 string16 /* title */,
2155 bool /* user_gesture */)
2157 // Stores new inspector setting in the profile.
2158 // TODO(jam): this should be in the chrome module
2159 IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateInspectorSetting,
2160 std::string, /* key */
2161 std::string /* value */)
2163 // Puts the browser into "tab fullscreen" mode for the sending renderer.
2164 // See the comment in chrome/browser/ui/browser.h for more details.
2165 IPC_MESSAGE_ROUTED1(ViewHostMsg_ToggleFullscreen,
2166 bool /* enter_fullscreen */)
2168 // Send back a string to be recorded by UserMetrics.
2169 IPC_MESSAGE_CONTROL1(ViewHostMsg_UserMetricsRecordAction,
2170 std::string /* action */)
2172 // Notifies the browser that the page was or was not saved as MHTML.
2173 IPC_MESSAGE_CONTROL2(ViewHostMsg_SavedPageAsMHTML,
2175 int64 /* size of the MHTML file, -1 if error */)
2177 IPC_MESSAGE_ROUTED3(ViewHostMsg_SendCurrentPageAllSavableResourceLinks,
2178 std::vector<GURL> /* all savable resource links */,
2179 std::vector<content::Referrer> /* all referrers */,
2180 std::vector<GURL> /* all frame links */)
2182 IPC_MESSAGE_ROUTED3(ViewHostMsg_SendSerializedHtmlData,
2183 GURL /* frame's url */,
2184 std::string /* data buffer */,
2185 int32 /* complete status */)
2187 // Notifies the browser of an event occurring in the media pipeline.
2188 IPC_MESSAGE_CONTROL1(ViewHostMsg_MediaLogEvents,
2189 std::vector<media::MediaLogEvent> /* events */)
2191 // Requests to lock the mouse. Will result in a ViewMsg_LockMouse_ACK message
2193 // |privileged| is used by Pepper Flash. If this flag is set to true, we won't
2194 // pop up a bubble to ask for user permission or take mouse lock content into
2196 IPC_MESSAGE_ROUTED3(ViewHostMsg_LockMouse,
2197 bool /* user_gesture */,
2198 bool /* last_unlocked_by_target */,
2199 bool /* privileged */)
2201 // Requests to unlock the mouse. A ViewMsg_MouseLockLost message will be sent
2202 // whenever the mouse is unlocked (which may or may not be caused by
2203 // ViewHostMsg_UnlockMouse).
2204 IPC_MESSAGE_ROUTED0(ViewHostMsg_UnlockMouse)
2206 // Notifies that the initial empty document of a view has been accessed.
2207 // After this, it is no longer safe to show a pending navigation's URL without
2208 // making a URL spoof possible.
2209 IPC_MESSAGE_ROUTED0(ViewHostMsg_DidAccessInitialDocument)
2211 // Following message is used to communicate the values received by the
2212 // callback binding the JS to Cpp.
2213 // An instance of browser that has an automation host listening to it can
2214 // have a javascript send a native value (string, number, boolean) to the
2215 // listener in Cpp. (DomAutomationController)
2216 IPC_MESSAGE_ROUTED2(ViewHostMsg_DomOperationResponse,
2217 std::string /* json_string */,
2218 int /* automation_id */)
2220 // Sent to the browser when the renderer detects it is blocked on a pepper
2221 // plugin message for too long. This is also sent when it becomes unhung
2222 // (according to the value of is_hung). The browser can give the user the
2223 // option of killing the plugin.
2224 IPC_MESSAGE_ROUTED3(ViewHostMsg_PepperPluginHung,
2225 int /* plugin_child_id */,
2226 base::FilePath /* path */,
2229 // Notifies that multiple touch targets may have been pressed, and to show
2230 // the disambiguation popup.
2231 IPC_MESSAGE_ROUTED3(ViewHostMsg_ShowDisambiguationPopup,
2232 gfx::Rect, /* Border of touched targets */
2233 gfx::Size, /* Size of zoomed image */
2234 TransportDIB::Id /* DIB of zoomed image */)
2236 // Sent by the renderer process to check whether client 3D APIs
2237 // (Pepper 3D, WebGL) are explicitly blocked.
2238 IPC_SYNC_MESSAGE_CONTROL3_1(ViewHostMsg_Are3DAPIsBlocked,
2239 int /* render_view_id */,
2240 GURL /* top_origin_url */,
2241 content::ThreeDAPIType /* requester */,
2244 // Sent by the renderer process to indicate that a context was lost by
2245 // client 3D content (Pepper 3D, WebGL) running on the page at the
2247 IPC_MESSAGE_CONTROL3(ViewHostMsg_DidLose3DContext,
2248 GURL /* top_origin_url */,
2249 content::ThreeDAPIType /* context_type */,
2250 int /* arb_robustness_status_code */)
2252 // Notifies the browser that document has parsed the body. This is used by the
2253 // ResourceScheduler as an indication that bandwidth contention won't block
2255 IPC_MESSAGE_ROUTED0(ViewHostMsg_WillInsertBody)
2257 // Notification that the urls for the favicon of a site has been determined.
2258 IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateFaviconURL,
2259 int32 /* page_id */,
2260 std::vector<content::FaviconURL> /* candidates */)
2262 // Sent once a paint happens after the first non empty layout. In other words
2263 // after the page has painted something.
2264 IPC_MESSAGE_ROUTED1(ViewHostMsg_DidFirstVisuallyNonEmptyPaint,
2267 // Sent by the renderer to the browser to start a vibration with the given
2269 IPC_MESSAGE_CONTROL1(ViewHostMsg_Vibrate,
2270 int64 /* milliseconds */)
2271 // Sent by the renderer to the browser to cancel the currently running
2272 // vibration, if there is one.
2273 IPC_MESSAGE_CONTROL0(ViewHostMsg_CancelVibration)
2275 #if defined(OS_ANDROID)
2276 // Response to ViewMsg_FindMatchRects.
2278 // |version| will contain the current version number of the renderer's find
2279 // match list (incremented whenever they change), which should be passed in the
2280 // next call to ViewMsg_FindMatchRects.
2282 // |rects| will either contain a list of the enclosing rects of all matches
2283 // found by the most recent Find operation, or will be empty if |version| is not
2284 // greater than the |current_version| passed to ViewMsg_FindMatchRects (hence
2285 // your locally cached rects should still be valid). The rect coords will be
2286 // custom normalized fractions of the document size. The rects will be sorted by
2287 // frame traversal order starting in the main frame, then by dom order.
2289 // |active_rect| will contain the bounding box of the active find-in-page match
2290 // marker, in similarly normalized coords (or an empty rect if there isn't one).
2291 IPC_MESSAGE_ROUTED3(ViewHostMsg_FindMatchRects_Reply,
2293 std::vector<gfx::RectF> /* rects */,
2294 gfx::RectF /* active_rect */)
2296 // Start an android intent with the given URI.
2297 IPC_MESSAGE_ROUTED1(ViewHostMsg_StartContentIntent,
2298 GURL /* content_url */)
2300 // Message sent when the renderer changed the background color for the view.
2301 IPC_MESSAGE_ROUTED1(ViewHostMsg_DidChangeBodyBackgroundColor,
2302 uint32 /* bg_color */)
2304 // This message runs the MediaCodec for decoding audio for webaudio.
2305 IPC_MESSAGE_CONTROL3(ViewHostMsg_RunWebAudioMediaCodec,
2306 base::SharedMemoryHandle /* encoded_data_handle */,
2307 base::FileDescriptor /* pcm_output */,
2308 uint32_t /* data_size*/)
2310 // Sent by renderer to request a ViewMsg_BeginFrame message for upcoming
2311 // display events. If |enabled| is true, the BeginFrame message will continue
2312 // to be be delivered until the notification is disabled.
2313 IPC_MESSAGE_ROUTED1(ViewHostMsg_SetNeedsBeginFrame,
2316 #elif defined(OS_MACOSX)
2317 // Request that the browser load a font into shared memory for us.
2318 IPC_SYNC_MESSAGE_CONTROL1_3(ViewHostMsg_LoadFont,
2319 FontDescriptor /* font to load */,
2320 uint32 /* buffer size */,
2321 base::SharedMemoryHandle /* font data */,
2322 uint32 /* font id */)
2324 // Informs the browser that a plugin has gained or lost focus.
2325 IPC_MESSAGE_ROUTED2(ViewHostMsg_PluginFocusChanged,
2327 int /* plugin_id */)
2329 // Instructs the browser to start plugin IME.
2330 IPC_MESSAGE_ROUTED0(ViewHostMsg_StartPluginIme)
2332 #elif defined(OS_WIN)
2333 // Request that the given font characters be loaded by the browser so it's
2334 // cached by the OS. Please see RenderMessageFilter::OnPreCacheFontCharacters
2336 IPC_SYNC_MESSAGE_CONTROL2_0(ViewHostMsg_PreCacheFontCharacters,
2337 LOGFONT /* font_data */,
2338 string16 /* characters */)
2341 #if defined(OS_POSIX)
2342 // On POSIX, we cannot allocated shared memory from within the sandbox, so
2343 // this call exists for the renderer to ask the browser to allocate memory
2344 // on its behalf. We return a file descriptor to the POSIX shared memory.
2345 // If the |cache_in_browser| flag is |true|, then a copy of the shmem is kept
2346 // by the browser, and it is the caller's repsonsibility to send a
2347 // ViewHostMsg_FreeTransportDIB message in order to release the cached shmem.
2348 // In all cases, the caller is responsible for deleting the resulting
2350 IPC_SYNC_MESSAGE_CONTROL2_1(ViewHostMsg_AllocTransportDIB,
2351 uint32_t, /* bytes requested */
2352 bool, /* cache in the browser */
2353 TransportDIB::Handle /* DIB */)
2355 // Since the browser keeps handles to the allocated transport DIBs, this
2356 // message is sent to tell the browser that it may release them when the
2357 // renderer is finished with them.
2358 IPC_MESSAGE_CONTROL1(ViewHostMsg_FreeTransportDIB,
2359 TransportDIB::Id /* DIB id */)
2362 #if defined(OS_MACOSX) || defined(OS_WIN) || defined(USE_AURA)
2363 // On MACOSX, WIN and AURA IME can request composition character bounds
2364 // synchronously (see crbug.com/120597). This IPC message sends the character
2365 // bounds after every composition change to always have correct bound info.
2366 IPC_MESSAGE_ROUTED2(ViewHostMsg_ImeCompositionRangeChanged,
2367 gfx::Range /* composition range */,
2368 std::vector<gfx::Rect> /* character bounds */)
2371 // Adding a new message? Stick to the sort order above: first platform
2372 // independent ViewMsg, then ifdefs for platform specific ViewMsg, then platform
2373 // independent ViewHostMsg, then ifdefs for platform specific ViewHostMsg.