uTools-Manuals/docs/java/javax/print/PrintService.html

<div class="header">
<div class="subTitle">
     javax.print 
   </div>
<h2 class="title" title="Interface PrintService">Interface PrintService</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Known Subinterfaces: 
       </dt>
<dd>
<span><a href="../../javax/print/MultiDocPrintService.html" title="javax.print中的接口">MultiDocPrintService</a></span>
</dd>
</dl>
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../javax/print/StreamPrintService.html" title="javax.print中的类">StreamPrintService</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">PrintService</span></pre>
<div class="block">
<span>Interface PrintService是DocPrintJob的工厂。</span>
<span>PrintService描述打印机的功能，可以查询打印机支持的属性。</span>
<p> <span>例：</span> </p>
<pre>  <span><code> DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT; PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet(); aset.add(MediaSizeName.ISO_A4); PrintService[] pservices = PrintServiceLookup.lookupPrintServices(flavor, aset); if (pservices.length &gt; 0) { DocPrintJob pj = pservices[0].createPrintJob(); try { FileInputStream fis = new FileInputStream("test.ps"); Doc doc = new SimpleDoc(fis, flavor, null); pj.print(doc, aset); } catch (FileNotFoundException fe) { } catch (PrintException e) { } } </code></span> </pre>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#addPrintServiceAttributeListener-javax.print.event.PrintServiceAttributeListener-">addPrintServiceAttributeListener</a></span>(<a href="../../javax/print/event/PrintServiceAttributeListener.html" title="interface in javax.print.event">PrintServiceAttributeListener</a> listener)</code>
<div class="block">
              在此PrintService上为事件注册一个侦听器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../javax/print/DocPrintJob.html" title="interface in javax.print">DocPrintJob</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#createPrintJob--">createPrintJob</a></span>()</code>
<div class="block">
              创建并返回一个能够处理任何受支持文档风格的数据的PrintJob。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#equals-java.lang.Object-">equals</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</code>
<div class="block">
              确定两个服务是否指向相同的底层服务。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>&lt;T extends <a href="../../javax/print/attribute/PrintServiceAttribute.html" title="interface in javax.print.attribute">PrintServiceAttribute</a>&gt;<br/>T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getAttribute-java.lang.Class-">getAttribute</a></span>(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; category)</code>
<div class="block">
              获取单个指定服务属性的值。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../javax/print/attribute/PrintServiceAttributeSet.html" title="interface in javax.print.attribute">PrintServiceAttributeSet</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getAttributes--">getAttributes</a></span>()</code>
<div class="block">
              获取此打印服务的一组打印机描述属性，以提供此打印服务的状态。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getDefaultAttributeValue-java.lang.Class-">getDefaultAttributeValue</a></span>(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;? extends <a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a>&gt; category)</code>
<div class="block">
              确定此打印服务在给定类别中的默认打印属性值。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getName--">getName</a></span>()</code>
<div class="block">
              返回此打印服务的字符串名称，可由应用程序用于请求特定打印服务。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../javax/print/ServiceUIFactory.html" title="class in javax.print">ServiceUIFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getServiceUIFactory--">getServiceUIFactory</a></span>()</code>
