blob: 55b16e94981faa3d05af42f399aee2dfc8d6021e (
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
100
101
102
103
104
105
106
107
108
|
// Copyright (c) 2006-2008 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 CHROME_BROWSER_WEB_CONTENTS_VIEW_H_
#define CHROME_BROWSER_WEB_CONTENTS_VIEW_H_
#include <windows.h>
#include <string>
#include "base/basictypes.h"
#include "base/gfx/rect.h"
#include "base/gfx/size.h"
class InfoBarView;
class RenderViewHost;
class RenderWidgetHostHWND;
struct ViewHostMsg_ContextMenu_Params;
class WebContents;
struct WebDropData;
class WebKeyboardEvent;
// The WebContentsView is an interface that is implemented by the platform-
// dependent web contents views. The WebContents uses this interface to talk to
// them.
class WebContentsView {
public:
virtual ~WebContentsView() {}
virtual void CreateView(HWND parent_hwnd,
const gfx::Rect& initial_bounds) = 0;
// Sets up the View that holds the rendered web page, receives messages for
// it and contains page plugins.
virtual RenderWidgetHostHWND* CreatePageView(
RenderViewHost* render_view_host) = 0;
// Returns the HWND that contains the contents of the tab.
// TODO(brettw) this should not be necessary in this cross-platform interface.
virtual HWND GetContainerHWND() const = 0;
// Returns the HWND with the main content of the tab (i.e. the main render
// view host, though there may be many popups in the tab as children of the
// container HWND).
// TODO(brettw) this should not be necessary in this cross-platform interface.
virtual HWND GetContentHWND() const = 0;
// Computes the rectangle for the native widget that contains the contents of
// the tab relative to its parent.
virtual void GetContainerBounds(gfx::Rect *out) const = 0;
// Helper function for GetContainerBounds. Most callers just want to know the
// size, and this makes it more clear.
gfx::Size GetContainerSize() const {
gfx::Rect rc;
GetContainerBounds(&rc);
return gfx::Size(rc.width(), rc.height());
}
// The user started dragging content of the specified type within the tab.
// Contextual information about the dragged content is supplied by drop_data.
virtual void StartDragging(const WebDropData& drop_data) = 0;
// Enumerate and 'un-parent' any plugin windows that are children of us.
virtual void DetachPluginWindows() = 0;
// Displays the given error in the info bar. A new info bar will be shown if
// one is not shown already. The new error text will replace any existing
// text shown by this same function.
//
// Note: this replacement behavior is historical; crashed plugin and out of
// JS memory used the same message. This seems reasonable, but it may not be
// the best thing for all error messages.
virtual void DisplayErrorInInfoBar(const std::wstring& text) = 0;
// Set/get whether or not the info bar is visible. See also the ChromeFrame
// method InfoBarVisibilityChanged and TabContents::IsInfoBarVisible.
virtual void SetInfoBarVisible(bool visible) = 0;
virtual bool IsInfoBarVisible() const = 0;
// Create the InfoBarView and returns it if none has been created.
// Just returns existing InfoBarView if it is already created.
// TODO(brettw) this probably shouldn't be here. There should be methods to
// tell us what we need to display instead.
virtual InfoBarView* GetInfoBarView() = 0;
// The page wants to update the mouse cursor during a drag & drop operation.
// |is_drop_target| is true if the mouse is over a valid drop target.
virtual void UpdateDragCursor(bool is_drop_target) = 0;
// Runs a context menu with the given parameters from the renderer.
virtual void ShowContextMenu(
const ViewHostMsg_ContextMenu_Params& params) = 0;
// Posts the given keyboard message and handles it in the native way. This
// is called when the renderer reflects a keyboard message back up to us for
// default handling.
virtual void HandleKeyboardEvent(const WebKeyboardEvent& event) = 0;
protected:
WebContentsView() {} // Abstract interface.
private:
DISALLOW_COPY_AND_ASSIGN(WebContentsView);
};
#endif // CHROME_BROWSER_WEB_CONTENTS_VIEW_H_
|