确定客户端在设置此 printservice 的作业时,是否可以指定给定类别中的打印属性值。打印属性值是实现了接口 attribute
的类的实例。
如果 flavor
为 null 并且 attributes
为 null 或是一个空集合,则此方法为任何可能的作业返回此 printservice 支持的所有打印属性值。如果 flavor
不为 null 或 attributes
不是空集合,则此方法只返回与给定 doc flavor 和/或属性集兼容的打印属性值。也就是说,null 返回值可能指示指定此属性与指定的 docflavor 不兼容。另外,如果 docflavor 不为 null,则它必须是此 printservice 支持的 flavor,否则将抛出 illegalargumentexception。
如果 attributes
参数包含其类别与 category
参数相同的 attribute,则该服务必须忽略 attributeset 中的此属性。
为了准确表示上下文,在此集合中必须包括要在 doc
上指定的 docattribute
。
此方法返回一个 object,因为不同的打印属性类别以不同的方式指示受支持的属性值。包 javax.print.attribute.standard
中每个打印属性的文档都描述了每个属性如何指示其受支持的值。指示这种支持的可能方式包括:
-
返回属性类别的单个实例来指示所使用的任何值都是合法的,例如由其值是任意文本字符串的属性所使用的值。(与返回的属性对象的值无关。)
-
返回一个或多个属性类别实例的数组,其中包含所使用的合法值,例如由具有枚举值列表的属性所使用的值。数组的类型是一个指定属性类别类型的数组,由其
getcategory(class)
方法返回。
-
返回(某个类而不是属性类别)的单个对象,指示有关所用合法值的绑定,例如由其值必须位于一定范围内的整数值属性所使用的值。
- 参数:
category
- 要测试的打印属性类别。它必须是实现了接口 attribute
的 class
。flavor
- 用于假定作业的 doc flavor,或者为 null。attributes
- 用于假定作业的打印属性集(包括作业级属性和 doc 级属性),或者为 null。
- 返回:
- 指示
category
受支持的值的 object,如果此 printservice 不支持在打印请求的 category
中指定 doc 级或作业级的属性,则返回 null。
- 抛出:
nullpointerexception
- (未经检查的异常)如果 category
为 null。
illegalargumentexception
- (未经检查的异常)如果 category
并非实现了接口 attribute
的 class
,或者此服务不支持 docflavor
。