| // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #ifndef CONTENT_PUBLIC_RENDERER_RENDER_VIEW_H_ |
| #define CONTENT_PUBLIC_RENDERER_RENDER_VIEW_H_ |
| |
| #include <stddef.h> |
| |
| #include <string> |
| |
| #include "base/strings/string16.h" |
| #include "build/build_config.h" |
| #include "content/common/content_export.h" |
| #include "ipc/ipc_sender.h" |
| #include "ui/gfx/native_widget_types.h" |
| |
| namespace blink { |
| class WebView; |
| } // namespace blink |
| |
| namespace content { |
| |
| class RenderFrame; |
| class RenderViewVisitor; |
| struct WebPreferences; |
| |
| // RenderView corresponds to the content container of a renderer's subset |
| // of the frame tree. A frame tree that spans multiple renderers will have a |
| // RenderView in each renderer, containing the local frames that belong to |
| // that renderer. The RenderView holds non-frame-related state that is |
| // replicated across all renderers, and is a fairly shallow object. |
| // Generally, most APIs care about state related to the document content which |
| // should be accessed through RenderFrame instead. |
| // |
| // WARNING: Historically RenderView was the path to get to the main frame, |
| // and the entire frame tree, but that is no longer the case. Usually |
| // RenderFrame is a more appropriate surface for new code, unless the code is |
| // agnostic of frames and document content or structure. For more context, |
| // please see https://crbug.com/467770 and |
| // https://www.chromium.org/developers/design-documents/site-isolation. |
| class CONTENT_EXPORT RenderView : public IPC::Sender { |
| public: |
| // Returns the RenderView containing the given WebView. |
| static RenderView* FromWebView(blink::WebView* webview); |
| |
| // Returns the RenderView for the given routing ID. |
| static RenderView* FromRoutingID(int routing_id); |
| |
| // Returns the number of live RenderView instances in this process. |
| static size_t GetRenderViewCount(); |
| |
| // Visit all RenderViews with a live WebView (i.e., RenderViews that have |
| // been closed but not yet destroyed are excluded). |
| static void ForEach(RenderViewVisitor* visitor); |
| |
| // Applies WebKit related preferences to this view. |
| static void ApplyWebPreferences(const WebPreferences& preferences, |
| blink::WebView* web_view); |
| |
| // Returns the main RenderFrame. |
| virtual RenderFrame* GetMainRenderFrame() = 0; |
| |
| // Get the routing ID of the view. |
| virtual int GetRoutingID() = 0; |
| |
| // Returns the page's zoom level for the render view. |
| virtual float GetZoomLevel() = 0; |
| |
| // Gets WebKit related preferences associated with this view. |
| virtual const WebPreferences& GetWebkitPreferences() = 0; |
| |
| // Overrides the WebKit related preferences associated with this view. Note |
| // that the browser process may update the preferences at any time. |
| virtual void SetWebkitPreferences(const WebPreferences& preferences) = 0; |
| |
| // Returns the associated WebView. May return NULL when the view is closing. |
| virtual blink::WebView* GetWebView() = 0; |
| |
| // Whether content state (such as form state, scroll position and page |
| // contents) should be sent to the browser immediately. This is normally |
| // false, but set to true by some tests. |
| virtual bool GetContentStateImmediately() = 0; |
| |
| // Returns |renderer_preferences_.accept_languages| value. |
| virtual const std::string& GetAcceptLanguages() = 0; |
| |
| protected: |
| ~RenderView() override {} |
| |
| private: |
| // This interface should only be implemented inside content. |
| friend class RenderViewImpl; |
| RenderView() {} |
| }; |
| |
| } // namespace content |
| |
| #endif // CONTENT_PUBLIC_RENDERER_RENDER_VIEW_H_ |