1 // Copyright (c) 2012 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.
5 #ifndef UI_VIEWS_BUBBLE_BUBBLE_DELEGATE_H_
6 #define UI_VIEWS_BUBBLE_BUBBLE_DELEGATE_H_
8 #include "base/gtest_prod_util.h"
9 #include "ui/views/bubble/bubble_border.h"
10 #include "ui/views/widget/widget.h"
11 #include "ui/views/widget/widget_delegate.h"
12 #include "ui/views/widget/widget_observer.h"
21 class BubbleFrameView
;
23 // BubbleDelegateView creates frame and client views for bubble Widgets.
24 // BubbleDelegateView itself is the client's contents view.
25 class VIEWS_EXPORT BubbleDelegateView
: public WidgetDelegateView
,
26 public WidgetObserver
{
29 BubbleDelegateView(View
* anchor_view
, BubbleBorder::Arrow arrow
);
30 virtual ~BubbleDelegateView();
32 // Create and initialize the bubble Widget(s) with proper bounds.
33 static Widget
* CreateBubble(BubbleDelegateView
* bubble_delegate
);
35 // WidgetDelegateView overrides:
36 virtual BubbleDelegateView
* AsBubbleDelegate() OVERRIDE
;
37 virtual bool ShouldShowCloseButton() const OVERRIDE
;
38 virtual View
* GetContentsView() OVERRIDE
;
39 virtual NonClientFrameView
* CreateNonClientFrameView(Widget
* widget
) OVERRIDE
;
40 virtual void GetAccessibleState(ui::AXViewState
* state
) OVERRIDE
;
42 // WidgetObserver overrides:
43 virtual void OnWidgetDestroying(Widget
* widget
) OVERRIDE
;
44 virtual void OnWidgetVisibilityChanging(Widget
* widget
, bool visible
)
46 virtual void OnWidgetVisibilityChanged(Widget
* widget
, bool visible
)
48 virtual void OnWidgetActivationChanged(Widget
* widget
, bool active
) OVERRIDE
;
49 virtual void OnWidgetBoundsChanged(Widget
* widget
,
50 const gfx::Rect
& new_bounds
) OVERRIDE
;
52 bool close_on_esc() const { return close_on_esc_
; }
53 void set_close_on_esc(bool close_on_esc
) { close_on_esc_
= close_on_esc
; }
55 bool close_on_deactivate() const { return close_on_deactivate_
; }
56 void set_close_on_deactivate(bool close
) { close_on_deactivate_
= close
; }
58 View
* GetAnchorView() const;
59 Widget
* anchor_widget() const { return anchor_widget_
; }
61 // The anchor rect is used in the absence of an assigned anchor view.
62 const gfx::Rect
& anchor_rect() const { return anchor_rect_
; }
64 BubbleBorder::Arrow
arrow() const { return arrow_
; }
65 void set_arrow(BubbleBorder::Arrow arrow
) { arrow_
= arrow
; }
67 BubbleBorder::Shadow
shadow() const { return shadow_
; }
68 void set_shadow(BubbleBorder::Shadow shadow
) { shadow_
= shadow
; }
70 SkColor
color() const { return color_
; }
71 void set_color(SkColor color
) {
73 color_explicitly_set_
= true;
76 const gfx::Insets
& margins() const { return margins_
; }
77 void set_margins(const gfx::Insets
& margins
) { margins_
= margins
; }
79 const gfx::Insets
& anchor_view_insets() const { return anchor_view_insets_
; }
80 void set_anchor_view_insets(const gfx::Insets
& i
) { anchor_view_insets_
= i
; }
82 gfx::NativeView
parent_window() const { return parent_window_
; }
83 void set_parent_window(gfx::NativeView window
) { parent_window_
= window
; }
85 bool accept_events() const { return accept_events_
; }
86 void set_accept_events(bool accept_events
) { accept_events_
= accept_events
; }
88 bool border_accepts_events() const { return border_accepts_events_
; }
89 void set_border_accepts_events(bool event
) { border_accepts_events_
= event
; }
91 bool adjust_if_offscreen() const { return adjust_if_offscreen_
; }
92 void set_adjust_if_offscreen(bool adjust
) { adjust_if_offscreen_
= adjust
; }
94 // Get the arrow's anchor rect in screen space.
95 virtual gfx::Rect
GetAnchorRect() const;
97 // Allows delegates to provide custom parameters before widget initialization.
98 virtual void OnBeforeBubbleWidgetInit(Widget::InitParams
* params
,
99 Widget
* widget
) const;
101 // Sets the bubble alignment relative to the anchor. This may only be called
102 // after calling CreateBubble.
103 void SetAlignment(BubbleBorder::BubbleAlignment alignment
);
105 // Sets the bubble arrow paint type.
106 void SetArrowPaintType(BubbleBorder::ArrowPaintType paint_type
);
108 // Call this method when the anchor bounds have changed to reposition the
109 // bubble. The bubble is automatically repositioned when the anchor view
110 // bounds change as a result of the widget's bounds changing.
111 void OnAnchorBoundsChanged();
114 // Get bubble bounds from the anchor rect and client view's preferred size.
115 virtual gfx::Rect
GetBubbleBounds();
117 // Return a FontList to use for the title of the bubble.
118 // (The default is MediumFont).
119 virtual const gfx::FontList
& GetTitleFontList() const;
122 virtual bool AcceleratorPressed(const ui::Accelerator
& accelerator
) OVERRIDE
;
123 virtual void OnNativeThemeChanged(const ui::NativeTheme
* theme
) OVERRIDE
;
125 // Perform view initialization on the contents for bubble sizing.
128 // Sets the anchor view or rect and repositions the bubble. Note that if a
129 // valid view gets passed, the anchor rect will get ignored. If the view gets
130 // deleted, but no new view gets set, the last known anchor postion will get
132 void SetAnchorView(View
* anchor_view
);
133 void SetAnchorRect(const gfx::Rect
& rect
);
135 // Resize and potentially move the bubble to fit the content's preferred size.
136 void SizeToContents();
138 BubbleFrameView
* GetBubbleFrameView() const;
141 friend class BubbleBorderDelegate
;
142 friend class BubbleWindowTargeter
;
144 FRIEND_TEST_ALL_PREFIXES(BubbleDelegateTest
, CreateDelegate
);
145 FRIEND_TEST_ALL_PREFIXES(BubbleDelegateTest
, NonClientHitTest
);
147 // Update the bubble color from |theme|, unless it was explicitly set.
148 void UpdateColorsFromTheme(const ui::NativeTheme
* theme
);
150 // Handles widget visibility changes.
151 void HandleVisibilityChanged(Widget
* widget
, bool visible
);
153 // Flags controlling bubble closure on the escape key and deactivation.
155 bool close_on_deactivate_
;
157 // The view and widget to which this bubble is anchored. Since an anchor view
158 // can be deleted without notice, we store it in the ViewStorage and retrieve
159 // it from there. It will make sure that the view is still valid.
160 const int anchor_view_storage_id_
;
161 Widget
* anchor_widget_
;
163 // The anchor rect used in the absence of an anchor view.
164 mutable gfx::Rect anchor_rect_
;
166 // The arrow's location on the bubble.
167 BubbleBorder::Arrow arrow_
;
169 // Bubble border shadow to use.
170 BubbleBorder::Shadow shadow_
;
172 // The background color of the bubble; and flag for when it's explicitly set.
174 bool color_explicitly_set_
;
176 // The margins between the content and the inside of the border.
177 gfx::Insets margins_
;
179 // Insets applied to the |anchor_view_| bounds.
180 gfx::Insets anchor_view_insets_
;
182 // Specifies whether the bubble (or its border) handles mouse events, etc.
184 bool border_accepts_events_
;
186 // If true (defaults to true), the arrow may be mirrored and moved to fit the
187 // bubble on screen better. It would be a no-op if the bubble has no arrow.
188 bool adjust_if_offscreen_
;
190 // Parent native window of the bubble.
191 gfx::NativeView parent_window_
;
193 DISALLOW_COPY_AND_ASSIGN(BubbleDelegateView
);
198 #endif // UI_VIEWS_BUBBLE_BUBBLE_DELEGATE_H_