Identifies the attributes that are unsupported for a print request in the context of a particular
DocFlavor
. This method is useful for validating a potential print job and identifying the specific attributes which cannot be supported. It is important to supply only a supported
DocFlavor
or an
IllegalArgumentException
will be thrown. If the return value from this method is
null
, all attributes are supported.
DocAttribute
s which are to be specified on the Doc
must be included in this set to accurately represent the context.
If the return value is non-null
, all attributes in the returned set are unsupported with this DocFlavor
. The returned set does not distinguish attribute categories that are unsupported from unsupported attribute values.
A supported print request can then be created by removing all unsupported attributes from the original attribute set, except in the case that the DocFlavor
is unsupported.
If any attributes are unsupported only because they are in conflict with other attributes then it is at the discretion of the service to select the attribute(s) to be identified as the cause of the conflict.
Use isDocFlavorSupported()
to verify that a DocFlavor
is supported before calling this method.