nsIPrintingPromptService

IID:75D1553D-63BF-4b5d-A8F7-E4E4CAC21BA4
Inherits From:nsISupports

This interface is implemented by the following components:


Methods

void showPageSetup ( nsIDOMWindow parent , nsIPrintSettings printSettings , nsIObserver obs ) void showPrintDialog ( nsIDOMWindow parent , nsIWebBrowserPrint webBrowserPrint , nsIPrintSettings printSettings ) void showPrinterProperties ( nsIDOMWindow parent , PRUnichar* printerName , nsIPrintSettings printSettings ) void showProgress ( nsIDOMWindow parent , nsIWebBrowserPrint webBrowserPrint , nsIPrintSettings printSettings , nsIObserver openDialogObserver , PRBool isForPrinting , out nsIWebProgressListener webProgressListener , out nsIPrintProgressParams printProgressParams , out PRBool notifyOnOpen )

void showPageSetup ( nsIDOMWindow parent , nsIPrintSettings printSettings , nsIObserver obs )

Shows the print progress dialog

Arguments:
parent: - a DOM windows the dialog will be parented to (required)
printSettings: - PrintSettings for page setup (required)
obs: - 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 showPrintDialog ( nsIDOMWindow parent , nsIWebBrowserPrint webBrowserPrint , nsIPrintSettings printSettings )

Show the Print Dialog

Arguments:
parent: - a DOM windows the dialog will be parented to (required)
webBrowserPrint: - represents the document to be printed (required)
printSettings: - PrintSettings for print "job" (required)

void showPrinterProperties ( nsIDOMWindow parent , PRUnichar* printerName , nsIPrintSettings printSettings )

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.

Arguments:
parent: - a DOM windows the dialog will be parented to (required)
printerName: - name of printer (required)
printSettings: - PrintSettings for page setup (required)

void showProgress ( nsIDOMWindow parent , nsIWebBrowserPrint webBrowserPrint , nsIPrintSettings printSettings , nsIObserver openDialogObserver , PRBool isForPrinting , out nsIWebProgressListener webProgressListener , out nsIPrintProgressParams printProgressParams , out PRBool notifyOnOpen )

Shows the print progress dialog

Arguments:
parent: - a DOM windows the dialog will be parented to
webBrowserPrint: - represents the document to be printed
printSettings: - PrintSettings for print "job"
openDialogObserver: - an observer that will be notifed when the dialog is opened
isForPrinting: - true - for printing, false for print preview
webProgressListener: - additional listener can be registered for progress notifications
printProgressParams: - parameter object for passing progress state
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

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com