blob: 9328f01dbc857a566b33bbba5217189181cc3709 [file] [log] [blame]
// Copyright (c) 2012 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 "ui/aura/window.h"
#include "ui/gfx/font.h"
#include "ui/wm/public/wm_public_export.h"
namespace gfx {
class Point;
namespace wm {
class ScopedTooltipDisabler;
class WM_PUBLIC_EXPORT TooltipClient {
// Returns the max width of the tooltip when shown at the specified location.
virtual int GetMaxWidth(const gfx::Point& point) const = 0;
// Informs the shell tooltip manager of change in tooltip for window |target|.
virtual void UpdateTooltip(aura::Window* target) = 0;
// Sets the time after which the tooltip is hidden for Window |target|. If
// |timeout_in_ms| is <= 0, the tooltip is shown indefinitely.
virtual void SetTooltipShownTimeout(aura::Window* target,
int timeout_in_ms) = 0;
// Enables/Disables tooltips. This is treated as a reference count. Consumers
// must use ScopedTooltipDisabler to enable/disabled tooltips.
virtual void SetTooltipsEnabled(bool enable) = 0;
friend class ScopedTooltipDisabler;
WM_PUBLIC_EXPORT void SetTooltipClient(aura::Window* root_window,
TooltipClient* client);
WM_PUBLIC_EXPORT TooltipClient* GetTooltipClient(aura::Window* root_window);
// Sets the text for the tooltip. The id is used to determine uniqueness when
// the text does not change. For example, if the tooltip text does not change,
// but the id does then the position of the tooltip is updated.
WM_PUBLIC_EXPORT void SetTooltipText(aura::Window* window,
base::string16* tooltip_text);
WM_PUBLIC_EXPORT void SetTooltipId(aura::Window* window, void* id);
WM_PUBLIC_EXPORT const base::string16 GetTooltipText(aura::Window* window);
WM_PUBLIC_EXPORT const void* GetTooltipId(aura::Window* window);
WM_PUBLIC_EXPORT extern const aura::WindowProperty<void*>* const kTooltipIdKey;
WM_PUBLIC_EXPORT extern const aura::WindowProperty<base::string16*>* const
} // namespace wm