blob: 935a8b08e02392b7fcf0a2ae7580694dde1c7b2e (
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
|
// Copyright 2015 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 COMPONENTS_BUBBLE_BUBBLE_MANAGER_H_
#define COMPONENTS_BUBBLE_BUBBLE_MANAGER_H_
#include <memory>
#include <vector>
#include "base/macros.h"
#include "base/observer_list.h"
#include "base/threading/thread_checker.h"
#include "components/bubble/bubble_close_reason.h"
#include "components/bubble/bubble_reference.h"
class BubbleDelegate;
namespace content {
class RenderFrameHost;
}
// Inherit from BubbleManager to show, update, and close bubbles.
// Any class that inherits from BubbleManager should capture any events that
// should dismiss a bubble or update its anchor point.
// This class assumes that we won't be showing a lot of bubbles simultaneously.
// TODO(hcarmona): Handle simultaneous bubbles. http://crbug.com/366937
class BubbleManager {
public:
// This interface should be used to observe the manager. This is useful when
// collecting metrics.
class BubbleManagerObserver {
public:
BubbleManagerObserver() {}
virtual ~BubbleManagerObserver() {}
// Called when a bubble is asked to be displayed but never shown.
// ex: a bubble chained on destruction will not be shown.
virtual void OnBubbleNeverShown(BubbleReference bubble) = 0;
// Called when a bubble is closed. The reason for closing is provided.
virtual void OnBubbleClosed(BubbleReference bubble,
BubbleCloseReason reason) = 0;
private:
DISALLOW_COPY_AND_ASSIGN(BubbleManagerObserver);
};
// Should be instantiated on the UI thread.
BubbleManager();
virtual ~BubbleManager();
// Shows a specific bubble and returns a reference to it.
// This reference should be used through the BubbleManager.
BubbleReference ShowBubble(std::unique_ptr<BubbleDelegate> bubble);
// Notify a bubble of an event that might trigger close.
// Returns true if the bubble was actually closed.
bool CloseBubble(BubbleReference bubble, BubbleCloseReason reason);
// Notify all bubbles of an event that might trigger close.
void CloseAllBubbles(BubbleCloseReason reason);
// Notify all bubbles that their anchor or parent may have changed.
void UpdateAllBubbleAnchors();
// Add an observer for this BubbleManager.
void AddBubbleManagerObserver(BubbleManagerObserver* observer);
// Remove an observer from this BubbleManager.
void RemoveBubbleManagerObserver(BubbleManagerObserver* observer);
// Returns the number of bubbles currently being managed.
size_t GetBubbleCountForTesting() const;
protected:
// Will close any open bubbles and prevent new ones from being shown.
void FinalizePendingRequests();
// Closes bubbles that declare |frame| as their owner, with
// a reason of BUBBLE_CLOSE_FRAME_DESTROYED.
void CloseBubblesOwnedBy(const content::RenderFrameHost* frame);
private:
friend class ExtensionInstalledBubbleBrowserTest;
enum ManagerState {
SHOW_BUBBLES,
NO_MORE_BUBBLES,
ITERATING_BUBBLES,
};
// All matching bubbles will get a close event for the specified |reason|. Any
// bubble that is closed will also be deleted. Bubbles match if 1) |bubble| is
// null or it refers to the bubble, and 2) |owner| is null or owns the bubble.
// At most one can be non-null.
bool CloseAllMatchingBubbles(BubbleController* bubble,
const content::RenderFrameHost* owner,
BubbleCloseReason reason);
base::ObserverList<BubbleManagerObserver> observers_;
// Verify that functions that affect the UI are done on the same thread.
base::ThreadChecker thread_checker_;
// Determines what happens to a bubble when |ShowBubble| is called.
ManagerState manager_state_;
// The bubbles that are being managed.
std::vector<std::unique_ptr<BubbleController>> controllers_;
DISALLOW_COPY_AND_ASSIGN(BubbleManager);
};
#endif // COMPONENTS_BUBBLE_BUBBLE_MANAGER_H_
|
