gecko-dev/embedding/browser/nsIPrintingPromptService.idl
Birunthan Mohanathas 0ca6cb28dd Bug 1054703 - Part 8: Flatten embedding/browser/webBrowser/ into parent directory. r=bsmedberg
--HG--
rename : embedding/browser/webBrowser/nsCTooltipTextProvider.h => embedding/browser/nsCTooltipTextProvider.h
rename : embedding/browser/webBrowser/nsCWebBrowser.idl => embedding/browser/nsCWebBrowser.idl
rename : embedding/browser/webBrowser/nsCommandHandler.cpp => embedding/browser/nsCommandHandler.cpp
rename : embedding/browser/webBrowser/nsCommandHandler.h => embedding/browser/nsCommandHandler.h
rename : embedding/browser/webBrowser/nsContextMenuInfo.cpp => embedding/browser/nsContextMenuInfo.cpp
rename : embedding/browser/webBrowser/nsContextMenuInfo.h => embedding/browser/nsContextMenuInfo.h
rename : embedding/browser/webBrowser/nsDocShellTreeOwner.cpp => embedding/browser/nsDocShellTreeOwner.cpp
rename : embedding/browser/webBrowser/nsDocShellTreeOwner.h => embedding/browser/nsDocShellTreeOwner.h
rename : embedding/browser/webBrowser/nsEmbedStream.cpp => embedding/browser/nsEmbedStream.cpp
rename : embedding/browser/webBrowser/nsEmbedStream.h => embedding/browser/nsEmbedStream.h
rename : embedding/browser/webBrowser/nsICommandHandler.idl => embedding/browser/nsICommandHandler.idl
rename : embedding/browser/webBrowser/nsIContextMenuListener.idl => embedding/browser/nsIContextMenuListener.idl
rename : embedding/browser/webBrowser/nsIContextMenuListener2.idl => embedding/browser/nsIContextMenuListener2.idl
rename : embedding/browser/webBrowser/nsIEmbeddingSiteWindow.idl => embedding/browser/nsIEmbeddingSiteWindow.idl
rename : embedding/browser/webBrowser/nsIPrintPreviewNavigation.idl => embedding/browser/nsIPrintPreviewNavigation.idl
rename : embedding/browser/webBrowser/nsIPrintingPrompt.idl => embedding/browser/nsIPrintingPrompt.idl
rename : embedding/browser/webBrowser/nsIPrintingPromptService.idl => embedding/browser/nsIPrintingPromptService.idl
rename : embedding/browser/webBrowser/nsITooltipListener.idl => embedding/browser/nsITooltipListener.idl
rename : embedding/browser/webBrowser/nsITooltipTextProvider.idl => embedding/browser/nsITooltipTextProvider.idl
rename : embedding/browser/webBrowser/nsIWebBrowser.idl => embedding/browser/nsIWebBrowser.idl
rename : embedding/browser/webBrowser/nsIWebBrowserChrome.idl => embedding/browser/nsIWebBrowserChrome.idl
rename : embedding/browser/webBrowser/nsIWebBrowserChrome2.idl => embedding/browser/nsIWebBrowserChrome2.idl
rename : embedding/browser/webBrowser/nsIWebBrowserChrome3.idl => embedding/browser/nsIWebBrowserChrome3.idl
rename : embedding/browser/webBrowser/nsIWebBrowserChromeFocus.idl => embedding/browser/nsIWebBrowserChromeFocus.idl
rename : embedding/browser/webBrowser/nsIWebBrowserFocus.idl => embedding/browser/nsIWebBrowserFocus.idl
rename : embedding/browser/webBrowser/nsIWebBrowserPrint.idl => embedding/browser/nsIWebBrowserPrint.idl
rename : embedding/browser/webBrowser/nsIWebBrowserSetup.idl => embedding/browser/nsIWebBrowserSetup.idl
rename : embedding/browser/webBrowser/nsIWebBrowserStream.idl => embedding/browser/nsIWebBrowserStream.idl
rename : embedding/browser/webBrowser/nsWebBrowser.cpp => embedding/browser/nsWebBrowser.cpp
rename : embedding/browser/webBrowser/nsWebBrowser.h => embedding/browser/nsWebBrowser.h
rename : embedding/browser/webBrowser/nsWebBrowserContentPolicy.cpp => embedding/browser/nsWebBrowserContentPolicy.cpp
rename : embedding/browser/webBrowser/nsWebBrowserContentPolicy.h => embedding/browser/nsWebBrowserContentPolicy.h
2014-08-20 10:27:17 -07:00

166 lines
7.9 KiB
Plaintext

