| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef CHROME_BROWSER_UI_VIEWS_BROWSER_BUBBLE_H_ | |
| 6 #define CHROME_BROWSER_UI_VIEWS_BROWSER_BUBBLE_H_ | |
| 7 #pragma once | |
| 8 | |
| 9 #include "ui/views/bubble/bubble_border.h" | |
| 10 #include "ui/views/widget/widget.h" | |
| 11 #include "views/view.h" | |
| 12 | |
| 13 class Browser; | |
| 14 class BrowserBubbleHost; | |
| 15 | |
| 16 // A class for creating a floating window that is "attached" to a particular | |
| 17 // Browser. If you don't install a delegate, the bubble will hide | |
| 18 // automatically when the browser moves. The bubble is only shown manually. | |
| 19 // Users are expected to delete the bubble when finished with it. | |
| 20 // Class assumes that RTL related mirroring is done by the view. | |
| 21 class BrowserBubble { | |
| 22 public: | |
| 23 // Delegate to browser bubble events. | |
| 24 class Delegate { | |
| 25 public: | |
| 26 // Called when the Browser Window that this bubble is attached to moves. | |
| 27 virtual void BubbleBrowserWindowMoved(BrowserBubble* bubble) {} | |
| 28 | |
| 29 // Called with the Browser Window that this bubble is attached to is | |
| 30 // about to close. | |
| 31 virtual void BubbleBrowserWindowClosing(BrowserBubble* bubble) {} | |
| 32 | |
| 33 // Called when the bubble became active / got focus. | |
| 34 virtual void BubbleGotFocus(BrowserBubble* bubble) {} | |
| 35 | |
| 36 // Called when the bubble became inactive / lost focus. | |
| 37 // |lost_focus_to_child| is true when a child window became active. | |
| 38 virtual void BubbleLostFocus(BrowserBubble* bubble, | |
| 39 bool lost_focus_to_child) {} | |
| 40 }; | |
| 41 | |
| 42 // Note that the bubble will size itself to the preferred size of |view| plus | |
| 43 // insets of bubble border. |view| is the embedded view, |browser| is the | |
| 44 // browser that the bubble is being positioned relative to, |relative_to| is | |
| 45 // the location that the bubble is showing relative to in screen coordinates, | |
| 46 // e.g. if the buuble is showing for a toolbar button, |relative_to| usually | |
| 47 // would be the bounds of the toolbar button in screen coordiates, | |
| 48 // |arrow_location| is the location where the arrow should on the bubble. | |
| 49 BrowserBubble(Browser* browser, | |
| 50 views::View* view, | |
| 51 const gfx::Rect& relative_to, | |
| 52 views::BubbleBorder::ArrowLocation arrow_location); | |
| 53 virtual ~BrowserBubble(); | |
| 54 | |
| 55 // Call manually if you need to detach the bubble from tracking the browser's | |
| 56 // position. Note that you must call this manually before deleting this | |
| 57 // object since it can't be safely called from the destructor. | |
| 58 void DetachFromBrowser(); | |
| 59 | |
| 60 // Normally called automatically during construction, but if DetachFromBrowser | |
| 61 // has been called manually, then this call will reattach. | |
| 62 void AttachToBrowser(); | |
| 63 bool attached() const { return attached_; } | |
| 64 | |
| 65 // Get/Set the delegate. | |
| 66 Delegate* delegate() const { return delegate_; } | |
| 67 void set_delegate(Delegate* del) { delegate_ = del; } | |
| 68 | |
| 69 // Notifications from BrowserBubbleHost. | |
| 70 // With no delegate, both of these default to Hiding the bubble. | |
| 71 virtual void BrowserWindowMoved(); | |
| 72 virtual void BrowserWindowClosing(); | |
| 73 | |
| 74 // Show or hide the bubble. | |
| 75 virtual void Show(bool activate); | |
| 76 virtual void Hide(); | |
| 77 | |
| 78 // The contained view. | |
| 79 views::View* view() const { return view_; } | |
| 80 | |
| 81 // Set the bounds of the bubble relative to the browser window. | |
| 82 void SetBounds(int x, int y, int w, int h); | |
| 83 void MoveTo(int x, int y); | |
| 84 int width() { return bounds_.width(); } | |
| 85 int height() { return bounds_.height(); } | |
| 86 const gfx::Rect& bounds() const { return bounds_; } | |
| 87 | |
| 88 // Reposition the bubble - as we are using a WS_POPUP for the bubble, | |
| 89 // we have to manually position it when the browser window moves. | |
| 90 void Reposition(); | |
| 91 | |
| 92 // Resize the bubble to fit the view. | |
| 93 void ResizeToView(); | |
| 94 | |
| 95 // Returns the NativeView containing that popup. | |
| 96 gfx::NativeView native_view() const { return popup_->GetNativeView(); } | |
| 97 | |
| 98 protected: | |
| 99 // Create the popup widget. | |
| 100 virtual void InitPopup(const gfx::Insets& content_margins); | |
| 101 | |
| 102 // Get |relative_to_| rect in screen coordinates. | |
| 103 gfx::Rect GetAbsoluteRelativeTo(); | |
| 104 | |
| 105 // Set bounds using screen coordinates. | |
| 106 void SetAbsoluteBounds(const gfx::Rect& window_bounds); | |
| 107 | |
| 108 // Move the popup to an absolute position. | |
| 109 void MovePopup(int x, int y, int w, int h); | |
| 110 | |
| 111 // The widget that this bubble is in. | |
| 112 views::Widget* popup_; | |
| 113 | |
| 114 // The frame that this bubble is attached to. | |
| 115 views::Widget* frame_; | |
| 116 | |
| 117 private: | |
| 118 // The view that is displayed in this bubble. | |
| 119 views::View* view_; | |
| 120 | |
| 121 // Anchor rect that this bubble is shown relative to, in frame coordinates. | |
| 122 gfx::Rect relative_to_; | |
| 123 | |
| 124 // Arrow location of this bubble. | |
| 125 views::BubbleBorder::ArrowLocation arrow_location_; | |
| 126 | |
| 127 // The bounds relative to the frame. | |
| 128 gfx::Rect bounds_; | |
| 129 | |
| 130 // The delegate isn't owned by the bubble. | |
| 131 Delegate* delegate_; | |
| 132 | |
| 133 // Is the bubble attached to a Browser window. | |
| 134 bool attached_; | |
| 135 | |
| 136 // Non-owning pointer to the host of this bubble. | |
| 137 BrowserBubbleHost* bubble_host_; | |
| 138 | |
| 139 DISALLOW_COPY_AND_ASSIGN(BrowserBubble); | |
| 140 }; | |
| 141 | |
| 142 #endif // CHROME_BROWSER_UI_VIEWS_BROWSER_BUBBLE_H_ | |
| OLD | NEW |