first run bubble using the views/bubble api.

chrome/browser/ui/views/first_run_bubble.cc

 // Copyright (c) 2011 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.
 
 #include "chrome/browser/ui/views/first_run_bubble.h"
 
 #include "base/bind.h"
 #include "base/utf_string_conversions.h"
+#include "chrome/browser/ui/views/bubble/bubble.h"  // for kBackgroundColor

[msw, 2011/10/18 18:39:23]

really? this seems wrong, let's not mix bubbles. Assume the next step is
deleting those files; would we move kBackgroundColor here or into the new views
bubble delegate header as the default GetColor value, or as a seperate constant?

[alicet1, 2011/10/19 05:02:15]

I think you're handling this one already, so I'll leave it here. The constant
should move from old bubbles to views/bubbles.

 #include "chrome/browser/first_run/first_run.h"
 #include "chrome/browser/search_engines/util.h"
 #include "chrome/browser/ui/browser.h"
 #include "chrome/browser/ui/browser_list.h"
 #include "chrome/browser/ui/browser_window.h"
 #include "content/browser/user_metrics.h"
 #include "grit/chromium_strings.h"
 #include "grit/generated_resources.h"
 #include "grit/locale_settings.h"
 #include "grit/theme_resources_standard.h"
 #include "ui/base/l10n/l10n_font_util.h"
 #include "ui/base/l10n/l10n_util.h"
 #include "ui/base/resource/resource_bundle.h"
+#include "views/bubble/bubble_view.h"
 #include "views/controls/button/image_button.h"
 #include "views/controls/button/text_button.h"
 #include "views/controls/label.h"
 #include "views/events/event.h"
 #include "views/focus/focus_manager.h"
 #include "views/layout/layout_constants.h"
+#if defined(OS_WIN)
 #include "views/widget/native_widget_win.h"

[msw, 2011/10/18 18:39:23]

Can we avoid this platform specific include altogether?

[alicet1, 2011/10/19 05:02:15]

I'll remove it when I manage to remove the two OS_WIN blocks below, not entirely
sure I can remove the EnableParent part.

+#endif
 #include "views/widget/widget.h"
-

[msw, 2011/10/18 18:39:23]

leave this line there.

[alicet1, 2011/10/19 05:02:15]

Done.

 namespace {
 
 // How much extra padding to put around our content over what the Bubble
 // provides.
 const int kBubblePadding = 4;
 
 // How much extra padding to put around our content over what the Bubble
 // provides in alternative OEM bubble.
 const int kOEMBubblePadding = 4;
 
-// Padding between parts of strings on the same line (for instance,
-// "New!" and "Search from the address bar!"
-const int kStringSeparationPadding = 2;
-
 // Margin around close button.
 const int kMarginRightOfCloseButton = 7;
 
+#if defined(OS_WIN)
 // The bubble's HWND is actually owned by the border widget, and it's the border
 // widget that's owned by the frame window the bubble is anchored to. This
 // function makes the two leaps necessary to go from the bubble contents HWND
 // to the frame HWND.
 HWND GetLogicalBubbleOwner(HWND bubble_hwnd) {

[msw, 2011/10/18 18:39:23]

You should eliminate this function (along with EnableParent) in this bubble
upgrade.

[alicet1, 2011/10/19 05:02:15]

removed this. EnableParent is another one I'm not sure yet.

   HWND border_widget_hwnd = GetWindow(bubble_hwnd, GW_OWNER);
   return GetWindow(border_widget_hwnd, GW_OWNER);
 }
+#endif
 
 }  // namespace
 
 // Base class for implementations of the client view which appears inside the
 // first run bubble. It is a dialog-ish view, but is not a true dialog.
 class FirstRunBubbleViewBase : public views::View,
                                public views::ButtonListener,
                                public views::FocusChangeListener {
  public:
-  // Called by FirstRunBubble::Show to request focus for the proper button
-  // in the FirstRunBubbleView when it is shown.
-  virtual void BubbleShown() = 0;
+  virtual views::View* GetInitiallyFocusedView()  = 0;
 };
 
 // FirstRunBubbleView ---------------------------------------------------------
 
 class FirstRunBubbleView : public FirstRunBubbleViewBase {
  public:
   FirstRunBubbleView(FirstRunBubble* bubble_window, Profile* profile);
-
+  virtual gfx::Size GetPreferredSize();
+  virtual views::View* GetInitiallyFocusedView() { return keep_button_; }
  private:
-  virtual ~FirstRunBubbleView() {}
-
-  // FirstRunBubbleViewBase:
-  virtual void BubbleShown();
+  virtual ~FirstRunBubbleView();
 
   // Overridden from View:
   virtual void ButtonPressed(views::Button* sender, const views::Event& event);
   virtual void Layout();
-  virtual gfx::Size GetPreferredSize();
 
   // FocusChangeListener:
   virtual void FocusWillChange(View* focused_before, View* focused_now);
 
   FirstRunBubble* bubble_window_;
   views::Label* label1_;
   views::Label* label2_;
   views::Label* label3_;
+  views::NativeTextButton* keep_button_;
   views::NativeTextButton* change_button_;
-  views::NativeTextButton* keep_button_;
   Profile* profile_;
 
   DISALLOW_COPY_AND_ASSIGN(FirstRunBubbleView);
 };
 
 FirstRunBubbleView::FirstRunBubbleView(FirstRunBubble* bubble_window,
                                        Profile* profile)
     : bubble_window_(bubble_window),
       label1_(NULL),
       label2_(NULL),