<div class="block">
              返回用于UI组件的工厂，允许用户以各种角色与服务进行交互。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;?&gt;[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getSupportedAttributeCategories--">getSupportedAttributeCategories</a></span>()</code>
<div class="block">
              确定在为此打印服务设置作业时客户端可以指定的打印属性类别。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getSupportedAttributeValues-java.lang.Class-javax.print.DocFlavor-javax.print.attribute.AttributeSet-">getSupportedAttributeValues</a></span>(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;? extends <a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a>&gt; category, <a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor, <a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a> attributes)</code>
<div class="block">
              确定为此打印服务设置作业时客户端可以在给定类别中指定的打印属性值。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getSupportedDocFlavors--">getSupportedDocFlavors</a></span>()</code>
<div class="block">
              确定在为此 
             <code>PrintService</code>设置作业时，客户端可以指定的打印数据格式。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#getUnsupportedAttributes-javax.print.DocFlavor-javax.print.attribute.AttributeSet-">getUnsupportedAttributes</a></span>(<a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor, <a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a> attributes)</code>
<div class="block">
              在特定DocFlavor的上下文中标识不支持打印请求的属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#hashCode--">hashCode</a></span>()</code>
<div class="block">
              该方法应与 
             <code>equals(Object)</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#isAttributeCategorySupported-java.lang.Class-">isAttributeCategorySupported</a></span>(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;? extends <a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a>&gt; category)</code>
<div class="block">
              确定在为此打印服务设置作业时，客户端是否可以指定给定的打印属性类别。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#isAttributeValueSupported-javax.print.attribute.Attribute-javax.print.DocFlavor-javax.print.attribute.AttributeSet-">isAttributeValueSupported</a></span>(<a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a> attrval, <a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor, <a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a> attributes)</code>
<div class="block">
              确定在为此打印服务设置作业时，客户端是否可以指定给定的打印属性值。 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#isDocFlavorSupported-javax.print.DocFlavor-">isDocFlavorSupported</a></span>(<a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor)</code>
<div class="block">
              确定此打印服务是否支持特定的 
             <code>DocFlavor</code> 。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/PrintService.html#removePrintServiceAttributeListener-javax.print.event.PrintServiceAttributeListener-">removePrintServiceAttributeListener</a></span>(<a href="../../javax/print/event/PrintServiceAttributeListener.html" title="interface in javax.print.event">PrintServiceAttributeListener</a> listener)</code>
<div class="block">
              从此打印服务中删除打印服务侦听器。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getName</h4> <pre><a href="../../java/lang/String.html" title="class in java.lang">String</a> getName()</pre>
<div class="block">
<span>返回此打印服务的字符串名称，可由应用程序用于请求特定打印服务。</span>
<span>在适当的上下文中，例如名称服务，该名称必须是唯一的。</span>
<span>在某些环境中，此唯一名称可能与定义为<a href="../../javax/print/attribute/standard/PrinterName.html" title="javax.print.attribute.standard中的类"><code>PrinterName</code></a>属性的用户友好的打印机名称相同。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             服务名称 
           </dd>
</dl> </li>
</ul> <a name="createPrintJob--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createPrintJob</h4> <pre><a href="../../javax/print/DocPrintJob.html" title="interface in javax.print">DocPrintJob</a> createPrintJob()</pre>
<div class="block">
            创建并返回一个能够处理任何受支持文档风格的数据的PrintJob。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个DocPrintJob对象 
           </dd>
</dl> </li>
</ul> <a name="addPrintServiceAttributeListener-javax.print.event.PrintServiceAttributeListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addPrintServiceAttributeListener</h4> <pre>void addPrintServiceAttributeListener(<a href="../../javax/print/event/PrintServiceAttributeListener.html" title="interface in javax.print.event">PrintServiceAttributeListener</a> listener)</pre>
<div class="block">
            在此PrintService上为事件注册一个侦听器。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 一个PrintServiceAttributeListener，它监视打印服务的状态 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/print/PrintService.html#removePrintServiceAttributeListener-javax.print.event.PrintServiceAttributeListener-"><code>removePrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removePrintServiceAttributeListener-javax.print.event.PrintServiceAttributeListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removePrintServiceAttributeListener</h4> <pre>void removePrintServiceAttributeListener(<a href="../../javax/print/event/PrintServiceAttributeListener.html" title="interface in javax.print.event">PrintServiceAttributeListener</a> listener)</pre>
<div class="block">
<span>从此打印服务中删除打印服务侦听器。</span>
<span>这意味着听众不再对<code>PrintService</code> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 一个PrintServiceAttributeListener对象 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/print/PrintService.html#addPrintServiceAttributeListener-javax.print.event.PrintServiceAttributeListener-"><code>addPrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="getAttributes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributes</h4> <pre><a href="../../javax/print/attribute/PrintServiceAttributeSet.html" title="interface in javax.print.attribute">PrintServiceAttributeSet</a> getAttributes()</pre>
<div class="block">
<span>获取此打印服务的一组打印机描述属性，以提供此打印服务的状态。</span>
<span>返回的属性集对象是不可修改的。</span>
<span>返回的属性集对象是此打印服务在<code>getAttributes()</code>方法调用时设置的属性的“快照”：即，如果此打印服务的属性集的内容将来会更改，则返回的属性集的内容将<i>不会</i>更新。</span>
<span>要检测属性值的更改，请再次调用<code>getAttributes()</code> ，并将新属性集与先前的属性集进行比较;</span>
<span>或者，为打印服务事件注册一个侦听器。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>此打印服务的属性集不可修改的快照。</span>
<span>可能为空，但不能为空。</span>
</dd>
</dl> </li>
</ul> <a name="getAttribute-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttribute</h4> <pre>&lt;T extends <a href="../../javax/print/attribute/PrintServiceAttribute.html" title="interface in javax.print.attribute">PrintServiceAttribute</a>&gt; T getAttribute(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; category)</pre>
<div class="block">
<span>获取单个指定服务属性的值。</span>
<span>这对于仅需要一个属性的值并且希望最小化开销的客户端可能是有用的。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>category</code> - 此服务支持的PrintServiceAttribute的类别可能不为null。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             支持的属性的值，如果该服务不支持该属性，则为null。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果类别为空。 
           </dd>
<dd>
<span><code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未经检查的异常）如果<code>category</code>不是<code>类</code>实现了接口<a href="../../javax/print/attribute/PrintServiceAttribute.html" title="javax.print.attribute中的接口"><code>PrintServiceAttribute</code></a> 。</span>
</dd>
</dl> </li>
</ul> <a name="getSupportedDocFlavors--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSupportedDocFlavors</h4> <pre><a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a>[] getSupportedDocFlavors()</pre>
<div class="block">
<span>确定客户端在为此<code>PrintService</code>设置作业时可以指定的打印数据格式。</span>
<span>打印数据格式由MIME类型和打印数据表示类组成的“doc flavor”（类别<a href="../../javax/print/DocFlavor.html" title="javax.print中的类"><code>DocFlavor</code></a> ）指定。</span>
<p> <span>请注意，与所有属性相结合可能不支持某些doc风格。</span> <span>使用<code>getUnsupportedAttributes(..)</code>验证特定组合。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             支持的doc风格的数组应至少有一个元素。 
           </dd>
</dl> </li>
</ul> <a name="isDocFlavorSupported-javax.print.DocFlavor-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isDocFlavorSupported</h4> <pre>boolean isDocFlavorSupported(<a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor)</pre>
<div class="block">
<span>确定此打印服务是否支持特定的<code>DocFlavor</code> 。</span>
<span>这是一个方便的方法，以确定DocFlavor是否是<code>DocFlavor</code>的结果的<code>getSupportedDocFlavors()</code> 。</span>
<p> <span>请注意，与所有属性相结合可能不支持某些doc风格。</span> <span>使用<code>getUnsupportedAttributes(..)</code>验证特定组合。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>flavor</code> - 
            <code>DocFlavor</code>查询支持。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><code>true</code>如果此打印服务支持指定的<code>DocFlavor</code> ;</span>
<span><code>false</code>否则。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - （未选中的异常）如果 
            <code>flavor</code>为空，则抛出。 
           </dd>
</dl> </li>
</ul> <a name="getSupportedAttributeCategories--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSupportedAttributeCategories</h4> <pre><a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;?&gt;[] getSupportedAttributeCategories()</pre>
<div class="block">
<span>确定在为此打印服务设置作业时客户端可以指定的打印属性类别。</span>
<span>打印属性类别由<code>类</code> ，实现接口<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
<span>此方法只返回受支持的属性<i>类别</i> ;</span>
<span>它不返回支持的特定属性<i>值</i> 。</span>
<p> <span>此方法返回此打印服务支持任何可能作业的所有打印属性类别。</span> <span>某些类别可能在特定上下文中不被支持（即特定的<code>DocFlavor</code> ）。</span> <span>使用包含<code>DocFlavor</code>的方法在提交请求之前验证请求，例如<code>getSupportedAttributeValues(..)</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>打印属性类别的数组，客户端可以在打印请求中指定为文档级别或作业级属性。</span>
<span>数组中的每个元素都是<a href="../../java/lang/Class.html" title="java.lang中的类"><code>类</code></a> ，它实现了接口<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
<span>如果不支持任何类别，则该数组为空。</span>
</dd>
</dl> </li>
</ul> <a name="isAttributeCategorySupported-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isAttributeCategorySupported</h4> <pre>boolean isAttributeCategorySupported(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;? extends <a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a>&gt; category)</pre>
<div class="block">
<span>确定在为此打印服务设置作业时，客户端是否可以指定给定的打印属性类别。</span>
<span>打印属性类别由实现<code>类</code> <code>Attribute</code>的Class <a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口">指定</a> 。</span>
<span>此方法说明是否支持属性<i>类别</i> ;</span>
<span>它不知道是否支持特定的属性<i>值</i> 。</span>
<p> <span>特定上下文中可能不支持某些类别（例如特定的<code>DocFlavor</code> ）。</span> <span>使用其中一种方法，其中包括一个<code>DocFlavor</code>在提交请求之前验证该请求，例如<code>getSupportedAttributeValues(..)</code> 。</span> </p>
<p> <span>这是确定类别是否为<code>getSupportedAttributeCategories()</code>结果的成员的<code>getSupportedAttributeCategories()</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>category</code> - 打印要测试的属性类别。</span>
<span>它必须是<code>类</code>实现接口<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><code>true</code>如果此打印服务支持在打印请求中<code>category</code>中的文档级别或作业级别属性;</span>
<span><code>false</code>如果没有。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - （未选中的异常）如果 
            <code>category</code>为空，则抛出。 
           </dd>
<dd>
<span><code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未选中的异常）如果<code>category</code>不是实现<code>类</code> ，则<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口">抛出</a> 。</span>
</dd>
</dl> </li>
</ul> <a name="getDefaultAttributeValue-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultAttributeValue</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getDefaultAttributeValue(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;? extends <a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a>&gt; category)</pre>
<div class="block">
<span>确定此打印服务在给定类别中的默认打印属性值。</span>
<span>甲打印属性值是一个实现接口的类的一个实例<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
<span>如果客户端设置打印作业并且未在给定类别中指定任何属性值，则此打印服务将使用默认属性值。</span>
<p> <span>一些特定的上下文可能不支持某些属性（即特定的<code>DocFlavor</code> ）。</span> <span>使用包含<code>DocFlavor</code>的方法之一在提交请求之前验证请求，例如<code>getSupportedAttributeValues(..)</code> 。</span> </p>
<p> <span>并非所有属性都具有默认值。</span> <span>例如，服务将不会有一个默认值<code>RequestingUser</code> ，即对一个支援的类别返回null意味着没有该类别的服务默认值。</span> <span>使用<code>isAttributeCategorySupported(Class)</code>方法来区分这些情况。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>category</code> - 要求其默认属性值的打印属性类别。</span>
<span>它必须是<a href="../../java/lang/Class.html" title="java.lang中的类"><code>类</code></a>实现接口<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             默认属性值 
            <code>category</code> ，如果此打印服务不支持指定doc级或作业级属性空 
            <code>category</code>在打印请求，或者服务没有此属性的默认值。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - （未选中的异常）如果 
            <code>category</code>为空，则抛出。 
           </dd>
<dd>
<span><code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未经检查的异常）如果<code>category</code>不是实现<a href="../../java/lang/Class.html" title="java.lang中的类">接口<code>Attribute</code>的<code>类</code></a> ，则<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口">抛出</a> 。</span>
</dd>
</dl> </li>
</ul> <a name="getSupportedAttributeValues-java.lang.Class-javax.print.DocFlavor-javax.print.attribute.AttributeSet-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSupportedAttributeValues</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getSupportedAttributeValues(<a href="../../java/lang/Class.html" title="class in java.lang">类</a>&lt;? extends <a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a>&gt; category,
                                   <a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor,
                                   <a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a> attributes)</pre>
