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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
// Copyright (c) 2011 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_BROWSER_TAB_CONTENTS_TAB_CONTENTS_OBSERVER_H_
#define CONTENT_BROWSER_TAB_CONTENTS_TAB_CONTENTS_OBSERVER_H_
#include "base/process_util.h"
#include "content/browser/tab_contents/navigation_controller.h"
#include "content/common/content_export.h"
#include "content/public/common/page_transition_types.h"
#include "ipc/ipc_channel.h"
#include "webkit/glue/window_open_disposition.h"
class RenderViewHost;
struct ViewHostMsg_FrameNavigate_Params;
// An observer API implemented by classes which are interested in various page
// load events from TabContents. They also get a chance to filter IPC messages.
class CONTENT_EXPORT TabContentsObserver : public IPC::Channel::Listener,
public IPC::Message::Sender {
public:
virtual void RenderViewCreated(RenderViewHost* render_view_host);
virtual void RenderViewDeleted(RenderViewHost* render_view_host);
virtual void RenderViewReady();
virtual void RenderViewGone(base::TerminationStatus status);
virtual void NavigateToPendingEntry(
const GURL& url,
NavigationController::ReloadType reload_type);
virtual void DidNavigateMainFrame(
const content::LoadCommittedDetails& details,
const ViewHostMsg_FrameNavigate_Params& params);
virtual void DidNavigateAnyFrame(
const content::LoadCommittedDetails& details,
const ViewHostMsg_FrameNavigate_Params& params);
// |render_view_host| is the RenderViewHost for which the provisional load is
// happening.
virtual void DidStartProvisionalLoadForFrame(
int64 frame_id,
bool is_main_frame,
const GURL& validated_url,
bool is_error_page,
RenderViewHost* render_view_host);
virtual void ProvisionalChangeToMainFrameUrl(const GURL& url,
const GURL& opener_url);
virtual void DidCommitProvisionalLoadForFrame(
int64 frame_id,
bool is_main_frame,
const GURL& url,
content::PageTransition transition_type);
virtual void DidFailProvisionalLoad(int64 frame_id,
bool is_main_frame,
const GURL& validated_url,
int error_code,
const string16& error_description);
virtual void DocumentAvailableInMainFrame();
virtual void DocumentLoadedInFrame(int64 frame_id);
virtual void DidFinishLoad(int64 frame_id);
virtual void DidGetUserGesture();
virtual void DidGetIgnoredUIEvent();
virtual void DidBecomeSelected();
virtual void DidStartLoading();
virtual void DidStopLoading();
virtual void StopNavigation();
virtual void DidOpenURL(const GURL& url,
const GURL& referrer,
WindowOpenDisposition disposition,
content::PageTransition transition);
virtual void DidOpenRequestedURL(TabContents* new_contents,
const GURL& url,
const GURL& referrer,
WindowOpenDisposition disposition,
content::PageTransition transition,
int64 source_frame_id);
virtual void AppCacheAccessed(const GURL& manifest_url,
bool blocked_by_policy);
#if 0
// For unifying with delegate...
// Notifies the delegate that this contents is starting or is done loading
// some resource. The delegate should use this notification to represent
// loading feedback. See TabContents::IsLoading()
virtual void LoadingStateChanged(TabContents* contents) { }
// Called to inform the delegate that the tab content's navigation state
// changed. The |changed_flags| indicates the parts of the navigation state
// that have been updated, and is any combination of the
// |TabContents::InvalidateTypes| bits.
virtual void NavigationStateChanged(const TabContents* source,
unsigned changed_flags) { }
#endif
// IPC::Message::Sender implementation.
virtual bool Send(IPC::Message* message) OVERRIDE;
int routing_id() const;
protected:
// Use this constructor when the object is tied to a single TabContents for
// its entire lifetime.
explicit TabContentsObserver(TabContents* tab_contents);
// Use this constructor when the object wants to observe a TabContents for
// part of its lifetime. It can then call Observe() to start and stop
// observing.
TabContentsObserver();
virtual ~TabContentsObserver();
// Start observing a different TabContents; used with the default constructor.
void Observe(TabContents* tab_contents);
// Invoked when the TabContents is being destroyed. Gives subclasses a chance
// to cleanup. At the time this is invoked |tab_contents()| returns NULL.
// It is safe to delete 'this' from here.
virtual void TabContentsDestroyed(TabContents* tab);
// IPC::Channel::Listener implementation.
virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
TabContents* tab_contents() const { return tab_contents_; }
private:
friend class TabContents;
// Invoked from TabContents. Invokes TabContentsDestroyed and NULL out
// |tab_contents_|.
void TabContentsDestroyed();
TabContents* tab_contents_;
DISALLOW_COPY_AND_ASSIGN(TabContentsObserver);
};
#endif // CONTENT_BROWSER_TAB_CONTENTS_TAB_CONTENTS_OBSERVER_H_
|
