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
|
// 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_TAB_CONTENTS_TAB_CONTENTS_ITERATOR_H_
#define CHROME_BROWSER_UI_TAB_CONTENTS_TAB_CONTENTS_ITERATOR_H_
#include <set>
#include "base/basictypes.h"
#include "chrome/browser/ui/browser_iterator.h"
namespace content {
class WebContents;
}
// Iterates through all web view hosts in all browser windows. Because the
// renderers act asynchronously, getting a host through this interface does
// not guarantee that the renderer is ready to go. Doing anything to affect
// browser windows or tabs while iterating may cause incorrect behavior.
//
// Example:
// for (TabContentsIterator iterator; !iterator.done(); iterator.Next()) {
// WebContents* cur = *iterator;
// -or-
// iterator->OperationOnWebContents();
// ...
// }
class TabContentsIterator {
public:
TabContentsIterator();
// Returns true if we are past the last Browser.
bool done() const { return cur_ == NULL; }
// Returns the Browser instance associated with the current
// WebContents. Valid as long as !done().
Browser* browser() const {
if (!browser_iterator_.done())
return *browser_iterator_;
return NULL;
}
// Returns the current WebContents, valid as long as !done().
content::WebContents* operator->() const {
return cur_;
}
content::WebContents* operator*() const {
return cur_;
}
// Loads the next host into |cur_|. This is designed so that for the initial
// call from the constructor, when browser_iterator_ points to the first
// Browser and web_view_index_ is -1, it will fill the first host.
void Next();
private:
// Tab index into the current Browser of the current web view.
int web_view_index_;
// Current WebContents, or NULL if we're at the end of the list. This
// can be extracted given the browser iterator and index, but it's nice to
// cache this since the caller may access the current host many times.
content::WebContents* cur_;
// An iterator over all the browsers.
chrome::BrowserIterator browser_iterator_;
DISALLOW_COPY_AND_ASSIGN(TabContentsIterator);
};
#endif // CHROME_BROWSER_UI_TAB_CONTENTS_TAB_CONTENTS_ITERATOR_H_
|
