This topic has not yet been rated - Rate this topic

PrintTaskOptionChangedEventArgs class

Called when a print task option has changed.

Syntax


/* For information about creating or accessing this object, see Remarks. */

Attributes

MarshalingBehaviorAttribute(Agile)
VersionAttribute(NTDDI_WIN8)

Members

The PrintTaskOptionChangedEventArgs class has these types of members:

Methods
Properties

Methods

The PrintTaskOptionChangedEventArgs class inherits methods from the Object class (C#/VB/C++).

Properties

The PrintTaskOptionChangedEventArgs class has these properties.

Property	Access type	Description
OptionId	Read-only	Gets the ID of the print task option that changed.

Remarks

Here is a code snippet that shows how to retrieve the object, when a print task option has changed. First, the app must register to listen for option changes. Once the option is changed, a callback is made to the event listener. Note that in JavaScript, you must use Direct2D printing to change the preview or print content based on option changes because print template is no longer supported. For more information about Direct2D printing, see Printing and command lists.

JavaScript



// Retreive the advanced print task options
var printDetailedOptions = Windows.Graphics.Printing.OptionDetails.PrintTaskOptionDetails.getFromPrintTaskOptions(printTask.options);

// Create a new list option 
var pageRange = printDetailedOptions.createItemListOption("PageRange", "Page Range"); 
pageRange.addItem("PrintAll", "Print all"); 
pageRange.addItem("PrintSelection", "Print Selection"); 
pageRange.addItem("PrintRange", "Print Range"); 

// Add the custom option to the option list 
printDetailedOptions.displayedOptions.append("PageRange"); 

// Register the handler for option change event. 
printDetailedOptions.onoptionchanged = onOptionsChanged; 
//The callback function for when an option has changed. optionsEvent is an object of type: PrintTaskOptionChangedEventArgs
function onOptionsChanged(optionsEvent) { }

Requirements

Minimum supported client	Windows 8 [Windows Store apps only]
Minimum supported server	Windows Server 2012 [Windows Store apps only]
Namespace	Windows.Graphics.Printing.OptionDetails Windows::Graphics::Printing::OptionDetails [C++]
Metadata	Windows.winmd

Build date: 12/4/2012