<div class="block">
<span>确定为此打印服务设置作业时客户端可以在给定类别中指定的打印属性值。</span>
<span>甲打印属性值是一个实现接口的类的一个实例<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
<p> <span>如果<code>flavor</code>为空，并且<code>attributes</code>为空或为空集，则此方法将返回此Print Service支持任何可能作业的所有打印属性值。</span> <span>如果<code>flavor</code>不为空或<code>attributes</code>不是空集，则此方法仅返回与给定doc风格和/或属性集合兼容的打印属性值。</span> <span>也就是说，null返回值可能表示指定此属性与指定的DocFlavor不兼容。</span> <span>另外如果DocFlavor不为空，它必须是此PrintService支持的风格，否则将抛出IllegalArgumentException异常。</span> </p>
<p> <span>如果<code>attributes</code>参数包含类别与<code>category</code>参数相同的属性，则服务必须在AttributeSet中忽略此属性。</span> </p>
<p> <span><code>DocAttribute</code>将在Doc中<code>Doc</code>必须包含在此集合中以准确表示上下文。</span> </p>
<p> <span>此方法返回一个对象，因为不同的打印属性类别以不同的方式指示支持的属性值。</span> <span>包<code>javax.print.attribute.standard</code>中每个打印属性的<a href="../../javax/print/attribute/standard/package-summary.html">文档</a>描述了每个属性如何表示其支持的值。</span> <span>指示支持的可能方式包括：</span> </p>
<ul>
<li> <span>返回属性类别的单个实例，以指示任何值是合法的 - 例如，使用值为任意文本字符串的属性。</span> <span>（返回的属性对象的值是不相关的。）</span> </li>
<li> <span>返回属性类别的一个或多个实例的数组，其中包含合法值，例如使用具有枚举值列表的属性。</span> <span>数组的类型是由其<code>getCategory(Class)</code>返回的指定属性类别类型的<code>getCategory(Class)</code> 。</span> </li>
<li> <span>返回一个单独的对象（属性类别以外的某个类），该对象指示合法值的边界，例如使用必须位于一定范围内的整数值属性。</span> </li>
</ul>
<p></p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>category</code> - 打印要测试的属性类别。</span>
<span>它必须是<a href="../../java/lang/Class.html" title="java.lang中的类"><code>类</code></a>实现接口<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
</dd>
<dd>
<code>flavor</code> - 用于假定作业的文件风味，或为空。 
           </dd>