/* -*- 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/. */
/* Doc interface here */
#include "nsISupports.idl"
#include "nsIWebBrowserPrint.idl"
#include "nsIWebProgressListener.idl"
#include "nsIPrintProgressParams.idl"
#include "nsIPrintSettings.idl"
#include "nsIObserver.idl"
interface nsIDOMWindow;
[scriptable, uuid(75D1553D-63BF-4b5d-A8F7-E4E4CAC21BA4)]
interface nsIPrintingPromptService : nsISupports
{
/**
* This service enables embedders to implement their own Print and Progress Dialogs.
* Each platform has a "base" or "basckstop" implementation of the service. The
* service is automatically registered at start up.
*
* Historically, platform toolkits with native dialogs have implemented them in the GFX layer
* Usually they were displayed when a new DeviceContextSpec specific to that platform
* was created.
*
* Windows: The GFX layer no longers supports default toolkit behavior for displaying the
* native Print Dialog.
* If an embedder implemented service returns any error code (other than NS_ERROR_ABORT)
* printing will terminate.
*
* Returning NS_OK assumes that the PrintSettings object was correctly filled in and
* if it does not have valid fields for printer name, etc. it may also terminate.
*
* Defaults for platform service:
* showPrintDialog - displays a native dialog
* showPageSetup - displays a XUL dialog
* showProgress - displays a XUL dialog
* showPrinterProperties - n/a
*
* Summary for Windows Embedders:
* Stated once again: There is no "fallback" native platform support in GFX for the
* displaying of the native print dialog. The current default implementation for Windows
* display a native print dialog but a XUL-based progress dialog.
* If you wish to have a native progress dialog on Windows you will have to create and
* register your own service.
*
* Note: The Windows version Mozilla implements this service which is
* automatically built and registered for you. You can use it as an example.
* It is located at "mozilla/embedding/components/printingui/win". That service
* is capable of displaying a native print dialog and a XUL progress dialog.
*
* To fly your own dialog you may:
*
* 1) Implement this service to display at least the Print Dialog and a Print Progress Dialog
* or you may implement just one of the dialogs and pass back NS_ERROR_NOT_IMPLEMENTED
* for any of the others.
*
* 2) For the Print Dialog:
* You may stub out this service by having all the methods return NS_ERROR_NOT_IMPLEMENTED.
* You can then fly you own dialog and then properly fill in the PrintSettings object
* before calling nsIWebBrowserPrint's Print method. If you stub out this service
* you MUST set "printSilent" to true, if you do not, Printing will terminate and an
* error dialog will be displayed.
*
* Mac: The GFX layer still supports default toolkit behavior for displaying the Print Dialog.
* If an embedder implemented service returns NS_ERROR_NOT_IMPLEMENTED for "showPrintDialog"
* The toolkit will display the native print dialog.
*
* Defaults for platform service:
* Mac OS9: showPrintDialog - displays a native dialog
* showPageSetup - displays a native dialog
* showProgress - displays a XUL dialog
* showPrinterProperties - n/a
*
* Mac OSX: showPrintDialog - displays a native dialog
* showPageSetup - displays a native dialog
* showProgress - not implemented (provided by OS)
* showPrinterProperties - n/a
*
* GTK: There are no native dialog for GTK.
*
* Defaults for platform service:
* showPrintDialog - displays a XUL dialog
* showPageSetup - displays a XUL dialog
* showProgress - displays a XUL dialog
* showPrinterProperties - displays a XUL dialog
*
*/
/**
* Show the Print Dialog
*
* @param parent - a DOM windows the dialog will be parented to (required)
* @param webBrowserPrint - represents the document to be printed (required)
* @param printSettings - PrintSettings for print "job" (required)
*
*/
void showPrintDialog(in nsIDOMWindow parent,
in nsIWebBrowserPrint webBrowserPrint,
in nsIPrintSettings printSettings);
/**
* Shows the print progress dialog
*
* @param parent - a DOM windows the dialog will be parented to
* @param webBrowserPrint - represents the document to be printed
* @param printSettings - PrintSettings for print "job"
* @param openDialogObserver - an observer that will be notifed when the dialog is opened
* @param isForPrinting - true - for printing, false for print preview
* @param webProgressListener - additional listener can be registered for progress notifications
* @param printProgressParams - parameter object for passing progress state
* @param notifyOnOpen - this indicates that the observer will be notified when the progress
* dialog has been opened. If false is returned it means the observer
* (usually the caller) shouldn't wait
* For Print Preview Progress there is intermediate progress
*/
void showProgress(in nsIDOMWindow parent,
in nsIWebBrowserPrint webBrowserPrint,
in nsIPrintSettings printSettings,
in nsIObserver openDialogObserver,
in boolean isForPrinting,
out nsIWebProgressListener webProgressListener,
out nsIPrintProgressParams printProgressParams,
out boolean notifyOnOpen);
/**
* Shows the print progress dialog
*
* @param parent - a DOM windows the dialog will be parented to (required)
* @param printSettings - PrintSettings for page setup (required)
* @param aObs - An observer to know if the contents of the Print Settings
* object has changed while the dialog is being shown.
* For example, some platforms may implement an "Apply" button (not required)
*/
void showPageSetup(in nsIDOMWindow parent,
in nsIPrintSettings printSettings,
in nsIObserver aObs);
/**
* Sometimes platforms need to bring up a special properties dialog for showing
* print specific properties. Although the PrintSettings has a place to set the
* printer name, here is is an argument to be clear as to what printer is being
* asked to have the properties set for it. The Printer name in the PS is ignored.
*
* @param parent - a DOM windows the dialog will be parented to (required)
* @param printerName - name of printer (required)
* @param printSettings - PrintSettings for page setup (required)
*/
void showPrinterProperties(in nsIDOMWindow parent,
in wstring printerName,
in nsIPrintSettings printSettings);
};
%{C++
// {260FEDC5-524D-4aa6-9A41-E829F4C78B92}
#define NS_PRINTINGPROMPTSERVICE_IID \
{0x260fedc5, 0x524d, 0x4aa6, { 0x9a, 0x41, 0xe8, 0x29, 0xf4, 0xc7, 0x8b, 0x92}}
%}