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_STATUS_BUBBLE_H_ 6 #define CHROME_BROWSER_UI_STATUS_BUBBLE_H_ 7 8 #include <string> 9 10 #include "base/strings/string16.h" 11 12 class GURL; 13 namespace gfx { 14 class Point; 15 } 16 17 //////////////////////////////////////////////////////////////////////////////// 18 // StatusBubble interface 19 // An interface implemented by an object providing the status display area of 20 // the browser window. 21 // 22 class StatusBubble { 23 public: 24 // On hover, expand status bubble to fit long URL after this delay. 25 static const int kExpandHoverDelay = 1600; 26 27 virtual ~StatusBubble() {} 28 29 // Sets the bubble contents to a specific string and causes the bubble 30 // to display immediately. Subsequent empty SetURL calls (typically called 31 // when the cursor exits a link) will set the status bubble back to its 32 // status text. To hide the status bubble again, either call SetStatus 33 // with an empty string, or call Hide(). 34 virtual void SetStatus(const base::string16& status) = 0; 35 36 // Sets the bubble text to a URL - if given a non-empty URL, this will cause 37 // the bubble to fade in and remain open until given an empty URL or until 38 // the Hide() method is called. languages is the value of Accept-Language 39 // to determine what characters are understood by a user. 40 virtual void SetURL(const GURL& url, const std::string& languages) = 0; 41 42 // Skip the fade and instant-hide the bubble. 43 virtual void Hide() = 0; 44 45 // Called when the user's mouse has moved over web content. This is used to 46 // determine when the status area should move out of the way of the user's 47 // mouse. This may be windows specific pain due to the way messages are 48 // processed for child HWNDs. |position| is the absolute position of the 49 // pointer, and |left_content| is true if the mouse just left the content 50 // area. 51 virtual void MouseMoved(const gfx::Point& position, bool left_content) = 0; 52 53 // Called when the download shelf becomes visible or invisible. 54 // This is used by to ensure that the status bubble does not obscure 55 // the download shelf, when it is visible. 56 virtual void UpdateDownloadShelfVisibility(bool visible) = 0; 57 }; 58 59 #endif // CHROME_BROWSER_UI_STATUS_BUBBLE_H_ 60
