| blob | 20bec60476a247f0039a3a9d0ecf80ad1a20fa91 |
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.
64 #if defined(OS_MACOSX)
67 #endif
69 #undef IPC_MESSAGE_EXPORT
70 #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
72 #define IPC_MESSAGE_START ViewMsgStart
98 #if defined(OS_MACOSX)
103 #endif
182 #if defined(OS_ANDROID)
184 #endif
275 // Routing ID of the view initiating the open.
278 // True if this open request came in the context of a user gesture.
281 // Type of window requested.
284 // The session storage namespace ID this view should use.
287 // The name of the resulting frame that should be created (empty if none
288 // has been specified).
291 // The frame identifier of the frame initiating the open.
294 // The URL of the frame initiating the open.
297 // The URL of the top frame containing the opener.
300 // The security origin of the frame initiating the open.
303 // Whether the opener will be suppressed in the new window, in which case
304 // scripting the new window is not allowed.
307 // Whether the window should be opened in the foreground, background, etc.
310 // The URL that will be loaded in the new window (empty if none has been
311 // sepcified).
314 // The referrer that will be used to load |target_url| (empty if none has
315 // been specified).
318 // The window features to use for the new view.
321 // The additional window features to use for the new view. We pass these
322 // separately from |features| above because we cannot serialize WebStrings
323 // over IPC.
328 // URL for the worker script.
331 // Name for a SharedWorker, otherwise empty string.
334 // Security policy used in the worker.
337 // Security policy type used in the worker.
340 // The ID of the parent document (unique within parent renderer).
343 // RenderFrame routing id used to send messages back to the parent.
356 // Parameters structure for ViewHostMsg_FrameNavigate, which has too many data
357 // parameters to be reasonably put in a predefined IPC message.
361 // The frame ID for this navigation. The frame ID uniquely identifies the
362 // frame the navigation happened in for a given renderer.
365 // The WebFrame's uniqueName().
368 // Information regarding the security of the connection (empty if the
369 // connection was not secure).
372 // The gesture that initiated this navigation.
375 // True if this was a post request.
378 // The POST body identifier. -1 if it doesn't exist.
381 // Whether the frame navigation resulted in no change to the documents within
382 // the page. For example, the navigation may have just resulted in scrolling
383 // to a named anchor.
386 // The status code of the HTTP request.
389 // True if the connection was proxied. In this case, socket_address
390 // will represent the address of the proxy, rather than the remote host.
393 // Serialized history item state to store in the navigation entry.
396 // Original request's URL.
399 // User agent override used to navigate.
402 // Notifies the browser that for this navigation, the session history was
403 // successfully cleared.
424 // This message is used for supporting popup menus on Mac OS X using native
425 // Cocoa controls. The renderer sends us this message which we use to populate
426 // the popup menu.
428 // Position on the screen.
431 // The height of each item in the menu.
434 // The size of the font to use for those items.
437 // The currently selected (displayed) item in the menu.
440 // The entire list of items in the popup menu.
443 // Whether items should be right-aligned.
446 // Whether this is a multi-select popup.
451 // The type of input field
454 // The value of the input field
457 // The cursor position of the current selection start, or the caret position
458 // if nothing is selected
461 // The cursor position of the current selection end, or the caret position
462 // if nothing is selected
465 // The start position of the current composition, or -1 if there is none
468 // The end position of the current composition, or -1 if there is none
471 // Whether or not inline composition can be performed for the current input.
474 // Whether or not the IME should be shown as a result of this update. Even if
475 // true, the IME will only be shown if the type is appropriate (e.g. not
476 // TEXT_INPUT_TYPE_NONE).
479 // Whether an acknowledgement is required for this update.
484 // The bitmap to be painted into the view at the locations specified by
485 // update_rects.
488 // The position and size of the bitmap.
491 // The scroll delta. Only one of the delta components can be non-zero, and if
492 // they are both zero, then it means there is no scrolling and the scroll_rect
493 // is ignored.
496 // The rectangular region to scroll.
499 // The scroll offset of the render view.
502 // The regions of the bitmap (in view coords) that contain updated pixels.
503 // In the case of scrolling, this includes the scroll damage rect.
506 // The size of the RenderView when this message was generated. This is
507 // included so the host knows how large the view is from the perspective of
508 // the renderer process. This is necessary in case a resize operation is in
509 // progress. If auto-resize is enabled, this should update the corresponding
510 // view size.
513 // New window locations for plugin child windows.
515 plugin_window_moves)
517 // The following describes the various bits that may be set in flags:
518 //
519 // ViewHostMsg_UpdateRect_Flags::IS_RESIZE_ACK
520 // Indicates that this is a response to a ViewMsg_Resize message.
521 //
522 // ViewHostMsg_UpdateRect_Flags::IS_RESTORE_ACK
523 // Indicates that this is a response to a ViewMsg_WasShown message.
524 //
525 // ViewHostMsg_UpdateRect_Flags::IS_REPAINT_ACK
526 // Indicates that this is a response to a ViewMsg_Repaint message.
527 //
528 // If flags is zero, then this message corresponds to an unsolicited paint
529 // request by the render view. Any of the above bits may be set in flags,
530 // which would indicate that this paint message is an ACK for multiple
531 // request messages.
534 // Whether or not the renderer expects a ViewMsg_UpdateRect_ACK for this
535 // update. True for 2D painting, but false for accelerated compositing.
538 // All the above coordinates are in DIP. This is the scale factor needed
539 // to convert them to pixels.
542 // The latency information for the frame. Only valid when accelerated
543 // compositing is disabled.
548 // The page_id for this navigation, or -1 if it is a new navigation. Back,
549 // Forward, and Reload navigations should have a valid page_id. If the load
550 // succeeds, then this page_id will be reflected in the resultant
551 // ViewHostMsg_FrameNavigate message.
554 // If page_id is -1, then pending_history_list_offset will also be -1.
555 // Otherwise, it contains the offset into the history list corresponding to
556 // the current navigation.
559 // Informs the RenderView of where its current page contents reside in
560 // session history and the total size of the session history list.
564 // Informs the RenderView the session history should be cleared. In that
565 // case, the RenderView needs to notify the browser that the clearing was
566 // succesful when the navigation commits.
569 // The URL to load.
572 // Base URL for use in WebKit's SubstituteData.
573 // Is only used with data: URLs.
576 // History URL for use in WebKit's SubstituteData.
577 // Is only used with data: URLs.
580 // The URL to send in the "Referer" header field. Can be empty if there is
581 // no referrer.
584 // Any redirect URLs that occurred before |url|. Useful for cross-process
585 // navigations; defaults to empty.
588 // The type of transition.
591 // Informs the RenderView the pending navigation should replace the current
592 // history entry when it commits. This is used for cross-process redirects so
593 // the transferred navigation can recover the navigation state.
596 // Opaque history state (received by ViewHostMsg_UpdateState).
599 // Type of navigation.
602 // The time the request was created
605 // Extra headers (separated by \n) to send during the request.
608 // The following two members identify a previous request that has been
609 // created before this navigation is being transferred to a new render view.
610 // This serves the purpose of recycling the old request.
611 // Unless this refers to a transferred navigation, these values are -1 and -1.
615 // Whether or not we should allow the url to download.
618 // Whether or not the user agent override string should be used.
621 // True if this was a post request.
624 // If is_post is true, holds the post_data information from browser. Empty
625 // otherwise.
628 // Whether or not this url should be allowed to access local file://
629 // resources.
632 // If not empty, which frame to navigate.
635 // The navigationStart time to expose to JS for this navigation.
640 // Renderer-wide preferences.
643 // Preferences for this view.
646 // The ID of the view to be created.
649 // The ID of the main frame hosted in the view.
652 // The ID of the rendering surface.
655 // The session storage namespace ID this view should use.
658 // The name of the frame associated with this view (or empty if none).
661 // The route ID of the opener RenderView if we need to set one
662 // (MSG_ROUTING_NONE otherwise).
665 // Whether the RenderView should initially be swapped out.
668 // Whether the RenderView should initially be hidden.
671 // The initial page ID to use for this view, which must be larger than any
672 // existing navigation that might be loaded in the view. Page IDs are unique
673 // to a view and are only updated by the renderer after this initial value.
676 // The properties of the screen associated with the view.
679 // The accessibility mode of the renderer.
682 // Specifies whether partially swapping composited buffers is
683 // allowed for a renderer. Partial swaps will be used if they are both
684 // allowed and supported.
689 // The serialized script value.
692 // When sent to the browser, this is the routing ID of the source frame in
693 // the source process. The browser replaces it with the routing ID of the
694 // equivalent (swapped out) frame in the destination process.
697 // The origin of the source frame.
700 // The origin for the message's target.
703 // Information about the MessagePorts this message contains.
708 // Messages sent from the browser to the renderer.
710 // Tells the renderer to cancel an opened date/time dialog.
713 // Get all savable resource links from current webpage, include main
714 // frame and sub-frame.
718 // Get html data by serializing all frames of current page with lists
719 // which contain all resource links that have local copy.
725 // Tells the render side that a ViewHostMsg_LockMouse message has been
726 // processed. |succeeded| indicates whether the mouse has been successfully
727 // locked or not.
730 // Tells the render side that the mouse has been unlocked.
733 // Screen was rotated. Dispatched to the onorientationchange javascript API.
737 // Sent by the browser when the parameters for vsync alignment have changed.
742 // Set the top-level frame to the provided name.
746 // Sent to the RenderView when a new tab is swapped into an existing
747 // tab and the histories need to be merged. The existing tab has a history of
748 // |merged_history_length| which precedes the history of the new tab. All
749 // page_ids >= |minimum_page_id| in the new tab are appended to the history.
750 //
751 // For example, suppose the history of page_ids in the new tab's RenderView
752 // is [4 7 8]. This is merged into an existing tab with 3 history items, and
753 // all pages in the new tab with page_id >= 7 are to be preserved.
754 // The resulting page history is [-1 -1 -1 7 8].
759 // Tells the renderer to create a new view.
760 // This message is slightly different, the view it takes (via
761 // ViewMsg_New_Params) is the view to create, the message itself is sent as a
762 // non-view control message.
764 ViewMsg_New_Params)
766 // Reply in response to ViewHostMsg_ShowView or ViewHostMsg_ShowWidget.
767 // similar to the new command, but used when the renderer created a view
768 // first, and we need to update it.
771 // Sends updated preferences to the renderer.
775 // This passes a set of webkit preferences down to the renderer.
777 WebPreferences)
779 // Informs the renderer that the timezone has changed.
782 // Tells the render view to close.
794 // Tells the render view to change its size. A ViewHostMsg_UpdateRect message
795 // is generated in response provided new_size is not empty and not equal to
796 // the view's current size. The generated ViewHostMsg_UpdateRect message will
797 // have the IS_RESIZE_ACK flag set. It also receives the resizer rect so that
798 // we don't have to fetch it every time WebKit asks for it.
802 // Tells the render view that the resize rect has changed.
806 // Sent to inform the view that it was hidden. This allows it to reduce its
807 // resource utilization.
810 // Tells the render view that it is no longer hidden (see WasHidden), and the
811 // render view is expected to respond with a full repaint if needs_repainting
812 // is true. In that case, the generated ViewHostMsg_UpdateRect message will
813 // have the IS_RESTORE_ACK flag set. If needs_repainting is false, then this
814 // message does not trigger a message in response.
818 // Sent to inform the view that it was swapped out. This allows the process to
819 // exit if no other views are using it.
822 // Sent to render the view into the supplied transport DIB, resize
823 // the web widget to match the |page_size|, scale it by the
824 // appropriate scale to make it fit the |desired_size|, and return
825 // it. In response to this message, the host generates a
826 // ViewHostMsg_PaintAtSize_ACK message. Note that the DIB *must* be
827 // the right size to receive an RGBA image at the |desired_size|.
828 // |tag| is sent along with ViewHostMsg_PaintAtSize_ACK unmodified to
829 // identify the PaintAtSize message the ACK belongs to.
836 // Tells the render view that a ViewHostMsg_UpdateRect message was processed.
837 // This signals the render view that it can send another UpdateRect message.
840 // Tells the render view that a SwapBuffers was completed. Typically,
841 // SwapBuffers requests go from renderer -> GPU process -> browser. Most
842 // platforms still use the GfxCxt3D Echo for receiving the SwapBuffers Ack.
843 // Using Echo routes the ack from browser -> GPU process -> renderer, while this
844 // Ack goes directly from browser -> renderer. This is not used for the threaded
845 // compositor path.
848 // Tells the renderer to focus the first (last if reverse is true) focusable
849 // node.
853 // Sent to inform the renderer to invoke a context menu.
854 // The parameter specifies the location in the render view's coordinates.
858 // Tells the renderer to perform the specified navigation, interrupting any
859 // existing navigation.
864 // Tells the renderer to reload the current focused frame
867 // Sent when the user wants to search for a word on the page (find in page).
873 // This message notifies the renderer that the user has closed the FindInPage
874 // window (and what action to take regarding the selection).
878 // Replaces a date time input field.
882 // Copies the image at location x, y to the clipboard (if there indeed is an
883 // image at that location).
888 // Tells the renderer to perform the given action on the media player
889 // located at the given point.
894 // Tells the renderer to perform the given action on the plugin located at
895 // the given point.
900 // Request for the renderer to evaluate an xpath to a frame and execute a
901 // javascript: url in that frame's context. The message is completely
902 // asynchronous and no corresponding response message is sent back.
903 //
904 // frame_xpath contains the modified xpath notation to identify an inner
905 // subframe (starting from the root frame). It is a concatenation of
906 // number of smaller xpaths delimited by '\n'. Each chunk in the string can
907 // be evaluated to a frame in its parent-frame's context.
908 //
909 // Example: /html/body/iframe/\n/html/body/div/iframe/\n/frameset/frame[0]
910 // can be broken into 3 xpaths
911 // /html/body/iframe evaluates to an iframe within the root frame
912 // /html/body/div/iframe evaluates to an iframe within the level-1 iframe
913 // /frameset/frame[0] evaluates to first frame within the level-2 iframe
914 //
915 // jscript_url is the string containing the javascript: url to be executed
916 // in the target frame's context. The string should start with "javascript:"
917 // and continue with a valid JS text.
918 //
919 // If the fourth parameter is true the result is sent back to the renderer
920 // using the message ViewHostMsg_ScriptEvalResponse.
921 // ViewHostMsg_ScriptEvalResponse is passed the ID parameter so that the
922 // client can uniquely identify the request.
929 // Posts a message from a frame in another process to the current renderer.
931 ViewMsg_PostMessage_Params)
933 // Requests that the RenderView's main frame sets its opener to null.
936 // Request for the renderer to evaluate an xpath to a frame and insert css
937 // into that frame's document. See ViewMsg_ScriptEvalRequest for details on
938 // allowed xpath expressions.
943 // Change the zoom level for the current main frame. If the level actually
944 // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
945 // telling it what url got zoomed and what its current zoom level is.
949 // Set the zoom level for the current main frame. If the level actually
950 // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
951 // telling it what url got zoomed and what its current zoom level is.
955 // Zooms the page by the factor defined in the renderer.
961 // Set the zoom level for a particular url that the renderer is in the
962 // process of loading. This will be stored, to be used if the load commits
963 // and ignored otherwise.
968 // Set the zoom level for a particular url, so all render views
969 // displaying this url can update their zoom levels to match.
970 // If scheme is empty, then only host is used for matching.
976 // Change encoding of page in the renderer.
980 // Reset encoding of page in the renderer back to default.
983 // Used to tell a render view whether it should expose various bindings
984 // that allow JS content extended privileges. See BindingsPolicy for valid
985 // flag values.
989 // Tell the renderer to add a property to the WebUI binding object. This
990 // only works if we allowed WebUI bindings.
995 // This message starts/stop monitoring the input method status of the focused
996 // edit control of a renderer process.
997 // Parameters
998 // * is_active (bool)
999 // Indicates if an input method is active in the browser process.
1000 // The possible actions when a renderer process receives this message are
1001 // listed below:
1002 // Value Action
1003 // true Start sending IPC message ViewHostMsg_ImeUpdateTextInputState
1004 // to notify the input method status of the focused edit control.
1005 // false Stop sending IPC message ViewHostMsg_ImeUpdateTextInputState.
1009 // IME API oncandidatewindow* events for InputMethodContext.
1014 // This message sends a string being composed with an input method.
1016 ViewMsg_ImeSetComposition,
1022 // This message confirms an ongoing composition.
1028 // Sets the text composition to be between the given start and end offsets
1029 // in the currently focused editable field.
1035 // Selects between the given start and end offsets in the currently focused
1036 // editable field.
1041 // Deletes the current selection plus the specified number of characters before
1042 // and after the selection or caret.
1047 // Used to notify the render-view that we have received a target URL. Used
1048 // to prevent target URLs spamming the browser.
1051 // Notifies the color chooser client that the user selected a color.
1054 // Notifies the color chooser client that the color chooser has ended.
1060 // Provides the results of directory enumeration.
1065 // When a renderer sends a ViewHostMsg_Focus to the browser process,
1066 // the browser has the option of sending a ViewMsg_CantFocus back to
1067 // the renderer.
1070 // Instructs the renderer to invoke the frame's shouldClose method, which
1071 // runs the onbeforeunload event handler. Expects the result to be returned
1072 // via ViewHostMsg_ShouldClose.
1075 // Tells the renderer to suppress any further modal dialogs until it receives a
1076 // corresponding ViewMsg_SwapOut message. This ensures that no
1077 // PageGroupLoadDeferrer is on the stack for SwapOut.
1080 // Instructs the renderer to swap out for a cross-site transition, including
1081 // running the unload event handler. Expects a SwapOut_ACK message when
1082 // finished.
1085 // Instructs the renderer to close the current page, including running the
1086 // onunload event handler.
1087 //
1088 // Expects a ClosePage_ACK message when finished.
1091 // Notifies the renderer about ui theme changes
1094 // Notifies the renderer that a paint is to be generated for the rectangle
1095 // passed in.
1099 // Notification that a move or resize renderer's containing window has
1100 // started.
1107 // Reply to ViewHostMsg_RequestMove, ViewHostMsg_ShowView, and
1108 // ViewHostMsg_ShowWidget to inform the renderer that the browser has
1109 // processed the move. The browser may have ignored the move, but it finished
1110 // processing. This is used because the renderer keeps a temporary cache of
1111 // the widget position while these asynchronous operations are in progress.
1114 // Used to instruct the RenderView to send back updates to the preferred size.
1117 // Used to instruct the RenderView to automatically resize and send back
1118 // updates for the new size.
1123 // Used to instruct the RenderView to disalbe automatically resize.
1127 // Changes the text direction of the currently selected input field (if any).
1131 // Tells the renderer to clear the focused node (if any).
1134 // Make the RenderView transparent and render it onto a custom background. The
1135 // background will be tiled in both directions if it is not large enough.
1139 // Used to tell the renderer not to add scrollbars with height and
1140 // width below a threshold.
1144 // Activate/deactivate the RenderView (i.e., set its controls' tint
1145 // accordingly, etc.).
1149 // Response message to ViewHostMsg_CreateWorker.
1150 // Sent when the worker has started.
1153 // Sent when the worker failed to load the worker script.
1154 // In normal cases, this message is sent after ViewMsg_WorkerCreated is sent.
1155 // But if the shared worker of the same URL already exists and it has failed
1156 // to load the script, when the renderer send ViewHostMsg_CreateWorker before
1157 // the shared worker is killed only ViewMsg_WorkerScriptLoadFailed is sent.
1160 // Sent when the worker has connected.
1161 // This message is sent only if the worker successfully loaded the script.
1164 // Tells the renderer that the network state has changed and that
1165 // window.navigator.onLine should be updated for all WebViews.
1169 // Reply to ViewHostMsg_OpenChannelToPpapiBroker
1170 // Tells the renderer that the channel to the broker has been created.
1175 // Reply to ViewHostMsg_RequestPpapiBrokerPermission.
1176 // Tells the renderer whether permission to access to PPAPI broker was granted
1177 // or not.
1181 // Tells the renderer to empty its plugin list cache, optional reloading
1182 // pages containing plugins.
1186 // Used to instruct the RenderView to go into "view source" mode.
1189 // Instructs the renderer to save the current page to MHTML.
1194 // Temporary message to diagnose an unexpected condition in WebContentsImpl.
1198 // Change the accessibility mode in the renderer process.
1200 AccessibilityMode)
1202 // An acknowledge to ViewHostMsg_MultipleTargetsTouched to notify the renderer
1203 // process to release the magnified image.
1207 // Notifies the renderer that a snapshot has been retrieved.
1213 #if defined(OS_MACOSX)
1216 // Notification of a change in scrollbar appearance and/or behavior.
1223 #endif
1225 #if defined(OS_ANDROID)
1226 // Tells the renderer to suspend/resume the webkit timers.
1230 // Sent when the browser wants the bounding boxes of the current find matches.
1231 //
1232 // If match rects are already cached on the browser side, |current_version|
1233 // should be the version number from the ViewHostMsg_FindMatchRects_Reply
1234 // they came in, so the renderer can tell if it needs to send updated rects.
1235 // Otherwise just pass -1 to always receive the list of rects.
1236 //
1237 // There must be an active search string (it is probably most useful to call
1238 // this immediately after a ViewHostMsg_Find_Reply message arrives with
1239 // final_update set to true).
1243 // External popup menus.
1248 // Tells the renderer to try to revert to the zoom level we were at before
1249 // ViewMsg_ScrollFocusedEditableNodeIntoView was called.
1252 // Notifies the renderer whether hiding/showing the top controls is enabled
1253 // and whether or not to animate to the proper state.
1261 // Sent by the browser when the renderer should generate a new frame.
1265 // Sent by the browser when an IME update that requires acknowledgement has been
1266 // processed on the browser side.
1269 // Sent by the browser when we should pause video playback.
1272 // Extracts the data at the given rect, returning it through the
1273 // ViewHostMsg_SmartClipDataExtracted IPC.
1277 #elif defined(OS_MACOSX)
1278 // Let the RenderView know its window has changed visibility.
1282 // Let the RenderView know its window's frame has changed.
1287 // Message sent from the browser to the renderer when the user starts or stops
1288 // resizing the view.
1292 // Tell the renderer that plugin IME has completed.
1297 // External popup menus.
1300 #endif
1302 // Sent by the browser as a reply to ViewHostMsg_SwapCompositorFrame.
1307 // Sent by browser to tell renderer compositor that some resources that were
1308 // given to the browser in a swap are not being used anymore.
1313 // Sent by the browser to ask the renderer for a snapshot of the current view.
1317 // -----------------------------------------------------------------------------
1318 // Messages sent from the renderer to the browser.
1320 // Sent by the renderer when it is creating a new window. The browser creates
1321 // a tab for it and responds with a ViewMsg_CreatingNew_ACK. If route_id is
1322 // MSG_ROUTING_NONE, the view couldn't be created.
1324 ViewHostMsg_CreateWindow_Params,
1330 // Similar to ViewHostMsg_CreateWindow, except used for sub-widgets, like
1331 // <select> dropdowns. This message is sent to the WebContentsImpl that
1332 // contains the widget being created.
1339 // Similar to ViewHostMsg_CreateWidget except the widget is a full screen
1340 // window.
1346 // Asks the browser for a unique routing ID.
1350 // Asks the browser for the default audio hardware configuration.
1355 // Asks the browser for CPU usage of the renderer process in percents.
1359 // Asks the browser for the renderer process memory size stats.
1364 // These three messages are sent to the parent RenderViewHost to display the
1365 // page/widget that was created by
1366 // CreateWindow/CreateWidget/CreateFullscreenWidget. routing_id
1367 // refers to the id that was returned from the Create message above.
1368 // The initial_position parameter is a rectangle in screen coordinates.
1369 //
1370 // FUTURE: there will probably be flags here to control if the result is
1371 // in a new window.
1382 // Message to show a full screen widget.
1386 // This message is sent after ViewHostMsg_ShowView to cause the RenderView
1387 // to run in a modal fashion until it is closed.
1391 // Indicates the renderer is ready in response to a ViewMsg_New or
1392 // a ViewMsg_CreatingNew_ACK.
1395 // Indicates the renderer process is gone. This actually is sent by the
1396 // browser process to itself, but keeps the interface cleaner.
1401 // Sent by the renderer process to request that the browser close the view.
1402 // This corresponds to the window.close() API, and the browser may ignore
1403 // this message. Otherwise, the browser will generates a ViewMsg_Close
1404 // message to close the view.
1407 // Send in response to a ViewMsg_UpdateScreenRects so that the renderer can
1408 // throttle these messages.
1411 // Sent by the renderer process to request that the browser move the view.
1412 // This corresponds to the window.resizeTo() and window.moveTo() APIs, and
1413 // the browser may ignore this message.
1417 // Notifies the browser that a frame in the view has changed. This message
1418 // has a lot of parameters and is packed/unpacked by functions defined in
1419 // render_messages.h.
1421 ViewHostMsg_FrameNavigate_Params)
1423 // Message to show a popup menu using native cocoa controls (Mac only).
1425 ViewHostMsg_ShowPopup_Params)
1427 // Response from ViewMsg_ScriptEvalRequest. The ID is the parameter supplied
1428 // to ViewMsg_ScriptEvalRequest. The result has the value returned by the
1429 // script as its only element, one of Null, Boolean, Integer, Real, Date, or
1430 // String.
1435 // Result of string search in the page.
1436 // Response to ViewMsg_Find with the results of the requested find-in-page
1437 // search, the number of matches found and the selection rect (in screen
1438 // coordinates) for the string found. If |final_update| is false, it signals
1439 // that this is not the last Find_Reply message - more will be sent as the
1440 // scoping effort continues.
1448 // Provides the result from running OnMsgShouldClose. |proceed| matches the
1449 // return value of the the frame's shouldClose method (which includes the
1450 // onbeforeunload handler): true if the user decided to proceed with leaving
1451 // the page.
1457 // Indicates that the current renderer has swapped out, after a SwapOut
1458 // message.
1461 // Indicates that the current page has been closed, after a ClosePage
1462 // message.
1465 // Notifies the browser that media has started/stopped playing.
1473 // Notifies the browser that we have session history information.
1474 // page_id: unique ID that allows us to distinguish between history entries.
1479 // Notifies the browser that a document has been loaded in a frame.
1483 // Notifies the browser that a frame finished loading.
1489 // Changes the title for the page in the UI when the page is navigated or the
1490 // title changes.
1496 // Change the encoding name of the page in UI when the page has detected
1497 // proper encoding name.
1501 // Notifies the browser that we want to show a destination url for a potential
1502 // action (e.g. when the user is hovering over a link).
1504 int32,
1505 GURL)
1507 // Sent when the renderer starts loading the page. This corresponds to
1508 // WebKit's notion of the throbber starting. Note that sometimes you may get
1509 // duplicates of these during a single load.
1512 // Sent when the renderer is done loading a page. This corresponds to WebKit's
1513 // notion of the throbber stopping.
1516 // Sent when the renderer main frame has made progress loading.
1520 // Sent when the renderer main frame sets its opener to null, disowning it for
1521 // the lifetime of the window.
1524 // Sent when the document element is available for the top-level frame. This
1525 // happens after the page starts loading, but before all resources are
1526 // finished.
1529 // Sent when after the onload handler has been invoked for the document
1530 // in the top-level frame.
1534 // Sent when the renderer loads a resource from its memory cache.
1535 // The security info is non empty if the resource was originally loaded over
1536 // a secure connection.
1537 // Note: May only be sent once per URL per frame per committed load.
1545 // Sent when the renderer displays insecure content in a secure page.
1548 // Sent when the renderer runs insecure content in a secure origin.
1560 // Tells the render view that a ViewHostMsg_PaintAtSize message was
1561 // processed, and the DIB is ready for use. |tag| has the same value that
1562 // the tag sent along with ViewMsg_PaintAtSize.
1567 // Sent to update part of the view. In response to this message, the host
1568 // generates a ViewMsg_UpdateRect_ACK message.
1570 ViewHostMsg_UpdateRect_Params)
1572 // Sent to unblock the browser's UI thread if it is waiting on an UpdateRect,
1573 // which may get delayed until the browser's UI unblocks.
1576 // Sent by the renderer when accelerated compositing is enabled or disabled to
1577 // notify the browser whether or not is should do painting.
1584 // Message sent from renderer to the browser when focus changes inside the
1585 // webpage. The parameter says whether the newly focused element needs
1586 // keyboard input (true for textfields, text areas and content editable divs).
1591 WebCursor)
1593 // Used to set a cookie. The cookie is set asynchronously, but will be
1594 // available to a subsequent ViewHostMsg_GetCookies request.
1601 // Used to get cookies for the given URL. This may block waiting for a
1602 // previous SetCookie message to be processed.
1609 // Used to get raw cookie information for the given URL. This may block
1610 // waiting for a previous SetCookie message to be processed.
1617 // Used to delete cookie for the given URL and name
1622 // Used to check if cookies are enabled for the given URL. This may block
1623 // waiting for a previous SetCookie message to be processed.
1629 // Used to get the list of plugins
1634 #if defined(OS_WIN)
1641 // Asks the browser for the user's monitor profile.
1644 #endif
1646 // Get the list of proxies to use for |url|, as a semicolon delimited list
1647 // of "<TYPE> <HOST>:<PORT>" | "DIRECT".
1653 // A renderer sends this to the browser process when it wants to create a
1654 // worker. The browser will create the worker process if necessary, and
1655 // will return the route id on success. On error returns MSG_ROUTING_NONE.
1657 ViewHostMsg_CreateWorker_Params,
1660 // A renderer sends this to the browser process when a document has been
1661 // detached. The browser will use this to constrain the lifecycle of worker
1662 // processes (SharedWorkers are shut down when their last associated document
1663 // is detached).
1667 // Wraps an IPC message that's destined to the worker on the renderer->browser
1668 // hop.
1672 // Tells the browser that a specific Appcache manifest in the current page
1673 // was accessed.
1678 // Initiates a download based on user actions like 'ALT+click'.
1684 // Used to go to the session history entry at the given offset (ie, -1 will
1685 // return the "back" item).
1689 // Sent from an inactive renderer for the browser to route to the active
1690 // renderer, instructing it to close.
1693 // Sent to the browser from an inactive renderer to post a message to the
1694 // active renderer.
1696 ViewMsg_PostMessage_Params)
1706 // Requests that the given URL be opened in the specified manner.
1709 // Notifies that the preferred size of the content changed.
1713 // Notifies that the scroll offset changed.
1714 // This is different from ViewHostMsg_UpdateRect in that ViewHostMsg_UpdateRect
1715 // is not sent at all when threaded compositing is enabled while
1716 // ViewHostMsg_DidChangeScrollOffset works properly in this case.
1719 // Notifies that the pinned-to-side state of the content changed.
1724 // Notifies that the scrollbars-visible state of the content changed.
1729 // Notifies that the number of JavaScript scroll handlers changed.
1733 // Notifies whether there are JavaScript touch event handlers or not.
1737 // A message from HTML-based UI. When (trusted) Javascript calls
1738 // send(message, args), this message is sent to the browser.
1744 // A renderer sends this to the browser process when it wants to create a ppapi
1745 // plugin. The browser will create the plugin process if necessary, and will
1746 // return a handle to the channel on success.
1747 //
1748 // The plugin_child_id is the ChildProcessHost ID assigned in the browser
1749 // process. This ID is valid only in the context of the browser process and is
1750 // used to identify the proper process when the renderer notifies it that the
1751 // plugin is hung.
1752 //
1753 // On error an empty string and null handles are returned.
1760 // Notification that a plugin has created a new plugin instance. The parameters
1761 // indicate:
1762 // -The plugin process ID that we're creating the instance for.
1763 // -The instance ID of the instance being created.
1764 // -A PepperRendererInstanceData struct which contains properties from the
1765 // renderer which are associated with the plugin instance. This includes the
1766 // routing ID of the associated render view and the URL of plugin.
1767 // -Whether the plugin we're creating an instance for is external or internal.
1768 //
1769 // This message must be sync even though it returns no parameters to avoid
1770 // a race condition with the plugin process. The plugin process sends messages
1771 // to the browser that assume the browser knows about the instance. We need to
1772 // make sure that the browser actually knows about the instance before we tell
1773 // the plugin to run.
1775 ViewHostMsg_DidCreateOutOfProcessPepperInstance,
1781 // Notification that a plugin has destroyed an instance. This is the opposite of
1782 // the "DidCreate" message above.
1788 // Message from the renderer to the browser indicating the in-process instance
1789 // has been created.
1794 // Message from the renderer to the browser indicating the in-process instance
1795 // has been destroyed.
1799 // A renderer sends this to the browser process when it wants to
1800 // create a ppapi broker. The browser will create the broker process
1801 // if necessary, and will return a handle to the channel on success.
1802 // On error an empty string is returned.
1803 // The browser will respond with ViewMsg_PpapiBrokerChannelCreated.
1808 // A renderer sends this to the browser process when it wants to access a PPAPI
1809 // broker. In contrast to ViewHostMsg_OpenChannelToPpapiBroker, this is called
1810 // for every connection.
1811 // The browser will respond with ViewMsg_PpapiBrokerPermissionResult.
1817 #if defined(USE_X11)
1818 // A renderer sends this when it needs a browser-side widget for
1819 // hosting a windowed plugin. id is the XID of the plugin window, for which
1820 // the container is created.
1824 // Destroy a plugin container previously created using CreatePluginContainer.
1825 // id is the XID of the plugin window corresponding to the container that is
1826 // to be destroyed.
1829 #endif
1831 // Send the tooltip text for the current mouse position to the browser.
1839 // Notification that the text selection has changed.
1840 // Note: The secound parameter is the character based offset of the
1841 // base::string16
1842 // text in the document.
1848 // Notification that the selection bounds have changed.
1850 ViewHostMsg_SelectionBounds_Params)
1852 // Asks the browser to open the color chooser.
1858 // Asks the browser to end the color chooser.
1861 // Change the selected color in the color chooser.
1866 // Asks the browser to display the file chooser. The result is returned in a
1867 // ViewHost_RunFileChooserResponse message.
1871 // Asks the browser to enumerate a directory. This is equivalent to running
1872 // the file chooser in directory-enumeration mode and having the user select
1873 // the given directory. The result is returned in a
1874 // ViewMsg_EnumerateDirectoryResponse message.
1879 // Tells the browser to move the focus to the next (previous if reverse is
1880 // true) focusable element.
1884 // Required for opening a date/time dialog
1893 // Required for updating text input state.
1897 // Required for cancelling an ongoing input method composition.
1900 // WebKit and JavaScript error messages to log to the console
1901 // or debugger UI.
1908 // Displays a box to confirm that the user wants to navigate away from the
1909 // page. Replies true if yes, false otherwise, the reply string is ignored,
1910 // but is included so that we can use OnJavaScriptMessageBoxClosed.
1918 // Sent when the renderer changes the zoom level for a particular url, so the
1919 // browser can update its records. If remember is true, then url is used to
1920 // update the zoom level for all pages in that site. Otherwise, the render
1921 // view's id is used so that only the menu is updated.
1927 // Updates the minimum/maximum allowed zoom percent for this tab from the
1928 // default values. If |remember| is true, then the zoom setting is applied to
1929 // other pages in the site and is saved, otherwise it only applies to this
1930 // tab.
1936 // Notify the browser that this render process can or can't be suddenly
1937 // terminated.
1941 // Informs the browser of updated frame names.
1958 // This message is synthesized by GpuProcessHost to pass through a swap message
1959 // to the RenderWidgetHelper. This allows GetBackingStore to block for either a
1960 // software or GPU frame.
1962 ViewHostMsg_CompositorSurfaceBuffersSwapped,
1969 // Sent by the compositor when input scroll events are dropped due to bounds
1970 // restricions on the root scroll offset.
1975 // Sent by the compositor when a flinging animation is stopped.
1978 // Reply to a snapshot request containing whether snapshotting succeeded and the
1979 // SkBitmap if it succeeded.
1984 //---------------------------------------------------------------------------
1985 // Request for cryptographic operation messages:
1986 // These are messages from the renderer to the browser to perform a
1987 // cryptographic operation.
1989 // Asks the browser process to generate a keypair for grabbing a client
1990 // certificate from a CA (<keygen> tag), and returns the signed public
1991 // key and challenge string.
1998 // Message sent from the renderer to the browser to request that the browser
1999 // cache |data| associated with |url|.
2005 // Displays a JavaScript out-of-memory message in the infobar.
2008 // Register a new handler for URL requests with the given scheme.
2015 // Stores new inspector setting in the profile.
2016 // TODO(jam): this should be in the chrome module
2021 // Puts the browser into "tab fullscreen" mode for the sending renderer.
2022 // See the comment in chrome/browser/ui/browser.h for more details.
2026 // Send back a string to be recorded by UserMetrics.
2030 // Notifies the browser that the page was or was not saved as MHTML.
2045 // Notifies the browser of an event occurring in the media pipeline.
2049 // Requests to lock the mouse. Will result in a ViewMsg_LockMouse_ACK message
2050 // being sent back.
2051 // |privileged| is used by Pepper Flash. If this flag is set to true, we won't
2052 // pop up a bubble to ask for user permission or take mouse lock content into
2053 // account.
2059 // Requests to unlock the mouse. A ViewMsg_MouseLockLost message will be sent
2060 // whenever the mouse is unlocked (which may or may not be caused by
2061 // ViewHostMsg_UnlockMouse).
2064 // Notifies that the initial empty document of a view has been accessed.
2065 // After this, it is no longer safe to show a pending navigation's URL without
2066 // making a URL spoof possible.
2069 // Following message is used to communicate the values received by the
2070 // callback binding the JS to Cpp.
2071 // An instance of browser that has an automation host listening to it can
2072 // have a javascript send a native value (string, number, boolean) to the
2073 // listener in Cpp. (DomAutomationController)
2078 // Notifies that multiple touch targets may have been pressed, and to show
2079 // the disambiguation popup.
2085 // Sent by the renderer process to check whether client 3D APIs
2086 // (Pepper 3D, WebGL) are explicitly blocked.
2093 // Sent by the renderer process to indicate that a context was lost by
2094 // client 3D content (Pepper 3D, WebGL) running on the page at the
2095 // given URL.
2101 // Notifies the browser that document has parsed the body. This is used by the
2102 // ResourceScheduler as an indication that bandwidth contention won't block
2103 // first paint.
2106 // Notification that the urls for the favicon of a site has been determined.
2111 // Sent once a paint happens after the first non empty layout. In other words
2112 // after the page has painted something.
2116 // Sent by the renderer to the browser to start a vibration with the given
2117 // duration.
2121 // Sent by the renderer to the browser to cancel the currently running
2122 // vibration, if there is one.
2125 // Message sent from renderer to the browser when the element that is focused
2126 // has been touched. A bool is passed in this message which indicates if the
2127 // node is editable.
2131 // Message sent from the renderer to the browser when an HTML form has failed
2132 // validation constraints.
2138 // Message sent from the renderer to the browser when a HTML form validation
2139 // message should be hidden from view.
2142 // Message sent from the renderer to the browser when the suggested co-ordinates
2143 // of the anchor for a HTML form validation message have changed.
2147 #if defined(OS_ANDROID)
2148 // Response to ViewMsg_FindMatchRects.
2149 //
2150 // |version| will contain the current version number of the renderer's find
2151 // match list (incremented whenever they change), which should be passed in the
2152 // next call to ViewMsg_FindMatchRects.
2153 //
2154 // |rects| will either contain a list of the enclosing rects of all matches
2155 // found by the most recent Find operation, or will be empty if |version| is not
2156 // greater than the |current_version| passed to ViewMsg_FindMatchRects (hence
2157 // your locally cached rects should still be valid). The rect coords will be
2158 // custom normalized fractions of the document size. The rects will be sorted by
2159 // frame traversal order starting in the main frame, then by dom order.
2160 //
2161 // |active_rect| will contain the bounding box of the active find-in-page match
2162 // marker, in similarly normalized coords (or an empty rect if there isn't one).
2168 // Start an android intent with the given URI.
2172 // Message sent when the renderer changed the background color for the view.
2176 // This message runs the MediaCodec for decoding audio for webaudio.
2182 // Sent by renderer to request a ViewMsg_BeginFrame message for upcoming
2183 // display events. If |enabled| is true, the BeginFrame message will continue
2184 // to be be delivered until the notification is disabled.
2188 // Reply to the ViewMsg_ExtractSmartClipData message.
2189 // TODO(juhui24.lee@samsung.com): this should be changed to a vector of structs
2190 // instead of encoding the data as a string which is not allowed normally. Since
2191 // ths is only used in Android WebView, it's allowed temporarily.
2192 // http://crbug.com/330872
2195 #elif defined(OS_MACOSX)
2196 // Request that the browser load a font into shared memory for us.
2203 // Informs the browser that a plugin has gained or lost focus.
2208 // Instructs the browser to start plugin IME.
2211 #elif defined(OS_WIN)
2212 // Request that the given font characters be loaded by the browser so it's
2213 // cached by the OS. Please see RenderMessageFilter::OnPreCacheFontCharacters
2214 // for details.
2218 #endif
2220 #if defined(OS_POSIX)
2221 // On POSIX, we cannot allocated shared memory from within the sandbox, so
2222 // this call exists for the renderer to ask the browser to allocate memory
2223 // on its behalf. We return a file descriptor to the POSIX shared memory.
2224 // If the |cache_in_browser| flag is |true|, then a copy of the shmem is kept
2225 // by the browser, and it is the caller's repsonsibility to send a
2226 // ViewHostMsg_FreeTransportDIB message in order to release the cached shmem.
2227 // In all cases, the caller is responsible for deleting the resulting
2228 // TransportDIB.
2234 // Since the browser keeps handles to the allocated transport DIBs, this
2235 // message is sent to tell the browser that it may release them when the
2236 // renderer is finished with them.
2239 #endif
2241 #if defined(OS_MACOSX) || defined(OS_WIN) || defined(USE_AURA)
2242 // On MACOSX, WIN and AURA IME can request composition character bounds
2243 // synchronously (see crbug.com/120597). This IPC message sends the character
2244 // bounds after every composition change to always have correct bound info.
2248 #endif
2250 // Adding a new message? Stick to the sort order above: first platform
2251 // independent ViewMsg, then ifdefs for platform specific ViewMsg, then platform
2252 // independent ViewHostMsg, then ifdefs for platform specific ViewHostMsg.