File: browser_tab_strip_tracker.h

package info (click to toggle)
chromium 138.0.7204.157-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,864 kB
  • sloc: cpp: 34,936,859; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,967; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (70 lines) | stat: -rw-r--r-- 3,147 bytes parent folder | download | duplicates (4)
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
// Copyright 2015 The Chromium Authors
// 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_TAB_STRIP_TRACKER_H_
#define CHROME_BROWSER_UI_BROWSER_TAB_STRIP_TRACKER_H_

#include "base/memory/raw_ptr.h"
#include "chrome/browser/ui/browser_list_observer.h"

class BrowserTabStripTrackerDelegate;
class TabStripModelObserver;

// BrowserTabStripTracker attaches a TabStripModelObserver to a subset of
// pre-existing and future Browsers. The subset of Browsers that are tracked is
// determined by an optional BrowserTabStripTrackerDelegate.
//
// This class is typically not the right helper to use. Its primary purpose is
// to hook up a TabStripModelObserver across multiple TabStripModels. As per the
// documentation for TabStripModelObserver, only features that need to interact
// with the tab strip like tab groups and tab search should use
// TabStripModelObserver. Other features should use TabInterface and
// TabFeatures. Furthermore, this class mixes state across multiple
// TabStripModels. This is typically not desirable and instead features should
// hold state on a per-browser-window basis, using BrowserWindowFeatures.
class BrowserTabStripTracker : public BrowserListObserver {
 public:
  // |tab_strip_model_observer| is a non-nullptr TabStripModelObserver
  // registered on tracked Browsers. |delegate| determines which Browsers are
  // tracked. If nullptr, all Browsers are tracked.
  BrowserTabStripTracker(TabStripModelObserver* tab_strip_model_observer,
                         BrowserTabStripTrackerDelegate* delegate);

  BrowserTabStripTracker(const BrowserTabStripTracker&) = delete;
  BrowserTabStripTracker& operator=(const BrowserTabStripTracker&) = delete;

  ~BrowserTabStripTracker() override;

  // Registers the TabStripModelObserver on existing tracked Browsers and starts
  // observing Browser creation to register the TabStripModelObserver on future
  // tracked Browsers. When the TabStripModelObserver is registered on an
  // existing of future Browser, OnTabStripModelChanged() is invoked to indicate
  // the initial state of the Browser. If a delegate needs to differentiate
  // between Browsers observed by way of Init() vs. a Browser added after the
  // fact use is_processing_initial_browsers().
  void Init();

  // Returns true if processing an existing Browser in Init().
  bool is_processing_initial_browsers() const {
    return is_processing_initial_browsers_;
  }

 private:
  // Returns true if a TabStripModelObserver should be added to |browser|.
  bool ShouldTrackBrowser(Browser* browser);

  // If ShouldTrackBrowser() returns true for |browser| then a
  // TabStripModelObserver is attached.
  void MaybeTrackBrowser(Browser* browser);

  // BrowserListObserver:
  void OnBrowserAdded(Browser* browser) override;
  void OnBrowserRemoved(Browser* browser) override;

  raw_ptr<TabStripModelObserver> const tab_strip_model_observer_;
  raw_ptr<BrowserTabStripTrackerDelegate> const delegate_;
  bool is_processing_initial_browsers_;
};

#endif  // CHROME_BROWSER_UI_BROWSER_TAB_STRIP_TRACKER_H_