widget/nsISystemStatusBar.idl
author Dorel Luca <dluca@mozilla.com>
Mon, 04 Dec 2017 18:01:09 +0200
changeset 394844 58fec9a96e269a57cc6f84bfe3a6dc6800acd955
parent 194970 c7723b9fc8d5b53ca18624c14410d3a33292cd4a
child 416004 7f3223b376bb4f473b44e8d3d504df58b70652a0
permissions -rw-r--r--
Backed out 7 changesets (bug 1377007) for failing build bustage on Linux pgo and faling Cpp's jsapi-tests r=backout on a CLOSED TREE Backed out changeset 9428a4ed7dec (bug 1377007) Backed out changeset 4407b43a8aff (bug 1377007) Backed out changeset 65a37a7f78a5 (bug 1377007) Backed out changeset 276fe6d9b716 (bug 1377007) Backed out changeset 1de46e60ffba (bug 1377007) Backed out changeset 893e303e17ec (bug 1377007) Backed out changeset 081a241e25d4 (bug 1377007)

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

interface nsIDOMElement;

/**
 * Allow applications to interface with the Mac OS X system status bar.
 */

[scriptable, uuid(24493180-ee81-4b7c-8b17-9e69480b7b8a)]
interface nsISystemStatusBar : nsISupports
{
  /**
   * Add an item to the system status bar. Each item can only be present once,
   * subsequent addItem calls with the same element will be ignored.
   * The system status bar holds a strong reference to the added XUL menu
   * element and the item will stay in the status bar until it is removed via
   * a call to removeItem, or until the process shuts down.
   * @param aDOMMenuElement A XUL menu element that contains a XUL menupopup
   *                        with regular menu content. The menu's icon is put
   *                        into the system status bar; clicking it will open
   *                        a menu with the contents of the menupopup.
   *                        The menu label is not shown.
   */
  void addItem(in nsIDOMElement aDOMMenuElement);

  /**
   * Remove a previously-added item from the menu bar. Calling this with an
   * element that has not been added before will be silently ignored.
   * @param aDOMMenuElement The XUL menu element that you called addItem with.
   */
  void removeItem(in nsIDOMElement aDOMMenuElement);
};