Home | History | Annotate | Download | only in public
      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 UI_WM_PUBLIC_TOOLTIP_CLIENT_H_
      6 #define UI_WM_PUBLIC_TOOLTIP_CLIENT_H_
      7 
      8 #include "ui/aura/aura_export.h"
      9 #include "ui/gfx/font.h"
     10 
     11 namespace aura {
     12 class Window;
     13 namespace client {
     14 
     15 class ScopedTooltipDisabler;
     16 
     17 class AURA_EXPORT TooltipClient {
     18  public:
     19   // Informs the shell tooltip manager of change in tooltip for window |target|.
     20   virtual void UpdateTooltip(Window* target) = 0;
     21 
     22   // Sets the time after which the tooltip is hidden for Window |target|. If
     23   // |timeout_in_ms| is <= 0, the tooltip is shown indefinitely.
     24   virtual void SetTooltipShownTimeout(Window* target, int timeout_in_ms) = 0;
     25 
     26  protected:
     27   // Enables/Disables tooltips. This is treated as a reference count. Consumers
     28   // must use ScopedTooltipDisabler to enable/disabled tooltips.
     29   virtual void SetTooltipsEnabled(bool enable) = 0;
     30 
     31  private:
     32   friend class ScopedTooltipDisabler;
     33 };
     34 
     35 AURA_EXPORT void SetTooltipClient(Window* root_window,
     36                                   TooltipClient* client);
     37 AURA_EXPORT TooltipClient* GetTooltipClient(Window* root_window);
     38 
     39 // Sets the text for the tooltip. The id is used to determine uniqueness when
     40 // the text does not change. For example, if the tooltip text does not change,
     41 // but the id does then the position of the tooltip is updated.
     42 AURA_EXPORT void SetTooltipText(Window* window,
     43                                 base::string16* tooltip_text);
     44 AURA_EXPORT void SetTooltipId(Window* window, void* id);
     45 AURA_EXPORT const base::string16 GetTooltipText(Window* window);
     46 AURA_EXPORT const void* GetTooltipId(Window* window);
     47 
     48 }  // namespace client
     49 }  // namespace aura
     50 
     51 #endif  // UI_WM_PUBLIC_TOOLTIP_CLIENT_H_
     52