Option
This topic is not current. For the most current information, see the Print Schema Specification.
An Option element contains all of the Property and ScoredProperty elements associated with this option.
<Option>
The following table lists the XML attributes that may be pertain to this element.
XML Attribute | Details |
---|---|
constrained |
This attribute is optional for a PrintCapabilities document. This attribute indicates whether the Option is available for selection or use. This XML attribute can be set to one of the following values: None, PrintTicketSettings, AdminSetting or DeviceSettings. See XML Attributes |
name |
Holds the name of the Option, either a standard Option or a privately-defined Option. The XML attribute is used this way in order to differentiate between Option instances. |
For more information, please see XML Attributes section.
The following table lists the elements that may be parents of this element, the elements that may be children of this element, and any restrictions on the element itself.
Category | Details |
---|---|
Parent elements |
Feature |
Child elements |
Property (zero or more) ScoredProperty (zero or more for Options with XML Attribute 'name'; one or more for Options not utilizing XML Attribute 'name'*) * only public Options defined in Print Schema can have no 'name' attribute, such as DocumentNUp) |
This element |
No character data is permitted. Duplicate child siblings are not permitted. |
An Option definition element may not have any configuration dependencies.
The purpose of the Option element is to characterize one of the states that a device configuration attribute, represented by a Feature element, can assume. Each Option element definition contains one or more ScoredProperty elements that describe an intrinsic or essential characteristic of that Option. To facilitate portability and preservation of intent, the Print Schema defines many common Feature elements and a variety of Option elements for each Feature. It is therefore important to use Print Schema-defined Option elements, if at all possible, before you create your own Option definitions. Understanding the process of defining Option elements provides useful insights into the way the PrintCapabilities document and PrintTickets are used in the Microsoft .NET Framework version 3.0 and Windows Vista printing architecture.
The following example defines a name for the Option.
<psf:Option name="psk:PrintFront" />