widget/nsIPrinter.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3  * License, v. 2.0. If a copy of the MPL was not distributed with this
   4  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   5
   6 #include "nsIPaper.idl"
   7 #include "nsIPrintSettings.idl"
   8 #include "nsISupports.idl"
   9
  10 [scriptable, uuid(855ae9dd-62a4-64aa-9c60-b1078ff028f1)]
  11 interface nsIPrinterInfo : nsISupports
  12 {
  13   /**
  14    * An array of nsIPaper instances that represents the available paper sizes.
  15    */
  16   readonly attribute Array<nsIPaper> paperList;
  17   /**
  18    * nsIPrintSettings object containing the default settings for a printer.
  19    */
  20   readonly attribute nsIPrintSettings defaultSettings;
  21 };
  22
  23 [scriptable, uuid(d2dde9bb-df86-469c-bfcc-fd95a44b1db8)]
  24 interface nsIPrinter : nsISupports
  25 {
  26   /**
  27    * The name of the printer.
  28    */
  29   readonly attribute AString name;
  30
  31   /**
  32    * The system name of the printer.
  33    *
  34    * This may be faster for lookup in nsIPrinterList functions, but will only
  35    * work for functions that will accept the system name.
  36    */
  37   readonly attribute AString systemName;
  38
  39   /**
  40    * Returns a Promise that resolves to a nsIPrinterInfo.
  41    * This will contain the default printer settings, and the list of paper
  42    * sizes supported by the printer.
  43    */
  44   [implicit_jscontext]
  45   readonly attribute Promise printerInfo;
  46
  47   /**
  48    * Returns a Promise that resolves to true or false to indicate whether this
  49    * printer supports duplex printing.
  50    */
  51   [implicit_jscontext]
  52   readonly attribute Promise supportsDuplex;
  53
  54   /**
  55    * Returns a Promise that resolves to true or false to indicate whether this
  56    * printer supports color printing.
  57    */
  58   [implicit_jscontext]
  59   readonly attribute Promise supportsColor;
  60
  61   /**
  62    * Returns a Promise that resolves to true or false to indicate whether this
  63    * printer supports monochrome printing.
  64    */
  65   [implicit_jscontext]
  66   readonly attribute Promise supportsMonochrome;
  67
  68   /**
  69    * Returns a Promise that resolves to true or false to indicate whether this
  70    * printer supports collation.
  71    */
  72   [implicit_jscontext]
  73   readonly attribute Promise supportsCollation;
  74 };