widget/nsIColorPicker.idl
author Dorel Luca <dluca@mozilla.com>
Mon, 04 Dec 2017 18:01:09 +0200
changeset 394844 58fec9a96e269a57cc6f84bfe3a6dc6800acd955
parent 282426 e22b3043887ed36bf2c634c2924a7c8d39d226b1
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)

/* -*- Mode: C++; 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 mozIDOMWindowProxy;

/**
 * nsIColorPicker is representing colors as strings because the internal
 * representation will depend on the underlying backend.
 * The format of the colors taken in input and returned will always follow the
 * format of the <input type='color'> value as described in the HTML
 * specifications.
 */

[scriptable, uuid(d2ce78d1-40b5-49d1-b66d-5801fcb9a385)]
interface nsIColorPickerShownCallback : nsISupports
{
 /**
  * Callback called when the color picker requests a color update.
  * This callback can not be called after done() was called.
  * When this callback is used, the consumer can assume that the color value has
  * changed.
  *
  * @param  color  The new selected color value following the format specifed on
  *                top of this file.
  */
 void update(in AString color);

 /**
  * Callback called when the color picker is dismissed.
  * When this callback is used, the color might have changed or could stay the
  * same.
  * If the color has not changed, the color parameter will be the empty string.
  *
  * @param  color  The new selected color value following the format specifed on
  *                top of this file or the empty string.
  */
  void done(in AString color);
};

[scriptable, uuid(de229d37-a8a6-46f1-969a-0c1de33d0ad7)]
interface nsIColorPicker : nsISupports
{
 /**
  * Initialize the color picker widget. The color picker will not be shown until
  * open() is called.
  * If the backend doesn't support setting a title to the native color picker
  * widget, the title parameter might be ignored.
  * If the initialColor parameter does not follow the format specified on top of
  * this file, the behavior will be unspecified. The initialColor could be the
  * one used by the underlying backend or an arbitrary one. The backend could
  * also assert.
  *
  * @param      parent       nsIDOMWindow parent. This dialog will be dependent
  *                          on this parent. parent must be non-null.
  * @param      title        The title for the color picker widget.
  * @param      initialColor The color to show when the widget is opened. The
  *                          parameter has to follow the format specified on top
  *                          of this file.
  */
  void init(in mozIDOMWindowProxy parent, in AString title, in AString initialColor);

 /**
  * Opens the color dialog asynchrounously.
  * The results are provided via the callback object.
  */
  void open(in nsIColorPickerShownCallback aColorPickerShownCallback);
};