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
|
// 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 "content/browser/tab_contents/navigation_controller.h"
#include "content/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 TabContentsObserver : public IPC::Channel::Listener,
public IPC::Message::Sender {
public:
virtual void RenderViewCreated(RenderViewHost* render_view_host);
virtual void NavigateToPendingEntry(
const GURL& url,
NavigationController::ReloadType reload_type);
virtual void DidNavigateMainFramePostCommit(
const content::LoadCommittedDetails& details,
const ViewHostMsg_FrameNavigate_Params& params);
virtual void DidNavigateAnyFramePostCommit(
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,
bool has_opener_set);
virtual void DidCommitProvisionalLoadForFrame(
int64 frame_id,
bool is_main_frame,
const GURL& url,
PageTransition::Type transition_type);
virtual void DidFailProvisionalLoad(int64 frame_id,
bool is_main_frame,
const GURL& validated_url,
int error_code);
virtual void DocumentLoadedInFrame(int64 frame_id);
virtual void DidFinishLoad(int64 frame_id);
virtual void DidGetUserGesture();
virtual void DidBecomeSelected();
virtual void DidStartLoading();
virtual void DidStopLoading();
virtual void RenderViewGone();
virtual void StopNavigation();
virtual void DidOpenURL(const GURL& url,
const GURL& referrer,
WindowOpenDisposition disposition,
PageTransition::Type transition);
#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);
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);
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_;
// The routing ID of the associated TabContents.
int routing_id_;
DISALLOW_COPY_AND_ASSIGN(TabContentsObserver);
};
#endif // CONTENT_BROWSER_TAB_CONTENTS_TAB_CONTENTS_OBSERVER_H_
|
