MediaSize element
The required MediaSize element provides the size of the media installed in the input bin that is identified by the InputBinEntry element.
MediaSize is defined in the namespace at this URI: https://schemas.microsoft.com/windows/2005/05/wdp/print and referenced by the prefix wprt. (This resource may not be available in some languages and countries.)
Usage
<wprt:MediaSize>
text
</wprt:MediaSize>
Attributes
There are no attributes.
Text value
Required. Must be a string that is valid according to IEEE-ISTO 5101.1-2002 "Media Standardized Names".
Child elements
There are no child elements.
Parent elements
| Element | Description |
|---|---|
|
Describes one of the printer's available input bins. |
Remarks
Each value must be a string that includes the following information:
- The name of the size. This name must consist of a class part and a name part separated by an underscore (_). The class part must be "na", "asme", or "oe" for inch units, and "iso", "jis", "jpn", "prc", or "om" for metric units.
- The dimensions, in inches or millimeters. The specified dimension can include a non-zero decimal fraction set off by a period (.). The shorter dimension must come first, and the dimensions must be separated by the lower-case letter "x".
- The "in" or "mm" suffix to indicate the units.
The name of the size and the dimensions must be separated by an underscore (_). Some value examples are "iso_a4_210x297mm", "iso_c5_162x229mm", "iso_dl_110x220mm", "jis_b4_257x364mm", "na_legal_8.5x14in", "na_letter_8.5x11in". See the IEEE-ISTO 5101.1-2002 "Media Standardized Names" specification for suggested media size names and dimensions. These names should not use the "custom_xxx" class name.
For sizes that do not have standard names, a client or WSD Print Service can create a customized name using the "custom_xxx" class and name, where xxx indicates the custom name of the medium, followed by the dimensions, in inches or millimeters, as for standard names. For example, a custom 3.5 by 5.0 inch medium that represents an index card, could be indicated by the string value "custom_index-card_3.5x5in".
PrinterCapabilities AllowedValue
The Print Service must add customized values configured for the printer to the printer's list of allowed values specified in PrinterCapabilities. If a printer supports the client that supplies custom names that are not one of the allowed values in PrinterCapabilities, the printer's AllowedValue must include both 'custom_max_IIIxJJJmm' and 'custom_min_IIIxJJJmm' (and/or 'custom_max_IIIxJJJin' and 'custom_min_IIIxJJJin') in the list to indicate the minimum and maximum custom sizes that the printer will allow the client to supply.
IHVs can both extend and subset the allowed values for this element.
See also
Send comments about this topic to Microsoft
Build date: 7/19/2012