@@ skipping 37 matching lines @@
   keep_button_ = new views::NativeTextButton(this, keep_str);
   keep_button_->SetIsDefault(true);
   AddChildView(keep_button_);
 
   std::wstring change_str =
       UTF16ToWide(l10n_util::GetStringUTF16(IDS_FR_BUBBLE_CHANGE));
   change_button_ = new views::NativeTextButton(this, change_str);
   AddChildView(change_button_);
 }
 
-void FirstRunBubbleView::BubbleShown() {
-  keep_button_->RequestFocus();
+FirstRunBubbleView::~FirstRunBubbleView() {
+  GetFocusManager()->RemoveFocusChangeListener(this);
 }
 
 void FirstRunBubbleView::ButtonPressed(views::Button* sender,
                                        const views::Event& event) {
   UserMetrics::RecordAction(UserMetricsAction("FirstRunBubbleView_Clicked"));
-  bubble_window_->set_fade_away_on_close(true);
-  bubble_window_->Close();
+  // Fades out.
+  GetWidget()->client_view()->AsBubbleView()->StartFade(false);
   if (change_button_ == sender) {
     UserMetrics::RecordAction(
                     UserMetricsAction("FirstRunBubbleView_ChangeButton"));
 
     Browser* browser = BrowserList::GetLastActiveWithProfile(profile_);
     if (browser) {
       browser->OpenSearchEngineOptionsDialog();
     }
   }
+  GetWidget()->Close();
 }
 
 void FirstRunBubbleView::Layout() {
   gfx::Size canvas = GetPreferredSize();
 
   // The multiline business that follows is dirty hacks to get around
   // bug 1325257.
   label1_->SetMultiLine(false);
   gfx::Size pref_size = label1_->GetPreferredSize();
   label1_->SetMultiLine(true);
@@ skipping 52 matching lines @@
         static_cast<views::NativeTextButton*>(focused_now);
     after->SetIsDefault(true);
   }
 }
 
 // FirstRunOEMBubbleView ------------------------------------------------------
 
 class FirstRunOEMBubbleView : public FirstRunBubbleViewBase {
  public:
   FirstRunOEMBubbleView(FirstRunBubble* bubble_window, Profile* profile);
+  virtual gfx::Size GetPreferredSize();
+  // FirstRunBubbleViewBase:
+  virtual views::View* GetInitiallyFocusedView() { return this; }
 
  private:
-  virtual ~FirstRunOEMBubbleView() { }
-
-  // FirstRunBubbleViewBase:
-  virtual void BubbleShown();
+  virtual ~FirstRunOEMBubbleView();
 
   // Overridden from View:
   virtual void ButtonPressed(views::Button* sender, const views::Event& event);
   virtual void Layout();
-  virtual gfx::Size GetPreferredSize();
 
   // FocusChangeListener:
   virtual void FocusWillChange(View* focused_before, View* focused_now);
 
   FirstRunBubble* bubble_window_;
   views::Label* label1_;
   views::Label* label2_;
   views::Label* label3_;
   views::ImageButton* close_button_;
   Profile* profile_;
@@ skipping 42 matching lines @@
   close_button_->SetImage(views::CustomButton::BS_NORMAL,
                           rb.GetBitmapNamed(IDR_CLOSE_BAR));
   close_button_->SetImage(views::CustomButton::BS_HOT,
                           rb.GetBitmapNamed(IDR_CLOSE_BAR_H));
   close_button_->SetImage(views::CustomButton::BS_PUSHED,
                           rb.GetBitmapNamed(IDR_CLOSE_BAR_P));
 
   AddChildView(close_button_);
 }
 
