widget/nsITaskbarOverlayIconController.idl
author cku <cku@mozilla.com>
Fri, 05 May 2017 17:19:43 +0800
changeset 359137 f3460d42d23cb21093146a2ace98009d581bd77a
parent 94484 f4157e8c410708d76703f19e4dfb61859bfe32d8
permissions -rw-r--r--
Bug 1351440 - Part 2. Encapsulate DrawResult and imgIContainer::FLAG_* into imgDrawingParams, and pass it to PaintSVG. r=jwatt The DrawResult return was not in fact anything to do with the success or failure of that method, but was actually passing out a very specific piece of information about the success or failure of any imagelib drawing that may not have occurred under the various PaintSVG calls. The signature of PaintSVG is changed from DrawResult PaintSVG(...., uint32 flags); to void PaintSVG(...., imgDrawingParams& aPackage); imgDrawingParams wraps DrawResult and imgIContainer::FLAG_* as a pack, pass through PaintSVG to imagelib draw calls under beneath. MozReview-Commit-ID: IOq2evUAOQF

/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * 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 imgIContainer;

/**
 * Starting in Windows 7, applications can display an overlay on the icon in
 * the taskbar. This class wraps around the native functionality to do this.
 */
[scriptable, uuid(b1858889-a698-428a-a14b-b5d60cff6de2)]
interface nsITaskbarOverlayIconController : nsISupports
{
  /**
   * Sets the overlay icon and its corresponding alt text.
   *
   * @param statusIcon The handle to the overlay icon. The icon will be scaled
   *                   to the small icon size (16x16 at 96 dpi). Can be null, in
   *                   which case if the taskbar button represents a single window
   *                   the icon is removed.
   * @param statusDescription The alt text version of the information
   *                          conveyed by the overlay, for accessibility
   *                          purposes.
   *
   * @note The behavior for window groups is managed by Windows.
   * - If an overlay icon is set for any window in a window group and another
   *   overlay icon is already applied to the corresponding taskbar button, that
   *   existing overlay is replaced.
   * - If null is passed in to replace the overlay currently being displayed,
   *   and if a previous overlay set for a different window in the group is
   *   still available, then that previous overlay is displayed.
   */
  void setOverlayIcon(in imgIContainer statusIcon,
                      in AString statusDescription);
};