<dd>
<code>attributes</code> - 假定作业（作业级属性和文档级别属性）的打印属性集，或空值。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             指示category的支持值的 
            <code>category</code> ，如果此打印服务不支持在打印请求中 
            <code>category</code>中的文档级别或作业级属性， 
            <code>category</code> 。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - （未选中的异常）如果 
            <code>category</code>为空，则抛出。 
           </dd>
<dd>
<span><code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未经检查的异常）如果摔出<code>category</code>不是<a href="../../java/lang/Class.html" title="java.lang中的类"><code>类</code></a>实现了接口<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> ，或<code>DocFlavor</code>不受此服务的支持。</span>
</dd>
</dl> </li>
</ul> <a name="isAttributeValueSupported-javax.print.attribute.Attribute-javax.print.DocFlavor-javax.print.attribute.AttributeSet-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isAttributeValueSupported</h4> <pre>boolean isAttributeValueSupported(<a href="../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a> attrval,
                                  <a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor,
                                  <a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a> attributes)</pre>
<div class="block">
<span>确定在为此打印服务设置作业时，客户端是否可以指定给定的打印属性值。</span>
<span>甲打印属性值是一个实现接口的类的一个实例<a href="../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口"><code>Attribute</code></a> 。</span>
<p> <span>如果<code>flavor</code>为空，并且<code>attributes</code>为空或为空集，则此方法将告知此打印服务是否支持给定打印属性值，以获取一些可能的doc风格和一组属性的组合。</span> <span>如果<code>flavor</code>不为空或<code>attributes</code>不是空集，则此方法会告知此打印服务是否支持给定的打印属性值以及给定的doc风格和/或一组属性。</span> </p>
<p> <span>另外如果DocFlavor不为空，它必须是此PrintService支持的风格，否则将抛出IllegalArgumentException异常。</span> </p>
<p> <span><code>DocAttribute</code> S的是将要在指定<code>Doc</code>必须包含在该组以准确地表示上下文。</span> </p>
<p> <span>这是确定该值是否为<code>getSupportedAttributeValues(...)</code>的结果的成员的<code>getSupportedAttributeValues(...)</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>attrval</code> - 打印要测试的属性值。 
           </dd>
