summaryrefslogtreecommitdiffstats
path: root/chrome/browser/status_icons/status_icon.h
blob: 5398eb3d3f2a0248bd755ac2efd25be53f17b68e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
// Copyright (c) 2010 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.

#ifndef CHROME_BROWSER_STATUS_ICONS_STATUS_ICON_H_
#define CHROME_BROWSER_STATUS_ICONS_STATUS_ICON_H_
#pragma once

#include "base/observer_list.h"
#include "base/scoped_ptr.h"
#include "base/string16.h"

class SkBitmap;

namespace menus {
class MenuModel;
}

class StatusIcon {
 public:
  StatusIcon();
  virtual ~StatusIcon();

  // Sets the image associated with this status icon.
  virtual void SetImage(const SkBitmap& image) = 0;

  // Sets the image associated with this status icon when pressed.
  virtual void SetPressedImage(const SkBitmap& image) = 0;

  // Sets the hover text for this status icon.
  virtual void SetToolTip(const string16& tool_tip) = 0;

  // Set the context menu for this icon. The icon takes ownership of the passed
  // context menu. Passing NULL results in no menu at all.
  void SetContextMenu(menus::MenuModel* menu);

  class Observer {
   public:
    virtual ~Observer() {}

    // Called when the user clicks on the system tray icon. Clicks that result
    // in the context menu being displayed will not be passed to this observer
    // (i.e. if there's a context menu set on this status icon, and the user
    // right clicks on the icon to display the context menu, OnClicked will not
    // be called).
    virtual void OnClicked() = 0;
  };

  // Adds/Removes an observer for clicks on the status icon. If an observer is
  // registered, then left clicks on the status icon will result in the observer
  // being called, otherwise, both left and right clicks will display the
  // context menu (if any).
  void AddObserver(Observer* observer);
  void RemoveObserver(Observer* observer);

  // Returns true if there are registered click observers.
  bool HasObservers();

  // Dispatches a click event to the observers.
  void DispatchClickEvent();

 protected:
  // Invoked after a call to SetContextMenu() to let the platform-specific
  // subclass update the native context menu based on the new model. If NULL is
  // passed, subclass should destroy the native context menu.
  virtual void UpdatePlatformContextMenu(menus::MenuModel* model) = 0;

 private:
  ObserverList<Observer> observers_;
  // Context menu, if any.
  scoped_ptr<menus::MenuModel> context_menu_contents_;
  DISALLOW_COPY_AND_ASSIGN(StatusIcon);
};

#endif  // CHROME_BROWSER_STATUS_ICONS_STATUS_ICON_H_