| blob | aedac37756a11d5070e67bf3d8a48edc66cb1726 |
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.
58 #if defined(OS_MACOSX)
60 #endif
62 #undef IPC_MESSAGE_EXPORT
63 #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
65 #define IPC_MESSAGE_START ViewMsgStart
89 #if defined(OS_MACOSX)
94 #endif
172 #if defined(OS_MACOSX)
183 #if defined(OS_ANDROID)
186 #endif
205 #if defined(OS_ANDROID)
207 #endif
292 // Routing ID of the view initiating the open.
295 // True if this open request came in the context of a user gesture.
298 // Type of window requested.
301 // The session storage namespace ID this view should use.
304 // The name of the resulting frame that should be created (empty if none
305 // has been specified).
308 // The frame identifier of the frame initiating the open.
311 // The URL of the frame initiating the open.
314 // The security origin of the frame initiating the open.
317 // Whether the opener will be suppressed in the new window, in which case
318 // scripting the new window is not allowed.
321 // Whether the window should be opened in the foreground, background, etc.
324 // The URL that will be loaded in the new window (empty if none has been
325 // sepcified).
330 // The type of input field
333 // The value of the input field
336 // The cursor position of the current selection start, or the caret position
337 // if nothing is selected
340 // The cursor position of the current selection end, or the caret position
341 // if nothing is selected
344 // The start position of the current composition, or -1 if there is none
347 // The end position of the current composition, or -1 if there is none
350 // Whether or not inline composition can be performed for the current input.
353 // Whether or not the IME should be shown as a result of this update. Even if
354 // true, the IME will only be shown if the type is appropriate (e.g. not
355 // TEXT_INPUT_TYPE_NONE).
360 // URL for the worker script.
363 // Name for a SharedWorker, otherwise empty string.
366 // The ID of the parent document (unique within parent renderer).
369 // RenderView routing id used to send messages back to the parent.
372 // The route ID to associate with the worker. If MSG_ROUTING_NONE is passed,
373 // a new unique ID is created and assigned to the worker.
376 // The ID of the appcache the main shared worker script resource was loaded
377 // from, only valid for shared workers.
381 // Parameters structure for ViewHostMsg_FrameNavigate, which has too many data
382 // parameters to be reasonably put in a predefined IPC message.
386 // The frame ID for this navigation. The frame ID uniquely identifies the
387 // frame the navigation happened in for a given renderer.
390 // Information regarding the security of the connection (empty if the
391 // connection was not secure).
394 // The gesture that initiated this navigation.
397 // True if this was a post request.
400 // The POST body identifier. -1 if it doesn't exist.
403 // Whether the frame navigation resulted in no change to the documents within
404 // the page. For example, the navigation may have just resulted in scrolling
405 // to a named anchor.
408 // The status code of the HTTP request.
411 // True if the connection was proxied. In this case, socket_address
412 // will represent the address of the proxy, rather than the remote host.
415 // Serialized history item state to store in the navigation entry.
418 // Original request's URL.
421 // User agent override used to navigate.
425 // This message is used for supporting popup menus on Mac OS X using native
426 // Cocoa controls. The renderer sends us this message which we use to populate
427 // the popup menu.
429 // Position on the screen.
432 // The height of each item in the menu.
435 // The size of the font to use for those items.
438 // The currently selected (displayed) item in the menu.
441 // The entire list of items in the popup menu.
444 // Whether items should be right-aligned.
447 // Whether this is a multi-select popup.
452 // The bitmap to be painted into the view at the locations specified by
453 // update_rects.
456 // The position and size of the bitmap.
459 // The scroll delta. Only one of the delta components can be non-zero, and if
460 // they are both zero, then it means there is no scrolling and the scroll_rect
461 // is ignored.
464 // The rectangular region to scroll.
467 // The scroll offset of the render view.
470 // The regions of the bitmap (in view coords) that contain updated pixels.
471 // In the case of scrolling, this includes the scroll damage rect.
474 // The size of the RenderView when this message was generated. This is
475 // included so the host knows how large the view is from the perspective of
476 // the renderer process. This is necessary in case a resize operation is in
477 // progress. If auto-resize is enabled, this should update the corresponding
478 // view size.
481 // New window locations for plugin child windows.
483 plugin_window_moves)
485 // The following describes the various bits that may be set in flags:
486 //
487 // ViewHostMsg_UpdateRect_Flags::IS_RESIZE_ACK
488 // Indicates that this is a response to a ViewMsg_Resize message.
489 //
490 // ViewHostMsg_UpdateRect_Flags::IS_RESTORE_ACK
491 // Indicates that this is a response to a ViewMsg_WasShown message.
492 //
493 // ViewHostMsg_UpdateRect_Flags::IS_REPAINT_ACK
494 // Indicates that this is a response to a ViewMsg_Repaint message.
495 //
496 // If flags is zero, then this message corresponds to an unsolicited paint
497 // request by the render view. Any of the above bits may be set in flags,
498 // which would indicate that this paint message is an ACK for multiple
499 // request messages.
502 // Whether or not the renderer expects a ViewMsg_UpdateRect_ACK for this
503 // update. True for 2D painting, but false for accelerated compositing.
506 // All the above coordinates are in DIP. This is the scale factor needed
507 // to convert them to pixels.
512 // The serialized script value.
515 // When sent to the browser, this is the routing ID of the source frame in
516 // the source process. The browser replaces it with the routing ID of the
517 // equivalent (swapped out) frame in the destination process.
519 // The identifier of the source frame in the source process.
522 // The full set of identifiers to uniquely describe the target frame. See
523 // the comment on ViewMsg_FrameTreeUpdated for details.
528 // The origin of the source frame.
531 // The origin for the message's target.
536 // The frame ID for the failure report.
538 // True if this is the top-most frame.
540 // Error code as reported in the DidFailProvisionalLoad callback.
542 // An error message generated from the error_code. This can be an empty
543 // string if we were unable to find a meaningful description.
545 // The URL that the error is reported for.
547 // True if the failure is the result of navigating to a POST again
548 // and we're going to show the POST interstitial.
553 // The identifier of the RenderProcessHost for the currently closing view.
554 //
555 // These first two parameters are technically redundant since they are
556 // needed only when processing the ACK message, and the processor
557 // theoretically knows both the process and route ID. However, this is
558 // difficult to figure out with our current implementation, so this
559 // information is duplicated here.
562 // The route identifier for the currently closing RenderView.
565 // The identifier of the RenderProcessHost for the new view attempting to
566 // replace the closing one above.
569 // The identifier of the *request* the new view made that is causing the
570 // cross-site transition. This is *not* a route_id, but the request that we
571 // will resume once the ACK from the closing view has been received.
576 // The page_id for this navigation, or -1 if it is a new navigation. Back,
577 // Forward, and Reload navigations should have a valid page_id. If the load
578 // succeeds, then this page_id will be reflected in the resultant
579 // ViewHostMsg_FrameNavigate message.
582 // If page_id is -1, then pending_history_list_offset will also be -1.
583 // Otherwise, it contains the offset into the history list corresponding to
584 // the current navigation.
587 // Informs the RenderView of where its current page contents reside in
588 // session history and the total size of the session history list.
592 // The URL to load.
595 // Base URL for use in WebKit's SubstituteData.
596 // Is only used with data: URLs.
599 // History URL for use in WebKit's SubstituteData.
600 // Is only used with data: URLs.
603 // The URL to send in the "Referer" header field. Can be empty if there is
604 // no referrer.
607 // The type of transition.
610 // Opaque history state (received by ViewHostMsg_UpdateState).
613 // Type of navigation.
616 // The time the request was created
619 // Extra headers (separated by \n) to send during the request.
622 // The following two members identify a previous request that has been
623 // created before this navigation is being transferred to a new render view.
624 // This serves the purpose of recycling the old request.
625 // Unless this refers to a transferred navigation, these values are -1 and -1.
629 // Whether or not we should allow the url to download.
632 // Whether or not the user agent override string should be used.
635 // True if this was a post request.
638 // If is_post is true, holds the post_data information from browser. Empty
639 // otherwise.
642 // Whether or not this url should be allowed to access local file://
643 // resources.
647 // Parameters for an OpenURL request.
657 // Renderer-wide preferences.
660 // Preferences for this view.
663 // The ID of the view to be created.
666 // The ID of the rendering surface.
669 // The session storage namespace ID this view should use.
672 // The name of the frame associated with this view (or empty if none).
675 // The route ID of the opener RenderView if we need to set one
676 // (MSG_ROUTING_NONE otherwise).
679 // Whether the RenderView should initially be swapped out.
682 // The initial page ID to use for this view, which must be larger than any
683 // existing navigation that might be loaded in the view. Page IDs are unique
684 // to a view and are only updated by the renderer after this initial value.
687 // The properties of the screen associated with the view.
690 // The accessibility mode of the renderer.
694 // Messages sent from the browser to the renderer.
696 // Sent to the RenderView when a new tab is swapped into an existing
697 // tab and the histories need to be merged. The existing tab has a history of
698 // |merged_history_length| which precedes the history of the new tab. All
699 // page_ids >= |minimum_page_id| in the new tab are appended to the history.
700 //
701 // For example, suppose the history of page_ids in the new tab's RenderView
702 // is [4 7 8]. This is merged into an existing tab with 3 history items, and
703 // all pages in the new tab with page_id >= 7 are to be preserved.
704 // The resulting page history is [-1 -1 -1 7 8].
709 // Asks the browser for a unique routing ID.
713 // Asks the browser for the default audio hardware buffer-size.
717 // Asks the browser for the default audio input hardware sample-rate.
721 // Asks the browser for the default audio hardware sample-rate.
725 // Asks the browser for the default channel layout.
729 // Asks the browser for CPU usage of the renderer process in percents.
733 // Asks the browser for the user's monitor profile.
737 // Tells the renderer to create a new view.
738 // This message is slightly different, the view it takes (via
739 // ViewMsg_New_Params) is the view to create, the message itself is sent as a
740 // non-view control message.
742 ViewMsg_New_Params)
744 // Reply in response to ViewHostMsg_ShowView or ViewHostMsg_ShowWidget.
745 // similar to the new command, but used when the renderer created a view
746 // first, and we need to update it.
749 // Sends updated preferences to the renderer.
753 // This passes a set of webkit preferences down to the renderer.
757 // Informs the renderer that the timezone has changed.
760 // Tells the render view to close.
763 // Tells the render view to change its size. A ViewHostMsg_PaintRect message
764 // is generated in response provided new_size is not empty and not equal to
765 // the view's current size. The generated ViewHostMsg_PaintRect message will
766 // have the IS_RESIZE_ACK flag set. It also receives the resizer rect so that
767 // we don't have to fetch it every time WebKit asks for it.
773 // Tells the render view that the resize rect has changed.
777 // Sent to inform the view that it was hidden. This allows it to reduce its
778 // resource utilization.
781 // Tells the render view that it is no longer hidden (see WasHidden), and the
782 // render view is expected to respond with a full repaint if needs_repainting
783 // is true. In that case, the generated ViewHostMsg_PaintRect message will
784 // have the IS_RESTORE_ACK flag set. If needs_repainting is false, then this
785 // message does not trigger a message in response.
789 // Sent to inform the view that it was swapped out. This allows the process to
790 // exit if no other views are using it.
793 // Sent to render the view into the supplied transport DIB, resize
794 // the web widget to match the |page_size|, scale it by the
795 // appropriate scale to make it fit the |desired_size|, and return
796 // it. In response to this message, the host generates a
797 // ViewHostMsg_PaintAtSize_ACK message. Note that the DIB *must* be
798 // the right size to receive an RGBA image at the |desired_size|.
799 // |tag| is sent along with ViewHostMsg_PaintAtSize_ACK unmodified to
800 // identify the PaintAtSize message the ACK belongs to.
807 // Tells the render view that a ViewHostMsg_UpdateRect message was processed.
808 // This signals the render view that it can send another UpdateRect message.
811 // Tells the render view that a SwapBuffers was completed. Typically,
812 // SwapBuffers requests go from renderer -> GPU process -> browser. Most
813 // platforms still use the GfxCxt3D Echo for receiving the SwapBuffers Ack.
814 // Using Echo routes the ack from browser -> GPU process -> renderer, while this
815 // Ack goes directly from browser -> renderer. This is not used for the threaded
816 // compositor path.
819 // Sends an input event to the render widget.
824 // Tells the render widget that a smooth scroll completed.
828 // This message notifies the renderer that the next key event is bound to one
829 // or more pre-defined edit commands. If the next key event is not handled
830 // by webkit, the specified edit commands shall be executed against current
831 // focused frame.
832 // Parameters
833 // * edit_commands (see chrome/common/edit_command_types.h)
834 // Contains one or more edit commands.
835 // See third_party/WebKit/Source/WebCore/editing/EditorCommand.cpp for detailed
836 // definition of webkit edit commands.
837 //
838 // This message must be sent just before sending a key event.
842 // Message payload is the name/value of a WebCore edit command to execute.
849 // TODO(darin): figure out how this meshes with RestoreFocus
853 // Tells the renderer to focus the first (last if reverse is true) focusable
854 // node.
858 // Tells the renderer to scroll the currently focused node into rect only if
859 // the currently focused node is a Text node (textfield, text area or content
860 // editable divs).
863 // Executes custom context menu action that was provided from WebKit.
868 // Sent in response to a ViewHostMsg_ContextMenu to let the renderer know that
869 // the menu has been closed.
873 // Tells the renderer to perform the specified navigation, interrupting any
874 // existing navigation.
879 // Tells the renderer to reload the current focused frame
882 // Sent when the user wants to search for a word on the page (find in page).
888 // This message notifies the renderer that the user has closed the FindInPage
889 // window (and what action to take regarding the selection).
893 // These messages are typically generated from context menus and request the
894 // renderer to apply the specified operation to the current selection.
899 #if defined(OS_MACOSX)
901 #endif
904 // Replaces the selected region or a word around the cursor with the
905 // specified string.
907 string16)
911 // Replaces a date time input field.
916 // Requests the renderer to select the region between two points.
917 // Expects a SelectRange_ACK message when finished.
922 // Copies the image at location x, y to the clipboard (if there indeed is an
923 // image at that location).
928 // Tells the renderer to perform the given action on the media player
929 // located at the given point.
934 // Tells the renderer to perform the given action on the plugin located at
935 // the given point.
940 // Request for the renderer to evaluate an xpath to a frame and execute a
941 // javascript: url in that frame's context. The message is completely
942 // asynchronous and no corresponding response message is sent back.
943 //
944 // frame_xpath contains the modified xpath notation to identify an inner
945 // subframe (starting from the root frame). It is a concatenation of
946 // number of smaller xpaths delimited by '\n'. Each chunk in the string can
947 // be evaluated to a frame in its parent-frame's context.
948 //
949 // Example: /html/body/iframe/\n/html/body/div/iframe/\n/frameset/frame[0]
950 // can be broken into 3 xpaths
951 // /html/body/iframe evaluates to an iframe within the root frame
952 // /html/body/div/iframe evaluates to an iframe within the level-1 iframe
953 // /frameset/frame[0] evaluates to first frame within the level-2 iframe
954 //
955 // jscript_url is the string containing the javascript: url to be executed
956 // in the target frame's context. The string should start with "javascript:"
957 // and continue with a valid JS text.
958 //
959 // If the fourth parameter is true the result is sent back to the renderer
960 // using the message ViewHostMsg_ScriptEvalResponse.
961 // ViewHostMsg_ScriptEvalResponse is passed the ID parameter so that the
962 // client can uniquely identify the request.
969 // Posts a message from a frame in another process to the current renderer.
971 ViewMsg_PostMessage_Params)
973 // Requests that the RenderView's main frame sets its opener to null.
976 // Sends a JSON serialized frame tree to RenderView along with the process id
977 // and route id of the source renderer.
978 //
979 // This message must be sent to swapped out RenderViews every time the browser
980 // receives a ViewHostMsg_FrameTreeUpdated message.
986 // Request for the renderer to evaluate an xpath to a frame and insert css
987 // into that frame's document. See ViewMsg_ScriptEvalRequest for details on
988 // allowed xpath expressions.
993 // Change the zoom level for the current main frame. If the level actually
994 // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
995 // telling it what url got zoomed and what its current zoom level is.
999 // Set the zoom level for the current main frame. If the level actually
1000 // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
1001 // telling it what url got zoomed and what its current zoom level is.
1005 // Zooms the page by the factor defined in the renderer.
1011 // Set the zoom level for a particular url that the renderer is in the
1012 // process of loading. This will be stored, to be used if the load commits
1013 // and ignored otherwise.
1018 // Set the zoom level for a particular url, so all render views
1019 // displaying this url can update their zoom levels to match.
1024 // Change encoding of page in the renderer.
1028 // Reset encoding of page in the renderer back to default.
1031 // Used to tell a render view whether it should expose various bindings
1032 // that allow JS content extended privileges. See BindingsPolicy for valid
1033 // flag values.
1037 // Tell the renderer to add a property to the WebUI binding object. This
1038 // only works if we allowed WebUI bindings.
1043 // This message starts/stop monitoring the input method status of the focused
1044 // edit control of a renderer process.
1045 // Parameters
1046 // * is_active (bool)
1047 // Indicates if an input method is active in the browser process.
1048 // The possible actions when a renderer process receives this message are
1049 // listed below:
1050 // Value Action
1051 // true Start sending IPC message ViewHostMsg_ImeUpdateTextInputState
1052 // to notify the input method status of the focused edit control.
1053 // false Stop sending IPC message ViewHostMsg_ImeUpdateTextInputState.
1057 // This message sends a string being composed with an input method.
1059 ViewMsg_ImeSetComposition,
1065 // This message confirms an ongoing composition.
1070 // Sets the text composition to be between the given start and end offsets
1071 // in the currently focused editable field.
1077 // Selects between the given start and end offsets in the currently focused
1078 // editable field.
1083 // Deletes the current selection plus the specified number of characters before
1084 // and after the selection or caret.
1089 // Used to notify the render-view that we have received a target URL. Used
1090 // to prevent target URLs spamming the browser.
1094 // Sets the alternate error page URL (link doctor) for the renderer process.
1096 GURL)
1098 // Notifies the color chooser client that the user selected a color.
1101 // Notifies the color chooser client that the color chooser has ended.
1107 // Provides the results of directory enumeration.
1112 // When a renderer sends a ViewHostMsg_Focus to the browser process,
1113 // the browser has the option of sending a ViewMsg_CantFocus back to
1114 // the renderer.
1117 // Instructs the renderer to invoke the frame's shouldClose method, which
1118 // runs the onbeforeunload event handler. Expects the result to be returned
1119 // via ViewHostMsg_ShouldClose.
1122 // Instructs the renderer to swap out for a cross-site transition, including
1123 // running the unload event handler. See the struct above for more details.
1124 //
1125 // Expects a SwapOut_ACK message when finished, where the parameters are
1126 // echoed back.
1128 ViewMsg_SwapOut_Params)
1130 // Instructs the renderer to close the current page, including running the
1131 // onunload event handler.
1132 //
1133 // Expects a ClosePage_ACK message when finished.
1136 // Notifies the renderer about ui theme changes
1139 // Notifies the renderer that a paint is to be generated for the rectangle
1140 // passed in.
1144 // Notification that a move or resize renderer's containing window has
1145 // started.
1155 // Reply to ViewHostMsg_RequestMove, ViewHostMsg_ShowView, and
1156 // ViewHostMsg_ShowWidget to inform the renderer that the browser has
1157 // processed the move. The browser may have ignored the move, but it finished
1158 // processing. This is used because the renderer keeps a temporary cache of
1159 // the widget position while these asynchronous operations are in progress.
1162 // Used to instruct the RenderView to send back updates to the preferred size.
1165 // Used to instruct the RenderView to automatically resize and send back
1166 // updates for the new size.
1171 // Used to instruct the RenderView to disalbe automatically resize.
1175 // Changes the text direction of the currently selected input field (if any).
1179 // Tells the renderer to clear the focused node (if any).
1182 // Make the RenderView transparent and render it onto a custom background. The
1183 // background will be tiled in both directions if it is not large enough.
1187 // Used to tell the renderer not to add scrollbars with height and
1188 // width below a threshold.
1192 // Activate/deactivate the RenderView (i.e., set its controls' tint
1193 // accordingly, etc.).
1200 // Response message to ViewHostMsg_CreateShared/DedicatedWorker.
1201 // Sent when the worker has started.
1204 // The response to ViewHostMsg_AsyncOpenFile.
1210 // Tells the renderer that the network state has changed and that
1211 // window.navigator.onLine should be updated for all WebViews.
1215 // Reply to ViewHostMsg_OpenChannelToPpapiBroker
1216 // Tells the renderer that the channel to the broker has been created.
1221 // Reply to ViewHostMsg_RequestPpapiBrokerPermission.
1222 // Tells the renderer whether permission to access to PPAPI broker was granted
1223 // or not.
1228 // Tells the renderer to empty its plugin list cache, optional reloading
1229 // pages containing plugins.
1233 // Sent to the renderer when a popup window should no longer count against
1234 // the current popup count (either because it's not a popup or because it was
1235 // a generated by a user action).
1238 // Used to instruct the RenderView to go into "view source" mode.
1241 // Instructs the renderer to save the current page to MHTML.
1246 // Temporary message to diagnose an unexpected condition in WebContentsImpl.
1250 // Change the accessibility mode in the renderer process.
1252 AccessibilityMode)
1254 #if defined(OS_ANDROID)
1255 // Sent when the user clicks on the find result bar to activate a find result.
1256 // The point (x,y) is in fractions of the content document's width and height.
1262 // Sent when the browser wants the bounding boxes of the current find matches.
1263 //
1264 // If match rects are already cached on the browser side, |current_version|
1265 // should be the version number from the ViewHostMsg_FindMatchRects_Reply
1266 // they came in, so the renderer can tell if it needs to send updated rects.
1267 // Otherwise just pass -1 to always receive the list of rects.
1268 //
1269 // There must be an active search string (it is probably most useful to call
1270 // this immediately after a ViewHostMsg_Find_Reply message arrives with
1271 // final_update set to true).
1275 // Sent when the user wants to search for all occurrences of a word or find
1276 // the next result in a synchronous way. This method forces the UI thread in
1277 // the browser to wait for the renderer to reply, therefore blocking the UI.
1278 //
1279 // This functionality is required for compatibility with the legacy Android
1280 // WebView API. As this goes strongly against the Chromium design guidelines,
1281 // don't use this as inspiration.
1282 //
1290 // External popup menus.
1295 // Tells the renderer to try to revert to the zoom level we were at before
1296 // ViewMsg_ScrollFocusedEditableNodeIntoView was called.
1299 // Message sent when the renderer changed the background color for the view.
1303 // Information about current document scroll, scale and size. Sent on a
1304 // best-effort basis.
1312 #elif defined(OS_MACOSX)
1313 // Let the RenderView know its window has changed visibility.
1317 // Let the RenderView know its window's frame has changed.
1322 // Message sent from the browser to the renderer when the user starts or stops
1323 // resizing the view.
1327 // Tell the renderer that plugin IME has completed.
1332 // External popup menus.
1335 #endif
1337 // An acknowledge to ViewHostMsg_MultipleTargetsTouched to notify the renderer
1338 // process to release the magnified image.
1342 // Notifies the renderer that a snapshot has been retrieved.
1348 // -----------------------------------------------------------------------------
1349 // Messages sent from the renderer to the browser.
1351 // Sent by the renderer when it is creating a new window. The browser creates
1352 // a tab for it and responds with a ViewMsg_CreatingNew_ACK. If route_id is
1353 // MSG_ROUTING_NONE, the view couldn't be created.
1355 ViewHostMsg_CreateWindow_Params,
1360 // Similar to ViewHostMsg_CreateWindow, except used for sub-widgets, like
1361 // <select> dropdowns. This message is sent to the WebContentsImpl that
1362 // contains the widget being created.
1369 // Similar to ViewHostMsg_CreateWidget except the widget is a full screen
1370 // window.
1376 // Get all savable resource links from current webpage, include main
1377 // frame and sub-frame.
1381 // Get html data by serializing all frames of current page with lists
1382 // which contain all resource links that have local copy.
1388 // Tells the render side that a ViewHostMsg_LockMouse message has been
1389 // processed. |succeeded| indicates whether the mouse has been successfully
1390 // locked or not.
1393 // Tells the render side that the mouse has been unlocked.
1396 // These three messages are sent to the parent RenderViewHost to display the
1397 // page/widget that was created by
1398 // CreateWindow/CreateWidget/CreateFullscreenWidget. routing_id
1399 // refers to the id that was returned from the Create message above.
1400 // The initial_position parameter is a rectangle in screen coordinates.
1401 //
1402 // FUTURE: there will probably be flags here to control if the result is
1403 // in a new window.
1414 // Message to show a full screen widget.
1418 // This message is sent after ViewHostMsg_ShowView to cause the RenderView
1419 // to run in a modal fashion until it is closed.
1423 // Indicates the renderer is ready in response to a ViewMsg_New or
1424 // a ViewMsg_CreatingNew_ACK.
1427 // Indicates the renderer process is gone. This actually is sent by the
1428 // browser process to itself, but keeps the interface cleaner.
1433 // Sent by the renderer process to request that the browser close the view.
1434 // This corresponds to the window.close() API, and the browser may ignore
1435 // this message. Otherwise, the browser will generates a ViewMsg_Close
1436 // message to close the view.
1439 // Send in response to a ViewMsg_UpdateScreenRects so that the renderer can
1440 // throttle these messages.
1443 // Sent by the renderer process to request that the browser move the view.
1444 // This corresponds to the window.resizeTo() and window.moveTo() APIs, and
1445 // the browser may ignore this message.
1449 // Notifies the browser that a frame in the view has changed. This message
1450 // has a lot of parameters and is packed/unpacked by functions defined in
1451 // render_messages.h.
1453 ViewHostMsg_FrameNavigate_Params)
1455 // Used to tell the parent that the user right clicked on an area of the
1456 // content area, and a context menu should be shown for it. The params
1457 // object contains information about the node(s) that were selected when the
1458 // user right clicked.
1461 // Message to show a popup menu using native cocoa controls (Mac only).
1463 ViewHostMsg_ShowPopup_Params)
1465 // Response from ViewMsg_ScriptEvalRequest. The ID is the parameter supplied
1466 // to ViewMsg_ScriptEvalRequest. The result has the value returned by the
1467 // script as its only element, one of Null, Boolean, Integer, Real, Date, or
1468 // String.
1473 // Result of string search in the page.
1474 // Response to ViewMsg_Find with the results of the requested find-in-page
1475 // search, the number of matches found and the selection rect (in screen
1476 // coordinates) for the string found. If |final_update| is false, it signals
1477 // that this is not the last Find_Reply message - more will be sent as the
1478 // scoping effort continues.
1486 // Provides the result from running OnMsgShouldClose. |proceed| matches the
1487 // return value of the the frame's shouldClose method (which includes the
1488 // onbeforeunload handler): true if the user decided to proceed with leaving
1489 // the page.
1495 // Indicates that the current renderer has swapped out, after a SwapOut
1496 // message. The parameters are just echoed from the SwapOut request.
1498 ViewMsg_SwapOut_Params)
1500 // Indicates that the current page has been closed, after a ClosePage
1501 // message.
1504 // Notifies the browser that media has started/stopped playing.
1511 // Notifies the browser that we have session history information.
1512 // page_id: unique ID that allows us to distinguish between history entries.
1517 // Notifies the browser that a document has been loaded in a frame.
1521 // Notifies the browser that a frame finished loading.
1527 // Changes the title for the page in the UI when the page is navigated or the
1528 // title changes.
1534 // Changes the icon url for the page in the UI.
1536 int32,
1537 GURL)
1539 // Change the encoding name of the page in UI when the page has detected
1540 // proper encoding name.
1544 // Notifies the browser that we want to show a destination url for a potential
1545 // action (e.g. when the user is hovering over a link).
1547 int32,
1548 GURL)
1550 // Sent when the renderer starts loading the page. This corresponds to
1551 // WebKit's notion of the throbber starting. Note that sometimes you may get
1552 // duplicates of these during a single load.
1555 // Sent when the renderer is done loading a page. This corresponds to WebKit's
1556 // notion of the throbber stopping.
1559 // Sent when the renderer main frame has made progress loading.
1563 // Sent when the renderer main frame sets its opener to null, disowning it for
1564 // the lifetime of the window.
1567 // Sent when the document element is available for the top-level frame. This
1568 // happens after the page starts loading, but before all resources are
1569 // finished.
1572 // Sent when after the onload handler has been invoked for the document
1573 // in the top-level frame.
1577 // Sent when the renderer loads a resource from its memory cache.
1578 // The security info is non empty if the resource was originally loaded over
1579 // a secure connection.
1580 // Note: May only be sent once per URL per frame per committed load.
1588 // Sent when the renderer displays insecure content in a secure page.
1591 // Sent when the renderer runs insecure content in a secure origin.
1596 // Sent when the renderer starts a provisional load for a frame.
1610 // Sent when the renderer fails a provisional load with an error.
1612 ViewHostMsg_DidFailProvisionalLoadWithError_Params)
1614 // Tells the render view that a ViewHostMsg_PaintAtSize message was
1615 // processed, and the DIB is ready for use. |tag| has the same value that
1616 // the tag sent along with ViewMsg_PaintAtSize.
1621 // Sent to update part of the view. In response to this message, the host
1622 // generates a ViewMsg_UpdateRect_ACK message.
1624 ViewHostMsg_UpdateRect_Params)
1626 // Sent to unblock the browser's UI thread if it is waiting on an UpdateRect,
1627 // which may get delayed until the browser's UI unblocks.
1630 // Sent by the renderer when the parameters for vsync alignment have changed.
1635 // Sent by the renderer when accelerated compositing is enabled or disabled to
1636 // notify the browser whether or not is should do painting.
1640 // Acknowledges receipt of a ViewMsg_HandleInputEvent message.
1659 // Message sent from renderer to the browser when focus changes inside the
1660 // webpage. The parameter says whether the newly focused element needs
1661 // keyboard input (true for textfields, text areas and content editable divs).
1666 WebCursor)
1668 // Used to set a cookie. The cookie is set asynchronously, but will be
1669 // available to a subsequent ViewHostMsg_GetCookies request.
1675 // Used to get cookies for the given URL. This may block waiting for a
1676 // previous SetCookie message to be processed.
1682 // Used to get raw cookie information for the given URL. This may block
1683 // waiting for a previous SetCookie message to be processed.
1690 // Used to delete cookie for the given URL and name
1695 // Used to check if cookies are enabled for the given URL. This may block
1696 // waiting for a previous SetCookie message to be processed.
1702 // Used to get the list of plugins
1707 // Return information about a plugin for the given URL and MIME
1708 // type. If there is no matching plugin, |found| is false.
1709 // |actual_mime_type| is the actual mime type supported by the
1710 // found plugin.
1720 // A renderer sends this to the browser process when it wants to
1721 // create a plugin. The browser will create the plugin process if
1722 // necessary, and will return a handle to the channel on success.
1723 // On error an empty string is returned.
1732 #if defined(OS_WIN)
1738 #endif
1740 // Get the list of proxies to use for |url|, as a semicolon delimited list
1741 // of "<TYPE> <HOST>:<PORT>" | "DIRECT".
1747 // A renderer sends this to the browser process when it wants to create a
1748 // worker. The browser will create the worker process if necessary, and
1749 // will return the route id on success. On error returns MSG_ROUTING_NONE.
1751 ViewHostMsg_CreateWorker_Params,
1754 // This message is sent to the browser to see if an instance of this shared
1755 // worker already exists. If so, it returns exists == true. If a
1756 // non-empty name is passed, also validates that the url matches the url of
1757 // the existing worker. If a matching worker is found, the passed-in
1758 // document_id is associated with that worker, to ensure that the worker
1759 // stays alive until the document is detached.
1760 // The route_id returned can be used to forward messages to the worker via
1761 // ForwardToWorker if it exists, otherwise it should be passed in to any
1762 // future call to CreateWorker to avoid creating duplicate workers.
1764 ViewHostMsg_CreateWorker_Params,
1769 // A renderer sends this to the browser process when a document has been
1770 // detached. The browser will use this to constrain the lifecycle of worker
1771 // processes (SharedWorkers are shut down when their last associated document
1772 // is detached).
1776 // Wraps an IPC message that's destined to the worker on the renderer->browser
1777 // hop.
1781 // Tells the browser that a specific Appcache manifest in the current page
1782 // was accessed.
1787 // Initiates a download based on user actions like 'ALT+click'.
1793 // Used to go to the session history entry at the given offset (ie, -1 will
1794 // return the "back" item).
1798 // Sent from an inactive renderer for the browser to route to the active
1799 // renderer, instructing it to close.
1802 // Sent to the browser from an inactive renderer to post a message to the
1803 // active renderer.
1805 ViewMsg_PostMessage_Params)
1815 // Requests that the given URL be opened in the specified manner.
1818 // Notifies that the preferred size of the content changed.
1822 // Notifies that the scrollbars-visible state of the content changed.
1827 // Notifies that the pinned-to-side state of the content changed.
1832 // Notifies that the number of JavaScript scroll handlers changed.
1836 // Notifies whether there are JavaScript touche event handlers or not.
1840 // A message from HTML-based UI. When (trusted) Javascript calls
1841 // send(message, args), this message is sent to the browser.
1847 // Requests a snapshot of the given window.
1851 // A renderer sends this to the browser process when it wants to create a ppapi
1852 // plugin. The browser will create the plugin process if necessary, and will
1853 // return a handle to the channel on success.
1854 //
1855 // The plugin_child_id is the ChildProcessHost ID assigned in the browser
1856 // process. This ID is valid only in the context of the browser process and is
1857 // used to identify the proper process when the renderer notifies it that the
1858 // plugin is hung.
1859 //
1860 // On error an empty string and null handles are returned.
1866 // Notification that a plugin has created a new plugin instance. The parameters
1867 // indicate:
1868 // -The plugin process ID that we're creating the instance for.
1869 // -The instance ID of the instance being created.
1870 // -A PepperRendererInstanceData struct which contains properties from the
1871 // renderer which are associated with the plugin instance. This includes the
1872 // routing ID of the associated render view and the URL of plugin.
1873 // -Whether the plugin we're creating an instance for is external or internal.
1874 //
1875 // This message must be sync even though it returns no parameters to avoid
1876 // a race condition with the plugin process. The plugin process sends messages
1877 // to the browser that assume the browser knows about the instance. We need to
1878 // make sure that the browser actually knows about the instance before we tell
1879 // the plugin to run.
1881 ViewHostMsg_DidCreateOutOfProcessPepperInstance,
1887 // Notification that a plugin has destroyed an instance. This is the opposite of
1888 // the "DidCreate" message above.
1894 // A renderer sends this to the browser process when it wants to
1895 // create a ppapi broker. The browser will create the broker process
1896 // if necessary, and will return a handle to the channel on success.
1897 // On error an empty string is returned.
1898 // The browser will respond with ViewMsg_PpapiBrokerChannelCreated.
1904 // A renderer sends this to the browser process when it wants to access a PPAPI
1905 // broker. In contrast to ViewHostMsg_OpenChannelToPpapiBroker, this is called
1906 // for every connection.
1907 // The browser will respond with ViewMsg_PpapiBrokerPermissionResult.
1913 #if defined(USE_X11)
1914 // A renderer sends this when it needs a browser-side widget for
1915 // hosting a windowed plugin. id is the XID of the plugin window, for which
1916 // the container is created.
1920 // Destroy a plugin container previously created using CreatePluginContainer.
1921 // id is the XID of the plugin window corresponding to the container that is
1922 // to be destroyed.
1925 #endif
1927 // Send the tooltip text for the current mouse position to the browser.
1934 // Notification that the text selection has changed.
1935 // Note: The secound parameter is the character based offset of the string16
1936 // text in the document.
1942 // Notification that the selection bounds have changed.
1949 // Asks the browser to open the color chooser.
1954 // Asks the browser to end the color chooser.
1957 // Change the selected color in the color chooser.
1962 // Asks the browser to display the file chooser. The result is returned in a
1963 // ViewHost_RunFileChooserResponse message.
1967 // Asks the browser to enumerate a directory. This is equivalent to running
1968 // the file chooser in directory-enumeration mode and having the user select
1969 // the given directory. The result is returned in a
1970 // ViewMsg_EnumerateDirectoryResponse message.
1975 // Tells the browser to move the focus to the next (previous if reverse is
1976 // true) focusable element.
1980 // Required for updating text input state.
1984 // Message sent when the IME text composition range changes.
1989 // Required for cancelling an ongoing input method composition.
1992 // Tells the renderer to cancel an opened date/time dialog.
1995 // WebKit and JavaScript error messages to log to the console
1996 // or debugger UI.
2003 // Sent by the renderer process to indicate that a plugin instance has
2004 // crashed.
2008 // Displays a box to confirm that the user wants to navigate away from the
2009 // page. Replies true if yes, false otherwise, the reply string is ignored,
2010 // but is included so that we can use OnJavaScriptMessageBoxClosed.
2018 // Sent when the renderer process is done processing a DataReceived
2019 // message.
2023 // Sent when a provisional load on the main frame redirects.
2029 // Sent when the renderer changes the zoom level for a particular url, so the
2030 // browser can update its records. If remember is true, then url is used to
2031 // update the zoom level for all pages in that site. Otherwise, the render
2032 // view's id is used so that only the menu is updated.
2038 // Updates the minimum/maximum allowed zoom percent for this tab from the
2039 // default values. If |remember| is true, then the zoom setting is applied to
2040 // other pages in the site and is saved, otherwise it only applies to this
2041 // tab.
2047 // Notify the browser that this render process can or can't be suddenly
2048 // terminated.
2052 #if defined(OS_MACOSX)
2053 // Request that the browser load a font into shared memory for us.
2060 // On OSX, we cannot allocated shared memory from within the sandbox, so
2061 // this call exists for the renderer to ask the browser to allocate memory
2062 // on its behalf. We return a file descriptor to the POSIX shared memory.
2063 // If the |cache_in_browser| flag is |true|, then a copy of the shmem is kept
2064 // by the browser, and it is the caller's repsonsibility to send a
2065 // ViewHostMsg_FreeTransportDIB message in order to release the cached shmem.
2066 // In all cases, the caller is responsible for deleting the resulting
2067 // TransportDIB.
2073 // Since the browser keeps handles to the allocated transport DIBs, this
2074 // message is sent to tell the browser that it may release them when the
2075 // renderer is finished with them.
2079 // Informs the browser that a plugin has gained or lost focus.
2084 // Instructs the browser to start plugin IME.
2087 //---------------------------------------------------------------------------
2088 // Messages related to accelerated plugins
2090 // This is sent from the renderer to the browser to allocate a fake
2091 // PluginWindowHandle on the browser side which is used to identify
2092 // the plugin to the browser later when backing store is allocated
2093 // or reallocated. |opaque| indicates whether the plugin's output is
2094 // considered to be opaque, as opposed to translucent. This message
2095 // is reused for rendering the accelerated compositor's output.
2096 // |root| indicates whether the output is supposed to cover the
2097 // entire window.
2103 // Destroys a fake window handle previously allocated using
2104 // AllocateFakePluginWindowHandle.
2108 // This message, used on Mac OS X 10.5 and earlier (no IOSurface support),
2109 // is sent from the renderer to the browser on behalf of the plug-in
2110 // to indicate that a new backing store was allocated for that plug-in
2111 // instance.
2118 // This message, used on Mac OS X 10.6 and later (where IOSurface is
2119 // supported), is sent from the renderer to the browser on behalf of the
2120 // plug-in to indicate that a new backing store was allocated for that
2121 // plug-in instance.
2122 //
2123 // NOTE: the original intent was to pass a mach port as the IOSurface
2124 // identifier but it looks like that will be a lot of work. For now we pass an
2125 // ID from IOSurfaceGetID.
2132 // This message notifies the browser process that the plug-in
2133 // swapped the buffers associated with the given "window", which
2134 // should cause the browser to redraw the various plug-ins'
2135 // contents.
2139 #endif
2141 // This message is synthesized by GpuProcessHost to pass through a swap message
2142 // to the RenderWidgetHelper. This allows GetBackingStore to block for either a
2143 // software or GPU frame.
2156 // Opens a file asynchronously. The response returns a file descriptor
2157 // and an error code from base/platform_file.h.
2163 //---------------------------------------------------------------------------
2164 // Request for cryptographic operation messages:
2165 // These are messages from the renderer to the browser to perform a
2166 // cryptographic operation.
2168 // Asks the browser process to generate a keypair for grabbing a client
2169 // certificate from a CA (<keygen> tag), and returns the signed public
2170 // key and challenge string.
2177 // Message sent from the renderer to the browser to request that the browser
2178 // cache |data| associated with |url|.
2184 // Updates the content restrictions, i.e. to disable print/copy.
2188 // Brings up SaveAs... dialog to save specified URL.
2193 // Displays a JavaScript out-of-memory message in the infobar.
2196 // Register a new handler for URL requests with the given scheme.
2203 // Stores new inspector setting in the profile.
2204 // TODO(jam): this should be in the chrome module
2209 // Puts the browser into "tab fullscreen" mode for the sending renderer.
2210 // See the comment in chrome/browser/ui/browser.h for more details.
2214 // Send back a string to be recorded by UserMetrics.
2218 // Notifies the browser that the page was or was not saved as MHTML.
2233 // Notifies the browser of an event occurring in the media pipeline.
2237 // Requests to lock the mouse. Will result in a ViewMsg_LockMouse_ACK message
2238 // being sent back.
2239 // |privileged| is used by Pepper Flash. If this flag is set to true, we won't
2240 // pop up a bubble to ask for user permission or take mouse lock content into
2241 // account.
2247 // Requests to unlock the mouse. A ViewMsg_MouseLockLost message will be sent
2248 // whenever the mouse is unlocked (which may or may not be caused by
2249 // ViewHostMsg_UnlockMouse).
2252 // Following message is used to communicate the values received by the
2253 // callback binding the JS to Cpp.
2254 // An instance of browser that has an automation host listening to it can
2255 // have a javascript send a native value (string, number, boolean) to the
2256 // listener in Cpp. (DomAutomationController)
2261 // Sent to the browser when the renderer detects it is blocked on a pepper
2262 // plugin message for too long. This is also sent when it becomes unhung
2263 // (according to the value of is_hung). The browser can give the user the
2264 // option of killing the plugin.
2270 // Screen was rotated. Dispatched to the onorientationchange javascript API.
2274 // Chrome allows JavaScript calls to be routed across process boundaries. To
2275 // achieve this, each active RenderView in the source process has a swapped out
2276 // "mirror" in the target process. The active RenderView and its mirror
2277 // need to have identical frame tree structure, so calls originating in and
2278 // targeting subframes can be routed properly. This is achieved by each active
2279 // RenderView sending a ViewHostMsg_FrameTreeUpdated message to the browser,
2280 // which in turn sends the update to the corresponding mirror RenderView(s)
2281 // through the ViewMsg_UpdateFrameTree. We use best effort to keep these
2282 // trees synchronized across processes.
2283 //
2284 // When routing JavaScript calls across processes, the target information
2285 // is kept in the renderer process instead of the browser process. This design
2286 // was chosen because frame ids are allocated by the renderer process. If the
2287 // browser was to keep a mapping of the frame ids across processes, it would
2288 // require an extra IPC message with the newly allocated frame ids, as a
2289 // response to this particular message.
2290 //
2291 // The frame tree for a RenderView is serialized to JSON, so it can be sent to
2292 // the browser process. Each node in the tree is an object with three
2293 // properties:
2294 // * id - (integer) the frame identifier in this RenderView
2295 // * name - (string) the name of the frame, if one has been assigned
2296 // * subtree - an array of the same type of objects for each frame that is a
2297 // direct child of the current frame. This property can be omitted if
2298 // there are no direct child frames, so less data is transferred.
2299 //
2300 // This message must be sent on any events that modify the tree structure or
2301 // the names of any frames.
2305 #if defined(OS_ANDROID)
2306 // Response to ViewMsg_FindMatchRects.
2307 //
2308 // |version| will contain the current version number of the renderer's find
2309 // match list (incremented whenever they change), which should be passed in the
2310 // next call to ViewMsg_FindMatchRects.
2311 //
2312 // |rects| will either contain a list of the enclosing rects of all matches
2313 // found by the most recent Find operation, or will be empty if |version| is not
2314 // greater than the |current_version| passed to ViewMsg_FindMatchRects (hence
2315 // your locally cached rects should still be valid). The rect coords will be
2316 // custom normalized fractions of the document size. The rects will be sorted by
2317 // frame traversal order starting in the main frame, then by dom order.
2318 //
2319 // |active_rect| will contain the bounding box of the active find-in-page match
2320 // marker, in similarly normalized coords (or an empty rect if there isn't one).
2326 // Start an android intent with the given URI.
2329 #endif
2331 // Notifies that multiple touch targets may have been pressed, and to show
2332 // the disambiguation popup.
2338 // Sent by the renderer process to check whether client 3D APIs
2339 // (Pepper 3D, WebGL) are explicitly blocked.
2346 // Sent by the renderer process to indicate that a context was lost by
2347 // client 3D content (Pepper 3D, WebGL) running on the page at the
2348 // given URL.
2354 #if defined(OS_WIN)
2355 // Request that the given font characters be loaded by the browser so it's
2356 // cached by the OS. Please see RenderMessageFilter::OnPreCacheFontCharacters
2357 // for details.
2361 #endif