<dd>
<code>flavor</code> - 用于假定作业的Doc风味，或为null。 
           </dd>
<dd>
<code>attributes</code> - 假定作业的打印属性集（作业级别属性和文档级属性），或为空。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果此打印服务支持将attrval 
            <code>attrval</code>为打印请求中的文档级别或作业级别属性，则为True，否则为false。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - （未选中的异常），如果 
            <code>attrval</code>为空。 
           </dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果此PrintService不支持flavor。 
           </dd>
</dl> </li>
</ul> <a name="getUnsupportedAttributes-javax.print.DocFlavor-javax.print.attribute.AttributeSet-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getUnsupportedAttributes</h4> <pre><a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a> getUnsupportedAttributes(<a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor,
                                      <a href="../../javax/print/attribute/AttributeSet.html" title="interface in javax.print.attribute">AttributeSet</a> attributes)</pre>
<div class="block">
<span>在特定DocFlavor的上下文中标识不支持打印请求的属性。</span>
<span>此方法对于验证潜在的打印作业并识别不能支持的特定属性很有用。</span>
<span>只提供支持的DocFlavor或者IllegalArgumentException将被抛出很重要。</span>
<span>如果此方法的返回值为null，则支持所有属性。</span>
<p> <span><code>DocAttribute</code> S的是将要在指定<code>Doc</code>必须包含在该组以准确地表示上下文。</span> </p>
<p> <span>如果返回值不为空，返回的集合中的所有属性将不受此DocFlavor的支持。</span> <span>返回的集合不区分不受支持的属性值的属性类别。</span> </p>
<p> <span>然后可以通过从原始属性集中删除所有不受支持的属性来创建支持的打印请求，但不支持DocFlavor的情况除外。</span> </p>
<p> <span>如果任何属性不受支持，只因为它们与其他属性冲突，那么服务才可以选择要识别为冲突原因的属性。</span> </p>
<p> <span>在调用此方法之前，请使用<code>isDocFlavorSupported()</code>验证是否支持DocFlavor。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>flavor</code> - 要测试的Doc flavor，或null 
           </dd>
