Home Explore 引导页 在线工具 Blog
Register Sign In
Pchen0
/
electron
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Branch: 24-x-y
Branches Tags
electron
/
shell
/
browser
/
api
/
electron_api_tray.h

electron_api_tray.h 3.8 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114 
  1. // Copyright (c) 2014 GitHub, Inc.
    2. 

  2. // Use of this source code is governed by the MIT license that can be
    3. 

  3. // found in the LICENSE file.
    4. 

  4. 

  5. #ifndef ELECTRON_SHELL_BROWSER_API_ELECTRON_API_TRAY_H_
    6. 

  6. #define ELECTRON_SHELL_BROWSER_API_ELECTRON_API_TRAY_H_
    7. 

  7. 

  8. #include <memory>
    9. 

  9. #include <string>
    10. 

  10. #include <vector>
    11. 

  11. 

  12. #include "gin/handle.h"
    13. 

  13. #include "gin/wrappable.h"
    14. 

  14. #include "shell/browser/event_emitter_mixin.h"
    15. 

  15. #include "shell/browser/javascript_environment.h"
    16. 

  16. #include "shell/browser/ui/tray_icon.h"
    17. 

  17. #include "shell/browser/ui/tray_icon_observer.h"
    18. 

  18. #include "shell/common/gin_converters/guid_converter.h"
    19. 

  19. #include "shell/common/gin_helper/cleaned_up_at_exit.h"
    20. 

  20. #include "shell/common/gin_helper/constructible.h"
    21. 

  21. #include "shell/common/gin_helper/error_thrower.h"
    22. 

  22. #include "shell/common/gin_helper/pinnable.h"
    23. 

  23. 

  24. namespace gfx {
    25. 

  25. class Image;
    26. 

  26. }
    27. 

  27. 

  28. namespace gin_helper {
    29. 

  29. class Dictionary;
    30. 

  30. }
    31. 

  31. 

  32. namespace electron::api {
    33. 

  33. 

  34. class Menu;
    35. 

  35. 

  36. class Tray : public gin::Wrappable<Tray>,
    37. 

  37.              public gin_helper::EventEmitterMixin<Tray>,
    38. 

  38.              public gin_helper::Constructible<Tray>,
    39. 

  39.              public gin_helper::CleanedUpAtExit,
    40. 

  40.              public gin_helper::Pinnable<Tray>,
    41. 

  41.              public TrayIconObserver {
    42. 

  42.  public:
    43. 

  43.   // gin_helper::Constructible
    44. 

  44.   static gin::Handle<Tray> New(gin_helper::ErrorThrower thrower,
    45. 

  45.                                v8::Local<v8::Value> image,
    46. 

  46.                                absl::optional<UUID> guid,
    47. 

  47.                                gin::Arguments* args);
    48. 

  48.   static void FillObjectTemplate(v8::Isolate*, v8::Local<v8::ObjectTemplate>);
    49. 

  49. 

  50.   // gin::Wrappable
    51. 

  51.   static gin::WrapperInfo kWrapperInfo;
    52. 

  52. 

  53.   // disable copy
    54. 

  54.   Tray(const Tray&) = delete;
    55. 

  55.   Tray& operator=(const Tray&) = delete;
    56. 

  56. 

  57.  private:
    58. 

  58.   Tray(v8::Isolate* isolate,
    59. 

  59.        v8::Local<v8::Value> image,
    60. 

  60.        absl::optional<UUID> guid);
    61. 

  61.   ~Tray() override;
    62. 

  62. 

  63.   // TrayIconObserver:
    64. 

  64.   void OnClicked(const gfx::Rect& bounds,
    65. 

  65.                  const gfx::Point& location,
    66. 

  66.                  int modifiers) override;
    67. 

  67.   void OnDoubleClicked(const gfx::Rect& bounds, int modifiers) override;
    68. 

  68.   void OnRightClicked(const gfx::Rect& bounds, int modifiers) override;
    69. 

  69.   void OnBalloonShow() override;
    70. 

  70.   void OnBalloonClicked() override;
    71. 

  71.   void OnBalloonClosed() override;
    72. 

  72.   void OnDrop() override;
    73. 

  73.   void OnDropFiles(const std::vector<std::string>& files) override;
    74. 

  74.   void OnDropText(const std::string& text) override;
    75. 

  75.   void OnDragEntered() override;
    76. 

  76.   void OnDragExited() override;
    77. 

  77.   void OnDragEnded() override;
    78. 

  78.   void OnMouseUp(const gfx::Point& location, int modifiers) override;
    79. 

  79.   void OnMouseDown(const gfx::Point& location, int modifiers) override;
    80. 

  80.   void OnMouseEntered(const gfx::Point& location, int modifiers) override;
    81. 

  81.   void OnMouseExited(const gfx::Point& location, int modifiers) override;
    82. 

  82.   void OnMouseMoved(const gfx::Point& location, int modifiers) override;
    83. 

  83. 

  84.   // JS API:
    85. 

  85.   void Destroy();
    86. 

  86.   bool IsDestroyed();
    87. 

  87.   void SetImage(v8::Isolate* isolate, v8::Local<v8::Value> image);
    88. 

  88.   void SetPressedImage(v8::Isolate* isolate, v8::Local<v8::Value> image);
    89. 

  89.   void SetToolTip(const std::string& tool_tip);
    90. 

  90.   void SetTitle(const std::string& title,
    91. 

  91.                 const absl::optional<gin_helper::Dictionary>& options,
    92. 

  92.                 gin::Arguments* args);
    93. 

  93.   std::string GetTitle();
    94. 

  94.   void SetIgnoreDoubleClickEvents(bool ignore);
    95. 

  95.   bool GetIgnoreDoubleClickEvents();
    96. 

  96.   void DisplayBalloon(gin_helper::ErrorThrower thrower,
    97. 

  97.                       const gin_helper::Dictionary& options);
    98. 

  98.   void RemoveBalloon();
    99. 

  99.   void Focus();
    100. 

  100.   void PopUpContextMenu(gin::Arguments* args);
    101. 

  101.   void CloseContextMenu();
    102. 

  102.   void SetContextMenu(gin_helper::ErrorThrower thrower,
    103. 

  103.                       v8::Local<v8::Value> arg);
    104. 

  104.   gfx::Rect GetBounds();
    105. 

  105. 

  106.   bool CheckAlive();
    107. 

  107. 

  108.   v8::Global<v8::Value> menu_;
    109. 

  109.   std::unique_ptr<TrayIcon> tray_icon_;
    110. 

  110. };
    111. 

  111. 

  112. }  // namespace electron::api
    113. 

  113. 

  114. #endif  // ELECTRON_SHELL_BROWSER_API_ELECTRON_API_TRAY_H_
    115.