summaryrefslogtreecommitdiffstats
path: root/widget/nsIPrintSettings.idl
diff options
context:
space:
mode:
Diffstat (limited to 'widget/nsIPrintSettings.idl')
-rw-r--r--widget/nsIPrintSettings.idl305
1 files changed, 305 insertions, 0 deletions
diff --git a/widget/nsIPrintSettings.idl b/widget/nsIPrintSettings.idl
new file mode 100644
index 000000000..5c391c1ac
--- /dev/null
+++ b/widget/nsIPrintSettings.idl
@@ -0,0 +1,305 @@
+/* -*- Mode: C++; tab-width: 4; 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/. */
+
+#include "nsISupports.idl"
+
+
+%{ C++
+#include "nsMargin.h"
+#include "nsTArray.h"
+%}
+
+/**
+ * Native types
+ */
+ [ref] native nsNativeIntMarginRef(nsIntMargin);
+ [ref] native IntegerArray(nsTArray<int32_t>);
+
+interface nsIPrintSession;
+
+/**
+ * Simplified graphics interface for JS rendering.
+ */
+[scriptable, uuid(ecc5cbad-57fc-4731-b0bd-09e865bd62ad)]
+
+interface nsIPrintSettings : nsISupports
+{
+ /**
+ * PrintSettings to be Saved Navigation Constants
+ */
+ const unsigned long kInitSaveOddEvenPages = 0x00000001;
+ const unsigned long kInitSaveHeaderLeft = 0x00000002;
+ const unsigned long kInitSaveHeaderCenter = 0x00000004;
+ const unsigned long kInitSaveHeaderRight = 0x00000008;
+ const unsigned long kInitSaveFooterLeft = 0x00000010;
+ const unsigned long kInitSaveFooterCenter = 0x00000020;
+ const unsigned long kInitSaveFooterRight = 0x00000040;
+ const unsigned long kInitSaveBGColors = 0x00000080;
+ const unsigned long kInitSaveBGImages = 0x00000100;
+ const unsigned long kInitSavePaperSize = 0x00000200;
+ const unsigned long kInitSaveResolution = 0x00000400;
+ const unsigned long kInitSaveDuplex = 0x00000800;
+ /* Flag 0x00001000 is unused */
+ const unsigned long kInitSavePaperData = 0x00002000;
+ const unsigned long kInitSaveUnwriteableMargins = 0x00004000;
+ const unsigned long kInitSaveEdges = 0x00008000;
+
+ const unsigned long kInitSaveReversed = 0x00010000;
+ const unsigned long kInitSaveInColor = 0x00020000;
+ const unsigned long kInitSaveOrientation = 0x00040000;
+
+ const unsigned long kInitSavePrinterName = 0x00100000;
+ const unsigned long kInitSavePrintToFile = 0x00200000;
+ const unsigned long kInitSaveToFileName = 0x00400000;
+ const unsigned long kInitSavePageDelay = 0x00800000;
+ const unsigned long kInitSaveMargins = 0x01000000;
+ const unsigned long kInitSaveNativeData = 0x02000000;
+
+ const unsigned long kInitSaveShrinkToFit = 0x08000000;
+ const unsigned long kInitSaveScaling = 0x10000000;
+
+ const unsigned long kInitSaveAll = 0xFFFFFFFF;
+
+ /* Print Option Flags for Bit Field*/
+ const long kPrintOddPages = 0x00000001;
+ const long kPrintEvenPages = 0x00000002;
+ const long kEnableSelectionRB = 0x00000004;
+
+ /* Print Range Enums */
+ const long kRangeAllPages = 0;
+ const long kRangeSpecifiedPageRange = 1;
+ const long kRangeSelection = 2;
+ const long kRangeFocusFrame = 3;
+
+ /* Justification Enums */
+ const long kJustLeft = 0;
+ const long kJustCenter = 1;
+ const long kJustRight = 2;
+
+ /**
+ * FrameSet Default Type Constants
+ */
+ const short kUseInternalDefault = 0;
+ const short kUseSettingWhenPossible = 1;
+
+ /**
+ * Page Size Type Constants
+ */
+ const short kPaperSizeNativeData = 0;
+ const short kPaperSizeDefined = 1;
+
+ /**
+ * Page Size Unit Constants
+ */
+ const short kPaperSizeInches = 0;
+ const short kPaperSizeMillimeters = 1;
+
+ /**
+ * Orientation Constants
+ */
+ const short kPortraitOrientation = 0;
+ const short kLandscapeOrientation = 1;
+
+ /**
+ * Print Frame Constants
+ */
+ const short kNoFrames = 0;
+ const short kFramesAsIs = 1;
+ const short kSelectedFrame = 2;
+ const short kEachFrameSep = 3;
+
+ /**
+ * How to Enable Frame Set Printing Constants
+ */
+ const short kFrameEnableNone = 0;
+ const short kFrameEnableAll = 1;
+ const short kFrameEnableAsIsAndEach = 2;
+
+ /**
+ * Output file format
+ */
+ const short kOutputFormatNative = 0;
+ const short kOutputFormatPS = 1;
+ const short kOutputFormatPDF = 2;
+
+ /**
+ * Set PrintOptions
+ */
+ void SetPrintOptions(in int32_t aType, in boolean aTurnOnOff);
+
+ /**
+ * Get PrintOptions
+ */
+ boolean GetPrintOptions(in int32_t aType);
+
+ /**
+ * Get PrintOptions Bit field
+ */
+ int32_t GetPrintOptionsBits();
+
+ /**
+ * Set PrintOptions Bit field
+ */
+ void SetPrintOptionsBits(in int32_t bits);
+
+ /**
+ * Get the page size in twips, considering the
+ * orientation (portrait or landscape).
+ */
+ void GetEffectivePageSize(out double aWidth, out double aHeight);
+
+ /**
+ * Makes a new copy
+ */
+ nsIPrintSettings clone();
+
+ /**
+ * Assigns the internal values from the "in" arg to the current object
+ */
+ void assign(in nsIPrintSettings aPS);
+
+ /**
+ * Data Members
+ */
+ [noscript] attribute nsIPrintSession printSession; /* We hold a weak reference */
+
+ attribute long startPageRange;
+ attribute long endPageRange;
+
+ /**
+ * The edge measurements define the positioning of the headers
+ * and footers on the page. They're measured as an offset from
+ * the "unwriteable margin" (described below).
+ */
+ attribute double edgeTop; /* these are in inches */
+ attribute double edgeLeft;
+ attribute double edgeBottom;
+ attribute double edgeRight;
+
+ /**
+ * The margins define the positioning of the content on the page.
+ * They're treated as an offset from the "unwriteable margin"
+ * (described below).
+ */
+ attribute double marginTop; /* these are in inches */
+ attribute double marginLeft;
+ attribute double marginBottom;
+ attribute double marginRight;
+ /**
+ * The unwriteable margin defines the printable region of the paper, creating
+ * an invisible border from which the edge and margin attributes are measured.
+ */
+ attribute double unwriteableMarginTop; /* these are in inches */
+ attribute double unwriteableMarginLeft;
+ attribute double unwriteableMarginBottom;
+ attribute double unwriteableMarginRight;
+
+ attribute double scaling; /* values 0.0 - 1.0 */
+ attribute boolean printBGColors; /* Print Background Colors */
+ attribute boolean printBGImages; /* Print Background Images */
+
+ attribute short printRange;
+
+ attribute wstring title;
+ attribute wstring docURL;
+
+ attribute wstring headerStrLeft;
+ attribute wstring headerStrCenter;
+ attribute wstring headerStrRight;
+
+ attribute wstring footerStrLeft;
+ attribute wstring footerStrCenter;
+ attribute wstring footerStrRight;
+
+ attribute short howToEnableFrameUI; /* indicates how to enable the frameset UI */
+ attribute boolean isCancelled; /* indicates whether the print job has been cancelled */
+ attribute short printFrameTypeUsage; /* indicates whether to use the interal value or not */
+ attribute short printFrameType;
+ attribute boolean printSilent; /* print without putting up the dialog */
+ attribute boolean shrinkToFit; /* shrinks content to fit on page */
+ attribute boolean showPrintProgress; /* indicates whether the progress dialog should be shown */
+
+ /* Additional XP Related */
+ attribute wstring paperName; /* name of paper */
+ attribute short paperData; /* native data value */
+ attribute double paperWidth; /* width of the paper in inches or mm */
+ attribute double paperHeight; /* height of the paper in inches or mm */
+ attribute short paperSizeUnit; /* paper is in inches or mm */
+
+ attribute boolean printReversed;
+ attribute boolean printInColor; /* a false means grayscale */
+ attribute long orientation; /* see orientation consts */
+ attribute long numCopies;
+
+ attribute wstring printerName; /* name of destination printer */
+
+ attribute boolean printToFile;
+ attribute wstring toFileName;
+ attribute short outputFormat;
+
+ attribute long printPageDelay; /* in milliseconds */
+
+ attribute long resolution; /* print resolution (dpi) */
+
+ attribute long duplex; /* duplex mode */
+
+ /* initialize helpers */
+ /**
+ * This attribute tracks whether the PS has been initialized
+ * from a printer specified by the "printerName" attr.
+ * If a different name is set into the "printerName"
+ * attribute than the one it was initialized with the PS
+ * will then get intialized from that printer.
+ */
+ attribute boolean isInitializedFromPrinter;
+
+ /**
+ * This attribute tracks whether the PS has been initialized
+ * from prefs. If a different name is set into the "printerName"
+ * attribute than the one it was initialized with the PS
+ * will then get intialized from prefs again.
+ */
+ attribute boolean isInitializedFromPrefs;
+
+ /* C++ Helper Functions */
+ [noscript] void SetMarginInTwips(in nsNativeIntMarginRef aMargin);
+ [noscript] void SetEdgeInTwips(in nsNativeIntMarginRef aEdge);
+ /* Purposely made this an "in" arg */
+ [noscript] void GetMarginInTwips(in nsNativeIntMarginRef aMargin);
+ [noscript] void GetEdgeInTwips(in nsNativeIntMarginRef aEdge);
+
+ /**
+ * We call this function so that anything that requires a run of the event loop
+ * can do so safely. The print dialog runs the event loop but in silent printing
+ * that doesn't happen.
+ *
+ * Either this or ShowPrintDialog (but not both) MUST be called by the print engine
+ * before printing, otherwise printing can fail on some platforms.
+ */
+ [noscript] void SetupSilentPrinting();
+
+ /**
+ * Sets/Gets the "unwriteable margin" for the page format. This defines
+ * the boundary from which we'll measure the EdgeInTwips and MarginInTwips
+ * attributes, to place the headers and content, respectively.
+ *
+ * Note: Implementations of SetUnwriteableMarginInTwips should handle
+ * negative margin values by falling back on the system default for
+ * that margin.
+ */
+ [noscript] void SetUnwriteableMarginInTwips(in nsNativeIntMarginRef aEdge);
+ [noscript] void GetUnwriteableMarginInTwips(in nsNativeIntMarginRef aEdge);
+
+ /**
+ * Get more accurate print ranges from the superior interval
+ * (startPageRange, endPageRange). The aPages array is populated with a
+ * list of pairs (start, end), where the endpoints are included. The print
+ * ranges (start, end), must not overlap and must be in the
+ * (startPageRange, endPageRange) scope.
+ *
+ * If there are no print ranges the aPages array is cleared.
+ */
+ [noscript] void GetPageRanges(in IntegerArray aPages);
+};