blob: 605028013ed1ad9ddacc0609d3d503f7f9968d79 (
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
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
138
139
140
141
142
143
144
145
146
147
148
149
150
|
// 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 CHROME_BROWSER_UI_BROWSER_LIST_H_
#define CHROME_BROWSER_UI_BROWSER_LIST_H_
#include <vector>
#include "base/gtest_prod_util.h"
#include "ui/gfx/native_widget_types.h"
class Browser;
class Profile;
namespace browser {
class BrowserActivityObserver;
#if defined(OS_MACOSX)
Browser* GetLastActiveBrowser();
#endif
#if defined(TOOLKIT_GTK)
class ExtensionInstallDialog;
#endif
}
namespace chrome {
namespace internal {
void NotifyNotDefaultBrowserCallback();
}
}
#if defined(OS_CHROMEOS)
namespace chromeos {
class ScreenLocker;
}
#endif
namespace content {
class WebContents;
}
#if defined(USE_ASH)
content::WebContents* GetActiveWebContents();
#endif
// Stores a list of all Browser objects.
class BrowserList {
public:
typedef std::vector<Browser*> BrowserVector;
typedef BrowserVector::iterator iterator;
typedef BrowserVector::const_iterator const_iterator;
typedef BrowserVector::const_reverse_iterator const_reverse_iterator;
// It is not allowed to change the global window list (add or remove any
// browser windows while handling observer callbacks.
class Observer {
public:
// Called immediately after a browser is added to the list
virtual void OnBrowserAdded(Browser* browser) {}
// Called immediately after a browser is removed from the list
virtual void OnBrowserRemoved(Browser* browser) {}
// Called immediately after a browser is set active (SetLastActive)
virtual void OnBrowserSetLastActive(Browser* browser) {}
protected:
virtual ~Observer() {}
};
// Adds and removes browsers from the global list. The browser object should
// be valid BEFORE these calls (for the benefit of observers), so notify and
// THEN delete the object.
static void AddBrowser(Browser* browser);
static void RemoveBrowser(Browser* browser);
static void AddObserver(Observer* observer);
static void RemoveObserver(Observer* observer);
// Called by Browser objects when their window is activated (focused). This
// allows us to determine what the last active Browser was.
static void SetLastActive(Browser* browser);
// Closes all browsers for |profile|.
static void CloseAllBrowsersWithProfile(Profile* profile);
// Browsers are added to the list before they have constructed windows,
// so the |window()| member function may return NULL.
static const_iterator begin();
static const_iterator end();
static bool empty();
static size_t size();
// Returns iterated access to list of open browsers ordered by when
// they were last active. The underlying data structure is a vector
// and we push_back on recent access so a reverse iterator gives the
// latest accessed browser first.
static const_reverse_iterator begin_last_active();
static const_reverse_iterator end_last_active();
// Returns true if at least one incognito session is active.
static bool IsOffTheRecordSessionActive();
// Returns true if at least one incognito session is active for |profile|.
static bool IsOffTheRecordSessionActiveForProfile(Profile* profile);
private:
// DO NOT ADD MORE FRIENDS TO THIS LIST. This list should be reduced over
// time by wiring context through to the relevant code rather than using
// GetLastActive().
friend class BrowserView;
friend class ChromeShellDelegate;
friend class NetworkProfileBubble;
friend class PrintPreviewHandler;
friend class SelectFileDialogExtension;
friend class StartupBrowserCreatorImpl;
friend class TaskManager;
friend class WindowSizer;
friend class browser::BrowserActivityObserver;
#if defined(OS_CHROMEOS)
friend class chromeos::ScreenLocker;
#endif
#if defined(OS_MACOSX)
friend Browser* browser::GetLastActiveBrowser();
#endif
#if defined(USE_ASH)
friend content::WebContents* GetActiveWebContents();
#endif
friend void chrome::internal::NotifyNotDefaultBrowserCallback();
// DO NOT ADD MORE FRIENDS TO THIS LIST.
// Returns the Browser object whose window was most recently active. If the
// most recently open Browser's window was closed, returns the first Browser
// in the list. If no Browsers exist, returns NULL.
//
// WARNING: this is NULL until a browser becomes active. If during startup
// a browser does not become active (perhaps the user launches Chrome, then
// clicks on another app before the first browser window appears) then this
// returns NULL.
// WARNING #2: this will always be NULL in unit tests run on the bots.
// THIS FUNCTION IS PRIVATE AND NOT TO BE USED AS A REPLACEMENT FOR RELEVANT
// CONTEXT.
static Browser* GetLastActive();
// Helper method to remove a browser instance from a list of browsers
static void RemoveBrowserFrom(Browser* browser, BrowserVector* browser_list);
};
#endif // CHROME_BROWSER_UI_BROWSER_LIST_H_
|
