// Copyright (c) 2014 GitHub, Inc. // Use of this source code is governed by the MIT license that can be // found in the LICENSE file. #ifndef SHELL_BROWSER_UI_TRAY_ICON_H_ #define SHELL_BROWSER_UI_TRAY_ICON_H_ #include #include #include "base/observer_list.h" #include "shell/browser/ui/atom_menu_model.h" #include "shell/browser/ui/tray_icon_observer.h" #include "ui/gfx/geometry/rect.h" namespace electron { class TrayIcon { public: static TrayIcon* Create(); #if defined(OS_WIN) using ImageType = HICON; #else using ImageType = const gfx::Image&; #endif virtual ~TrayIcon(); // Sets the image associated with this status icon. virtual void SetImage(ImageType image) = 0; // Sets the image associated with this status icon when pressed. virtual void SetPressedImage(ImageType image); // Sets the hover text for this status icon. This is also used as the label // for the menu item which is created as a replacement for the status icon // click action on platforms that do not support custom click actions for the // status icon (e.g. Ubuntu Unity). virtual void SetToolTip(const std::string& tool_tip) = 0; #if defined(OS_MACOSX) // Set/Get flag determining whether to ignore double click events. virtual void SetIgnoreDoubleClickEvents(bool ignore) = 0; virtual bool GetIgnoreDoubleClickEvents() = 0; // Set/Get title displayed next to status icon in the status bar. virtual void SetTitle(const std::string& title) = 0; virtual std::string GetTitle() = 0; #endif enum class IconType { None, Info, Warning, Error, Custom }; struct BalloonOptions { IconType icon_type = IconType::Custom; #if defined(OS_WIN) HICON icon = nullptr; #else gfx::Image icon; #endif base::string16 title; base::string16 content; bool large_icon = true; bool no_sound = false; bool respect_quiet_time = false; BalloonOptions(); }; // Displays a notification balloon with the specified contents. // Depending on the platform it might not appear by the icon tray. virtual void DisplayBalloon(const BalloonOptions& options); // Removes the notification balloon. virtual void RemoveBalloon(); // Returns focus to the taskbar notification area. virtual void Focus(); // Popups the menu. virtual void PopUpContextMenu(const gfx::Point& pos, AtomMenuModel* menu_model); // Set the context menu for this icon. virtual void SetContextMenu(AtomMenuModel* menu_model) = 0; // Returns the bounds of tray icon. virtual gfx::Rect GetBounds(); void AddObserver(TrayIconObserver* obs) { observers_.AddObserver(obs); } void RemoveObserver(TrayIconObserver* obs) { observers_.RemoveObserver(obs); } void NotifyClicked(const gfx::Rect& = gfx::Rect(), const gfx::Point& location = gfx::Point(), int modifiers = 0); void NotifyDoubleClicked(const gfx::Rect& = gfx::Rect(), int modifiers = 0); void NotifyBalloonShow(); void NotifyBalloonClicked(); void NotifyBalloonClosed(); void NotifyRightClicked(const gfx::Rect& bounds = gfx::Rect(), int modifiers = 0); void NotifyDrop(); void NotifyDropFiles(const std::vector& files); void NotifyDropText(const std::string& text); void NotifyDragEntered(); void NotifyDragExited(); void NotifyDragEnded(); void NotifyMouseEntered(const gfx::Point& location = gfx::Point(), int modifiers = 0); void NotifyMouseExited(const gfx::Point& location = gfx::Point(), int modifiers = 0); void NotifyMouseMoved(const gfx::Point& location = gfx::Point(), int modifiers = 0); protected: TrayIcon(); private: base::ObserverList observers_; DISALLOW_COPY_AND_ASSIGN(TrayIcon); }; } // namespace electron #endif // SHELL_BROWSER_UI_TRAY_ICON_H_