<dd>
<code>attributes</code> - 假定作业的打印属性集（作业级别属性和文档级别属性），或为空。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果此打印服务支持打印请求规范，则为null，否则为不受支持的属性。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> -如果 
            <code>flavor</code>不受此PrintService的支持。 
           </dd>
</dl> </li>
</ul> <a name="getServiceUIFactory--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getServiceUIFactory</h4> <pre><a href="../../javax/print/ServiceUIFactory.html" title="class in javax.print">ServiceUIFactory</a> getServiceUIFactory()</pre>
<div class="block">
<span>返回用于UI组件的工厂，允许用户以各种角色与服务进行交互。</span>
<span>不提供任何UI的服务应返回null。</span>
<span>提供UI但希望在没有UI支持的环境中支持的打印服务应确保工厂不被初始化，除非应用程序调用此方法来获取工厂。</span>
<span>见<code>ServiceUIFactory</code>以获取更多信息。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             null或UI组件的工厂。 
           </dd>
</dl> </li>
</ul> <a name="equals-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>equals</h4> <pre>boolean equals(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</pre>
<div class="block">
<span>确定两个服务是否指向相同的底层服务。</span>
<span>封装打印服务的对象即使引用了相同的底层服务，也可能不具有参考等同性。</span>
<p> <span>客户应该调用此方法来确定两个服务是否指向相同的底层服务。</span> </p>
<p> <span>服务必须实现此方法，并且只有当被比较的服务对象可以被客户端可互换使用时才返回true。</span> <span>如果服务可以将相同的对象引用返回给底层服务，但客户端不能依赖于参考的相等性。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a></code>在类别 
            <code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>obj</code> - 与之比较的参考对象。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果此服务与obj参数相同，则为true，否则为false。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../java/lang/Object.html#hashCode--"><code>Object.hashCode()</code></a> ， <a href="../../java/util/HashMap.html" title="java.util中的类"><code>HashMap</code></a></span>
</dd>
</dl> </li>
</ul> <a name="hashCode--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>hashCode</h4> <pre>int hashCode()</pre>
<div class="block">
            该方法应与 
           <code>equals(Object)</code> 。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#hashCode--">hashCode</a></code>在类别 
            <code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             这个对象的哈希码。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(java.lang.Object)</code></a>, 
            <a href="../../java/lang/System.html#identityHashCode-java.lang.Object-"><code>System.identityHashCode(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>