widget/nsISystemStatusBar.idl
author Jan Henning <jh+bugzilla@buttercookie.de>
Fri, 11 Jan 2019 21:21:41 +0000
changeset 453568 0355f47af6ceab050018e9c27fc9d9c4bb944662
parent 416004 7f3223b376bb4f473b44e8d3d504df58b70652a0
permissions -rw-r--r--
Bug 1517976 - Test that resetting WindowUtils.isFirstPaint doesn't clobber APZ scroll position. r=botond We need to setup a case where the visual viewport is smaller than the layout viewport. Faking a pinch zoom through touch events is imprecise, whereas calling windowUtils.setResolutionAndScaleTo(value > 1) to simulate the equivalent effect of a pinch-zoom on the page led to the subsequent scroll attempt failing quite often even after calling waitForApzFlushedRepaints(). So instead, we set up a very wide layout viewport through the meta viewport tag, which on Desktop means additionally enabling the dom.meta-viewport.enabled pref. Differential Revision: https://phabricator.services.mozilla.com/D15791

/* 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"

webidl Element;

/**
 * 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 Element aMenuElement);

  /**
   * 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 Element aMenuElement);
};