blob: fbd64f3000493732724b6c9816480e46c9eca6cc (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
// 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_
|