-void FirstRunOEMBubbleView::BubbleShown() {
-  RequestFocus();
-  // No button in oem_bubble to request focus.
+FirstRunOEMBubbleView::~FirstRunOEMBubbleView() {
+  GetFocusManager()->RemoveFocusChangeListener(this);
 }
 
 void FirstRunOEMBubbleView::ButtonPressed(views::Button* sender,
                                           const views::Event& event) {
   UserMetrics::RecordAction(
       UserMetricsAction("FirstRunOEMBubbleView_Clicked"));
-  bubble_window_->set_fade_away_on_close(true);
-  bubble_window_->Close();
+  GetWidget()->client_view()->AsBubbleView()->StartFade(/*fade_in=*/false);
+  GetWidget()->Close();
 }
 
 void FirstRunOEMBubbleView::Layout() {
   gfx::Size canvas = GetPreferredSize();
 
   // First, draw the close button on the far right.
   gfx::Size sz = close_button_->GetPreferredSize();
   close_button_->SetBounds(
       canvas.width() - sz.width() - kMarginRightOfCloseButton,
       kOEMBubblePadding, sz.width(), sz.height());
@@ skipping 22 matching lines @@
 gfx::Size FirstRunOEMBubbleView::GetPreferredSize() {
   // Calculate width based on font and text.
   ResourceBundle& rb = ResourceBundle::GetSharedInstance();
   const gfx::Font& font = rb.GetFont(
       ResourceBundle::MediumFont).DeriveFont(3, gfx::Font::BOLD);
   gfx::Size size = gfx::Size(
       ui::GetLocalizedContentsWidthForFont(
           IDS_FIRSTRUNOEMBUBBLE_DIALOG_WIDTH_CHARS, font),
       ui::GetLocalizedContentsHeightForFont(
           IDS_FIRSTRUNOEMBUBBLE_DIALOG_HEIGHT_LINES, font));
-
+#if defined(OS_WIN)
   // WARNING: HACK. Vista and XP calculate font size differently; this means
   // that a dialog box correctly proportioned for XP will appear too large in
   // Vista. The correct thing to do is to change font size calculations in
   // XP or Vista so that the length of a string is calculated properly. For
   // now, we force Vista to show a correctly-sized box by taking account of
   // the difference in font size calculation. The coefficient should not be
   // stored in a variable because it's a hack and should go away.
   if (views::NativeWidgetWin::IsAeroGlassEnabled()) {
     size.set_width(static_cast<int>(size.width() * 0.85));
     size.set_height(static_cast<int>(size.height() * 0.85));
   }
+#endif
   return size;
 }
 
 void FirstRunOEMBubbleView::FocusWillChange(View* focused_before,
                                             View* focused_now) {
   // No buttons in oem_bubble to register focus changes.
 }
 
 // FirstRunMinimalBubbleView --------------------------------------------------
 // TODO(mirandac): combine FRBubbles more elegantly.  http://crbug.com/41353
 
 class FirstRunMinimalBubbleView : public FirstRunBubbleViewBase {
  public:
   FirstRunMinimalBubbleView(FirstRunBubble* bubble_window, Profile* profile);
+  virtual gfx::Size GetPreferredSize();
+  // FirstRunBubbleViewBase:
+  virtual views::View* GetInitiallyFocusedView() { return this; }
 
  private:
-  virtual ~FirstRunMinimalBubbleView() { }
-
-  // FirstRunBubbleViewBase:
-  virtual void BubbleShown();
+  virtual ~FirstRunMinimalBubbleView();
 
   // Overridden from View:
   virtual void ButtonPressed(views::Button* sender,
                              const views::Event& event) { }
   virtual void Layout();
-  virtual gfx::Size GetPreferredSize();
 
   // FocusChangeListener:
   virtual void FocusWillChange(View* focused_before, View* focused_now);
 
   FirstRunBubble* bubble_window_;
   Profile* profile_;
   views::Label* label1_;
   views::Label* label2_;
 
   DISALLOW_COPY_AND_ASSIGN(FirstRunMinimalBubbleView);
@@ skipping 22 matching lines @@
   label2_ = new views::Label(
       l10n_util::GetStringUTF16(IDS_FR_BUBBLE_SUBTEXT));
   label2_->SetMultiLine(true);
   label2_->SetFont(font);
   label2_->SetBackgroundColor(Bubble::kBackgroundColor);
   label2_->SetHorizontalAlignment(views::Label::ALIGN_LEFT);
   label2_->SizeToFit(ps.width() - kBubblePadding * 2);
   AddChildView(label2_);
 }
 
-void FirstRunMinimalBubbleView::BubbleShown() {
-  RequestFocus();
+FirstRunMinimalBubbleView::~FirstRunMinimalBubbleView() {
+  GetFocusManager()->RemoveFocusChangeListener(this);
 }
 
 void FirstRunMinimalBubbleView::Layout() {
   gfx::Size canvas = GetPreferredSize();
 
   // See comments in FirstRunOEMBubbleView::Layout explaining this hack.
   label1_->SetMultiLine(false);
   gfx::Size pref_size = label1_->GetPreferredSize();
   label1_->SetMultiLine(true);
   label1_->SizeToFit(canvas.width() - kBubblePadding * 2);
@@ skipping 18 matching lines @@
 
 void FirstRunMinimalBubbleView::FocusWillChange(View* focused_before,
                                                 View* focused_now) {
   // No buttons in minimal bubble to register focus changes.
 }
 
 
 // FirstRunBubble -------------------------------------------------------------
 
 // static
-FirstRunBubble* FirstRunBubble::Show(
+views::Widget* FirstRunBubble::Show(
     Profile* profile,
     views::Widget* parent,
     const gfx::Rect& position_relative_to,
     views::BubbleBorder::ArrowLocation arrow_location,
     FirstRun::BubbleType bubble_type) {
-  FirstRunBubble* bubble = new FirstRunBubble();
+  FirstRunBubble* delegate =
+      new FirstRunBubble(profile,
+                         parent,
+                         position_relative_to,
+                         arrow_location,
+                         bubble_type);
+  views::Widget* widget =
+      views::BubbleDelegateView::CreateBubble(delegate, parent);
+  // StartFade and show.
+  widget->client_view()->AsBubbleView()->StartFade(/*fade_in=*/true);
+  return widget;
+}
+
+void FirstRunBubble::Init() {
   FirstRunBubbleViewBase* view = NULL;
-
-  switch (bubble_type) {
+  switch (bubble_type_) {
     case FirstRun::OEM_BUBBLE:
-      view = new FirstRunOEMBubbleView(bubble, profile);
+      view = new FirstRunOEMBubbleView(this, profile_);
       break;
     case FirstRun::LARGE_BUBBLE:
-      view = new FirstRunBubbleView(bubble, profile);
+      view = new FirstRunBubbleView(this, profile_);
       break;
     case FirstRun::MINIMAL_BUBBLE:
-      view = new FirstRunMinimalBubbleView(bubble, profile);
+      view = new FirstRunMinimalBubbleView(this, profile_);
       break;
     default:
       NOTREACHED();
   }
-  bubble->set_view(view);
-  bubble->InitBubble(
-      parent, position_relative_to, arrow_location, view, bubble);
-  bubble->GetWidget()->GetFocusManager()->AddFocusChangeListener(view);
-  view->BubbleShown();

[msw, 2011/10/18 18:39:23]

Do you need to still call BubbleShown?

[alicet1, 2011/10/19 05:02:15]

re-added.

-  return bubble;
+  AddChildView(view);

[msw, 2011/10/18 18:39:23]

You might need to use a FillLayout to make the child view bounds match this
view's bounds.

[alicet1, 2011/10/19 05:02:15]

Done.

+  preferred_size_ = view->GetPreferredSize();
+  initially_focused_view_ = view->GetInitiallyFocusedView();
+  parent_->GetFocusManager()->AddFocusChangeListener(view);
 }
 
-FirstRunBubble::FirstRunBubble()
-    : has_been_activated_(false),
-      ALLOW_THIS_IN_INITIALIZER_LIST(enable_window_method_factory_(this)),
-      view_(NULL) {
+FirstRunBubble::FirstRunBubble(
+    Profile* profile,
+    views::Widget* parent,
+    const gfx::Rect& position_relative_to,
+    views::BubbleBorder::ArrowLocation arrow_location,
+    FirstRun::BubbleType bubble_type)
+    : profile_(profile),
+      parent_(parent),
+      position_relative_to_(position_relative_to),
+      arrow_location_(arrow_location),
+      bubble_type_(bubble_type),
+      initially_focused_view_(NULL),
+      has_been_activated_(false),
+      ALLOW_THIS_IN_INITIALIZER_LIST(enable_window_method_factory_(this)) {
 }
 
 FirstRunBubble::~FirstRunBubble() {
   enable_window_method_factory_.InvalidateWeakPtrs();
-  GetWidget()->GetFocusManager()->RemoveFocusChangeListener(view_);
 }
 
+gfx::Point FirstRunBubble::GetAnchorPoint() const {
+  return position_relative_to_.origin();
+}
+
+gfx::Size FirstRunBubble::GetPreferredSize() {
+  return preferred_size_;

[msw, 2011/10/18 18:39:23]

preferred_size_ and this override are unnecessary as far as I can tell; remove
them. The preferred size calculations should work just fine as long as you add
FirstRunBubbleViewBase view to this view in Init().

[alicet1, 2011/10/19 05:02:15]

Done.

+}
+views::View* FirstRunBubble::GetInitiallyFocusedView() {

[msw, 2011/10/18 18:39:23]

insert a blank line between these function definitions.

[alicet1, 2011/10/19 05:02:15]

removed

+  return initially_focused_view_;
+}
+
+#if !defined(USE_AURA)

[msw, 2011/10/18 18:39:23]

You've got an OS_WIN block above for GetLogicalBubbleOwner, but !USE_AURA here,
this should be OS_WIN if it can't be eliminated altogether.

[alicet1, 2011/10/19 05:02:15]

Done.

 void FirstRunBubble::EnableParent() {

[msw, 2011/10/18 18:39:23]

This just seems wrong altogether... Can you safely eliminate this and
GetLogicalBubbleOwner, perhaps using Widget/FocusManager API instead?

[alicet1, 2011/10/19 05:02:15]

Got rid of the GetLogicalBubbleOwner, not sure if I can get rid of this method
all together.

   ::EnableWindow(GetParent(), true);
   // The EnableWindow() call above causes the parent to become active, which
   // resets the flag set by Bubble's call to DisableInactiveRendering(), so we
   // have to call it again before activating the bubble to prevent the parent
   // window from rendering inactive.
   // TODO(beng): this only works in custom-frame mode, not glass-frame mode.
   HWND bubble_owner = GetLogicalBubbleOwner(GetNativeView());
   views::Widget* parent = views::Widget::GetWidgetForNativeView(bubble_owner);
   if (parent)
     parent->DisableInactiveRendering();
   // Reactivate the FirstRunBubble so it responds to OnActivate messages.
   SetWindowPos(GetParent(), 0, 0, 0, 0,
                SWP_NOSIZE | SWP_NOMOVE | SWP_NOREDRAW | SWP_SHOWWINDOW);
 }
+#endif
 
 #if defined(OS_WIN) && !defined(USE_AURA)
 void FirstRunBubble::OnActivate(UINT action, BOOL minimized, HWND window) {
   // Keep the bubble around for kLingerTime milliseconds, to prevent accidental
   // closure.
   const int kLingerTime = 3000;
 
   // We might get re-enabled right before we are closed (sequence is: we get
   // deactivated, we call close, before we are actually closed we get
   // reactivated). Don't do the disabling of the parent in such cases.
   if (action == WA_ACTIVE && !has_been_activated_) {
     has_been_activated_ = true;
 
     ::EnableWindow(GetParent(), false);
 
     MessageLoop::current()->PostDelayedTask(
         FROM_HERE,
         base::Bind(&FirstRunBubble::EnableParent,
                    enable_window_method_factory_.GetWeakPtr()),
         kLingerTime);
     return;
   }
 
   // Keep window from automatically closing until kLingerTime has passed.
   if (::IsWindowEnabled(GetParent()))
     Bubble::OnActivate(action, minimized, window);
 }
 #endif
 
+#if !defined(USE_AURA)

[msw, 2011/10/18 18:39:23]

This seems like it won't work in any case...
I think we need to add some BubbleClosing API to the new bubble (I have the same
roadblock in CriticalNotificationBubbleView)

[alicet1, 2011/10/19 05:02:15]

updated.

 void FirstRunBubble::BubbleClosing(Bubble* bubble, bool closed_by_escape) {
   // Make sure our parent window is re-enabled.
   if (!IsWindowEnabled(GetParent()))
     ::EnableWindow(GetParent(), true);
 }
+#endif