widget/nsIPrintDialogService.idl

   1 /* -*- Mode: C++; tab-width: 2; 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 /* Doc interface here */
   7
   8 #include "nsISupports.idl"
   9 #include "nsIWebProgressListener.idl"
  10 #include "nsIPrintSettings.idl"
  11 #include "nsIObserver.idl"
  12
  13 interface mozIDOMWindowProxy;
  14
  15 /**
  16  * Service for opening native print dialogs provided by the operating system.
  17  * (The widget code may customize the dialog.)
  18  */
  19 [scriptable, uuid(88af6712-a9fd-4393-9af3-3ffbb1f2caaf)]
  20 interface nsIPrintDialogService : nsISupports
  21 {
  22   /**
  23    * Initialize the service.
  24    */
  25   void init();
  26
  27   /**
  28    * Show the print dialog.
  29    * @param aParent   A DOM window the dialog will be parented to.
  30    * @param aHaveSelection A boolean indicating whether the document to be
  31    *                  printed has some selected text, which is used to
  32    *                  determine whether the "Print selection only" radio
  33    *                  button is enabled in the print settings dialog.
  34    * @param aSettings On entry, this contains initial settings for the
  35    *                  print dialog. On return, if the print operation should
  36    *                  proceed, then this has been updated with the settings
  37    *                  that the user selected in the dialog.
  38    * @return NS_OK if the print operation should proceed
  39    * @return NS_ERROR_ABORT if the user indicated not to proceed
  40    * @return a suitable error for failures to show the print dialog.
  41    */
  42   void showPrintDialog(in mozIDOMWindowProxy aParent,
  43                        in boolean aHaveSelection,
  44                        in nsIPrintSettings aPrintSettings);
  45
  46   /**
  47    * Show the page setup dialog. Note that there is no way to tell whether the
  48    * user clicked OK or Cancel on the dialog.
  49    * @param aParent   A DOM window the dialog will be parented to.
  50    * @param aSettings On entry, this contains initial settings for the
  51    *                  page setup dialog. On return, if the dialog wasn't
  52    *                  cancelled, then this has been updated with the settings
  53    *                  that the user selected in the dialog.
  54    */
  55   void showPageSetupDialog(in mozIDOMWindowProxy aParent,
  56                            in nsIPrintSettings aPrintSettings);
  57
  58 };