chrome/browser/ui/views/status_bubble_views.h

   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.
   4
   5 #ifndef CHROME_BROWSER_UI_VIEWS_STATUS_BUBBLE_VIEWS_H_
   6 #define CHROME_BROWSER_UI_VIEWS_STATUS_BUBBLE_VIEWS_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/compiler_specific.h"
  10 #include "base/memory/scoped_ptr.h"
  11 #include "base/memory/weak_ptr.h"
  12 #include "base/strings/string16.h"
  13 #include "chrome/browser/ui/status_bubble.h"
  14 #include "ui/gfx/rect.h"
  15 #include "url/gurl.h"
  16
  17 namespace gfx {
  18 class Point;
  19 }
  20 namespace views {
  21 class View;
  22 class Widget;
  23 }
  24
  25 // StatusBubble displays a bubble of text that fades in, hovers over the
  26 // browser chrome and fades away when not needed. It is primarily designed
  27 // to allow users to see where hovered links point to.
  28 class StatusBubbleViews : public StatusBubble {
  29  public:
  30   // How wide the bubble's shadow is.
  31   static const int kShadowThickness;
  32
  33   // The combined vertical padding above and below the text.
  34   static const int kTotalVerticalPadding = 7;
  35
  36   // |base_view| is the view that this bubble is positioned relative to.
  37   explicit StatusBubbleViews(views::View* base_view);
  38   virtual ~StatusBubbleViews();
  39
  40   views::View* base_view() { return base_view_; }
  41
  42   // Reposition the bubble - as we are using a WS_POPUP for the bubble,
  43   // we have to manually position it when the browser window moves.
  44   virtual void Reposition();
  45
  46   // The bubble only has a preferred height: the sum of the height of
  47   // the font and kTotalVerticalPadding.
  48   gfx::Size GetPreferredSize();
  49
  50   // Set the bounds of the bubble relative to |base_view_|.
  51   void SetBounds(int x, int y, int w, int h);
  52
  53   // Set bubble to new width.
  54   void SetBubbleWidth(int width);
  55
  56   // Overridden from StatusBubble:
  57   virtual void SetStatus(const base::string16& status) OVERRIDE;
  58   virtual void SetURL(const GURL& url, const std::string& languages) OVERRIDE;
  59   virtual void Hide() OVERRIDE;
  60   virtual void MouseMoved(const gfx::Point& location,
  61                           bool left_content) OVERRIDE;
  62   virtual void UpdateDownloadShelfVisibility(bool visible) OVERRIDE;
  63
  64   views::Widget* GetPopupForTest() { return popup(); }
  65
  66  protected:
  67   views::Widget* popup() { return popup_.get(); }
  68
  69  private:
  70   class StatusView;
  71   class StatusViewExpander;
  72
  73   // Initializes the popup and view.
  74   void Init();
  75
  76   // Attempt to move the status bubble out of the way of the cursor, allowing
  77   // users to see links in the region normally occupied by the status bubble.
  78   void AvoidMouse(const gfx::Point& location);
  79
  80   // Returns true if the base_view_'s widget is visible and not minimized.
  81   bool IsFrameVisible();
  82
  83   // Expand bubble size to accommodate a long URL.
  84   void ExpandBubble();
  85
  86   // Cancel all waiting expansion animations in the timer.
  87   void CancelExpandTimer();
  88
  89   // Get the standard width for a status bubble in the current frame size.
  90   int GetStandardStatusBubbleWidth();
  91
  92   // Get the maximum possible width for a status bubble in the current frame
  93   // size.
  94   int GetMaxStatusBubbleWidth();
  95
  96   // The status text we want to display when there are no URLs to display.
  97   base::string16 status_text_;
  98
  99   // The url we want to display when there is no status text to display.
 100   base::string16 url_text_;
 101
 102   // The original, non-elided URL.
 103   GURL url_;
 104
 105   // Used to elide the original URL again when we expand it.
 106   std::string languages_;
 107
 108   // Position relative to the base_view_.
 109   gfx::Point original_position_;
 110   // original_position_ adjusted according to the current RTL.
 111   gfx::Point position_;
 112   gfx::Size size_;
 113
 114   // Last location passed to MouseMoved().
 115   gfx::Point last_mouse_moved_location_;
 116
 117   // Whether the view contains the mouse.
 118   bool contains_mouse_;
 119
 120   // How vertically offset the bubble is from its root position_.
 121   int offset_;
 122
 123   // We use a HWND for the popup so that it may float above any HWNDs in our
 124   // UI (the location bar, for example).
 125   scoped_ptr<views::Widget> popup_;
 126   double opacity_;
 127
 128   views::View* base_view_;
 129   StatusView* view_;
 130
 131   // Manages the expansion of a status bubble to fit a long URL.
 132   scoped_ptr<StatusViewExpander> expand_view_;
 133
 134   // If the download shelf is visible, do not obscure it.
 135   bool download_shelf_is_visible_;
 136
 137   // If the bubble has already been expanded, and encounters a new URL,
 138   // change size immediately, with no hover.
 139   bool is_expanded_;
 140
 141   // Times expansion of status bubble when URL is too long for standard width.
 142   base::WeakPtrFactory<StatusBubbleViews> expand_timer_factory_;
 143
 144   DISALLOW_COPY_AND_ASSIGN(StatusBubbleViews);
 145 };
 146
 147 #endif  // CHROME_BROWSER_UI_VIEWS_STATUS_BUBBLE_VIEWS_H_