Add BubbleManager to manage bubbles and ChromeBubbleManager for events.

components/bubble/bubble_manager.h

+// 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 "base/memory/scoped_ptr.h"
+#include "base/memory/scoped_vector.h"
+#include "base/memory/weak_ptr.h"
+#include "components/bubble/bubble_delegate.h"
+
+class BubbleController;
+
+typedef base::WeakPtr<BubbleController> BubbleReference;
+
+// 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:
+  virtual ~BubbleManager();
+
+  // Shows a specific bubble and returns a reference to it.
+  // This reference should be used through the BubbleManager.
+  BubbleReference ShowBubble(scoped_ptr<BubbleDelegate> bubble);
+
+  // Close a specific bubble with a given reason.

[msw, 2015/08/21 01:48:31]

nit:  // Notify a specific bubble of an event that might trigger close.

[hcarmona, 2015/08/25 02:13:37]

Done.

+  // Returns true if the bubble was actually closed.
+  bool CloseBubble(BubbleReference bubble, BubbleCloseReason reason);
+
+  // Notify all bubbles that their anchor or parent may have changed.
+  void UpdateAllBubbleAnchors();
+
+ protected:
+  BubbleManager();
+
+  // Notify all bubbles of a potential close event.

[msw, 2015/08/21 01:48:31]

  // Notify all bubbles of an event that might trigger close.

[hcarmona, 2015/08/25 02:13:37]

Done.

+  void CloseAllBubbles(BubbleCloseReason reason);
+
+ private:
+  // Show any bubbles that were added to show_queue_.

[msw, 2015/08/21 01:48:31]

nit: |show_queue_|

[hcarmona, 2015/08/25 02:13:37]

Done.

+  void ShowPendingBubbles();
+
+  // This will be false once the BubbleManager is being destroyed to prevent

[msw, 2015/08/21 01:48:31]

nit: consider something like "A flag used to delay new bubbles from showing
while another bubble is closing, and prohibits bubbles from showing during
manager teardown."

[hcarmona, 2015/08/25 02:13:37]

Renamed to |manager_state_| and updated the comment.

+  // bubbles from adding additional bubbles when they're being cleaned up.
+  bool can_show_bubbles_;
+
+  // The bubbles that are being managed.
+  ScopedVector<BubbleController> controllers_;
+
+  // If a closing bubble needs to show another bubble, it will go here.

[msw, 2015/08/21 01:48:31]

nit: // The bubbles queued to be shown when possible.

[hcarmona, 2015/08/25 02:13:37]

Done.

+  scoped_ptr<ScopedVector<BubbleController>> show_queue_;

[msw, 2015/08/21 01:48:31]

Consider keeping this as a ScopedVector that's always valid, and use
|can_show_bubbles_| as a toggle for adding controllers to |controllers_| or
|show_queue_|.

[hcarmona, 2015/08/25 02:13:37]

Done.

+
+  DISALLOW_COPY_AND_ASSIGN(BubbleManager);
+};
+
+#endif  // COMPONENTS_BUBBLE_BUBBLE_MANAGER_H_