From 5f8de423f190bbb79a62f804151bc24824fa32d8 Mon Sep 17 00:00:00 2001 From: "Matt A. Tobin" Date: Fri, 2 Feb 2018 04:16:08 -0500 Subject: Add m-esr52 at 52.6.0 --- widget/nsIPrintSettingsService.idl | 157 +++++++++++++++++++++++++++++++++++++ 1 file changed, 157 insertions(+) create mode 100644 widget/nsIPrintSettingsService.idl (limited to 'widget/nsIPrintSettingsService.idl') diff --git a/widget/nsIPrintSettingsService.idl b/widget/nsIPrintSettingsService.idl new file mode 100644 index 000000000..198581b34 --- /dev/null +++ b/widget/nsIPrintSettingsService.idl @@ -0,0 +1,157 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ +/* 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/. */ + +/* Interface to the Service for gwetting the Global PrintSettings object + or a unique PrintSettings object +*/ + +#include "nsISupports.idl" + +interface nsIPrintSettings; +interface nsIWebBrowserPrint; + +%{ C++ +namespace mozilla { +namespace embedding { + class PrintData; +} +} +%} + +/** + * Native types + */ +[ref] native PrintDataRef(const mozilla::embedding::PrintData); +[ptr] native PrintDataPtr(mozilla::embedding::PrintData); + +[scriptable, uuid(841387C8-72E6-484b-9296-BF6EEA80D58A)] +interface nsIPrintSettingsService : nsISupports +{ + /** + * Returns a "global" PrintSettings object + * Creates a new the first time, if one doesn't exist. + * + * Then returns the same object each time after that. + * + * Initializes the globalPrintSettings from the default printer + */ + readonly attribute nsIPrintSettings globalPrintSettings; + + /** + * Returns a new, unique PrintSettings object each time. + * + * For example, if each browser was to have its own unique + * PrintSettings, then each browser window would call this to + * create its own unique PrintSettings object. + * + * If each browse window was to use the same PrintSettings object + * then it should use "globalPrintSettings" + * + * Initializes the newPrintSettings from the unprefixed printer + * (Note: this may not happen if there is an OS specific implementation.) + * + */ + readonly attribute nsIPrintSettings newPrintSettings; + + /** + * The name of the last printer used, or else the system default printer. + */ + readonly attribute wstring defaultPrinterName; + + /** + * Initializes certain settings from the native printer into the PrintSettings + * if aPrinterName is null then it uses the default printer name if it can + * These settings include, but are not limited to: + * Page Orientation + * Page Size + * Number of Copies + */ + void initPrintSettingsFromPrinter(in wstring aPrinterName, in nsIPrintSettings aPrintSettings); + + /** + * Reads PrintSettings values from Prefs, + * the values to be read are indicated by the "flags" arg. + * + * aPrintSettings should be initialized with the name of a printer. First + * it reads in the PrintSettings from the last print job. Then it uses the + * PrinterName in the PrinterSettings to read any settings that were saved + * just for that printer. + * + * aPS - PrintSettings to have its settings read + * aUsePrinterNamePrefix - indicates whether to use the printer name as a prefix + * aFlags - indicates which prefs to read, see nsIPrintSettings.idl for the + * const values. + * + * Items not read: + * startPageRange, endPageRange, scaling, printRange, title + * docURL, howToEnableFrameUI, isCancelled, printFrameTypeUsage + * printFrameType, printSilent, shrinkToFit, numCopies, + * printerName + * + */ + void initPrintSettingsFromPrefs(in nsIPrintSettings aPrintSettings, in boolean aUsePrinterNamePrefix, in unsigned long aFlags); + + /** + * Writes PrintSettings values to Prefs, + * the values to be written are indicated by the "flags" arg. + * + * If there is no PrinterName in the PrinterSettings + * the values are saved as the "generic" values not associated with any printer. + * If a PrinterName is there, then it saves the items qualified for that Printer + * + * aPS - PrintSettings to have its settings saved + * aUsePrinterNamePrefix - indicates whether to use the printer name as a prefix + * aFlags - indicates which prefs to save, see nsIPrintSettings.idl for the const values. + * + * Items not written: + * startPageRange, endPageRange, scaling, printRange, title + * docURL, howToEnableFrameUI, isCancelled, printFrameTypeUsage + * printFrameType, printSilent, shrinkToFit, numCopies + * + */ + void savePrintSettingsToPrefs(in nsIPrintSettings aPrintSettings, in boolean aUsePrinterNamePrefix, in unsigned long aFlags); + + /** + * Given some nsIPrintSettings and (optionally) an nsIWebBrowserPrint, + * populates a PrintData representing them which can be sent over IPC. Values + * are only ever read from aSettings and aWBP. + * + * @param aSettings + * An nsIPrintSettings for a print job. + * @param aWBP (optional) + * The nsIWebBrowserPrint for the print job. + * @param data + * Pointer to a pre-existing PrintData to populate. + * + * @return nsresult + */ + [noscript] + void SerializeToPrintData(in nsIPrintSettings aPrintSettings, + in nsIWebBrowserPrint aWebBrowserPrint, + in PrintDataPtr data); + + /** + * This function is the opposite of SerializeToPrintData, in that it takes + * a PrintData, and populates a pre-existing nsIPrintSettings with the data + * from PrintData. + * + * @param PrintData + * Printing information sent through IPC. + * @param settings + * A pre-existing nsIPrintSettings to populate with the PrintData. + * + * @return nsresult + */ + [noscript] + void DeserializeToPrintSettings(in PrintDataRef data, + in nsIPrintSettings aPrintSettings); + +}; + +%{C++ +// {841387C8-72E6-484b-9296-BF6EEA80D58A} +#define NS_PRINTSETTINGSSERVICE_IID \ + {0x841387c8, 0x72e6, 0x484b, { 0x92, 0x96, 0xbf, 0x6e, 0xea, 0x80, 0xd5, 0x8a}} +%} -- cgit v1.2.3