PrintTaskSourceRequestedHandler delegate

Applies to Windows only

Occurs when a print task requests the document to print. The supplied print document must implement the IPrintDocumentSource interface.

Syntax


var printTaskSourceRequestedHandler = function(args) {
 /* Your code */
}

Attributes

[Version(0x06020000)]

Parameters

args

Type: PrintTaskSourceRequestedArgs

Pointer to a PrintTaskSourceRequestedArgs object.

Remarks

The PrintTaskSourceRequestedHandler is called to complete the initialization of a PrintTask object. This two-phase initialization model is designed to enable an app to quickly respond to the PrintTaskRequested event by creating the PrintTask object. Then later, when printing is actually invoked, PrintTaskSourceRequestedHandler does the work required to prepare the content to be previewed and eventually printed. The deadline for completing work in the PrintTaskSourceRequestedHandler is much larger than the deadline for completing work in the PrintTaskRequested handler.

For example, consider an app that needs to download information from the Cloud to complete the printing operation for the details of a boarding pass. The app should respond quickly to the PrintTaskRequested event by creating a PrintTask object and a name for the print operation, for example "Fabrikam Boarding Pass." The app then provides PrintTaskSourceRequestedHandler with a pointer the PrintTask object. When this handler is invoked the app then initiates the call to retrieve the actual content of the boarding pass so that print preview and printing can be performed.

An app has two options for creating a print document source object:

  • Use a framework provided print document source. Both the HTML5/JavaScript and XAML frameworks provide implementations of objects which implement the IPrintDocumentSource interface. For HTML5/JavaScript apps see MSApp.getHtmlPrintDocumentSource. For information about developing print-capable apps with the extensible application markup language (XAML), see Windows.UI.Xaml.Printing.PrintDocument.
  • Provide a custom print document source. An app may choose to provide its own custom implementation of an IPrintDocumentSource object. Doing so requires a good understanding of Direct2D and/or the XPS APIs. For an example of how an app can provide its own custom print document source, see the D2D Printing sample.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

Windows.Graphics.Printing
Windows::Graphics::Printing [C++]

Metadata

Windows.winmd

See also

PrintTaskRequested
PrintTaskSourceRequestedArgs
PrintTask
IPrintDocumentSource
MSApp.getHtmlPrintDocumentSource
Windows.UI.Xaml.Printing.PrintDocument

 

 

Show:
© 2014 Microsoft