mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
electron/docs/api/tray.md

3.9 KiB
Raw Blame History

tray

A Tray represents an icon in operating system's notification area, it is usually attached with a context menu.

var app = require('app');
var Menu = require('menu');
var Tray = require('tray');

var appIcon = null;
app.on('ready', function(){
  appIcon = new Tray('/path/to/my/icon');
  var contextMenu = Menu.buildFromTemplate([
    { label: 'Item1', type: 'radio' },
    { label: 'Item2', type: 'radio' },
    { label: 'Item3', type: 'radio', checked: true },
    { label: 'Item4', type: 'radio' }
  ]);
  appIcon.setToolTip('This is my application.');
  appIcon.setContextMenu(contextMenu);
});

Platform limitations:

  • On Linux app indicator will be used if it is supported, otherwise GtkStatusIcon will be used instead.
  • On Linux distributions that only have app indicator support, you have to install libappindicator1 to make tray icon work.
  • App indicator will only be showed when it has context menu.
  • When app indicator is used on Linux, clicked event is ignored.

So if you want to keep exact same behaviors on all platforms, you should not rely on clicked event and always attach a context menu to the tray icon.

Class: Tray

Tray is an EventEmitter.

new Tray(image)

Creates a new tray icon associated with the image.

Event: 'clicked'

  • event
  • bounds Object - the bounds of tray icon
    • x Integer
    • y Integer
    • width Integer
    • height Integer

Emitted when the tray icon is clicked.

Note: The bounds payload is only implemented on OS X and Windows 7 or newer.

Event: 'right-clicked'

  • event
  • bounds Object - the bounds of tray icon
    • x Integer
    • y Integer
    • width Integer
    • height Integer

Emitted when the tray icon is right clicked.

Note: This is only implemented on OS X and Windows. On Windows, this event will be emitted if the tray icon has context menu.

Event: 'double-clicked'

Emitted when the tray icon is double clicked.

Note: This is only implemented on OS X.

Event: 'balloon-show'

Emitted when the tray balloon shows.

Note: This is only implemented on Windows.

Event: 'balloon-clicked'

Emitted when the tray balloon is clicked.

Note: This is only implemented on Windows.

Event: 'balloon-closed'

Emitted when the tray balloon is closed because of timeout or user manually closes it.

Note: This is only implemented on Windows.

Event: 'drop-files'

  • event
  • files Array - the file path of dropped files.

Emitted when dragged files are dropped in the tray icon.

Note: This is only implemented on OS X.

Tray.destroy()

Destroys the tray icon immediately.

Tray.setImage(image)

Sets the image associated with this tray icon.

Tray.setPressedImage(image)

Sets the image associated with this tray icon when pressed on OS X.

Tray.setToolTip(toolTip)

  • toolTip String

Sets the hover text for this tray icon.

Tray.setTitle(title)

  • title String

Sets the title displayed aside of the tray icon in the status bar.

Note: This is only implemented on OS X.

Tray.setHighlightMode(highlight)

  • highlight Boolean

Sets whether the tray icon is highlighted when it is clicked.

Note: This is only implemented on OS X.

Tray.displayBalloon(options)

  • options Object

Displays a tray balloon.

Note: This is only implemented on Windows.

Tray.popContextMenu([position])

  • position Object - The pop position
    • x Integer
    • y Integer

Note: This is only implemented on OS X and Windows. The position is only available on Windows, and it is (0, 0) by default.

Tray.setContextMenu(menu)

  • menu Menu

Sets the context menu for this icon.