mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-04 07:42:45 +08:00
286 lines
15 KiB
HTML
286 lines
15 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
javax.print
|
||
</div>
|
||
<h2 class="title" title="Interface DocPrintJob">Interface DocPrintJob</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/CancelablePrintJob.html" title="javax.print中的接口">CancelablePrintJob</a> ， <a href="../../javax/print/MultiDocPrintJob.html" title="javax.print中的接口">MultiDocPrintJob</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">DocPrintJob</span></pre>
|
||
<div class="block">
|
||
<span>此接口表示可以使用一组作业属性打印指定文档的打印作业。</span>
|
||
<span>实现该接口的对象是从打印服务获得的。</span>
|
||
</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/DocPrintJob.html#addPrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-javax.print.attribute.PrintJobAttributeSet-">addPrintJobAttributeListener</a></span>(<a href="../../javax/print/event/PrintJobAttributeListener.html" title="interface in javax.print.event">PrintJobAttributeListener</a> listener, <a href="../../javax/print/attribute/PrintJobAttributeSet.html" title="interface in javax.print.attribute">PrintJobAttributeSet</a> attributes)</code>
|
||
<div class="block">
|
||
注册侦听器以指定属性的更改。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/DocPrintJob.html#addPrintJobListener-javax.print.event.PrintJobListener-">addPrintJobListener</a></span>(<a href="../../javax/print/event/PrintJobListener.html" title="interface in javax.print.event">PrintJobListener</a> listener)</code>
|
||
<div class="block">
|
||
为此打印作业期间发生的事件注册一个侦听器。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../javax/print/attribute/PrintJobAttributeSet.html" title="interface in javax.print.attribute">PrintJobAttributeSet</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/DocPrintJob.html#getAttributes--">getAttributes</a></span>()</code>
|
||
<div class="block">
|
||
获取此打印作业的一组打印属性。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code><a href="../../javax/print/PrintService.html" title="interface in javax.print">PrintService</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/DocPrintJob.html#getPrintService--">getPrintService</a></span>()</code>
|
||
<div class="block">
|
||
<span>确定此打印作业对象绑定到的<a href="../../javax/print/PrintService.html" title="javax.print中的接口"><code>PrintService</code></a>对象。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/DocPrintJob.html#print-javax.print.Doc-javax.print.attribute.PrintRequestAttributeSet-">print</a></span>(<a href="../../javax/print/Doc.html" title="interface in javax.print">Doc</a> doc, <a href="../../javax/print/attribute/PrintRequestAttributeSet.html" title="interface in javax.print.attribute">PrintRequestAttributeSet</a> attributes)</code>
|
||
<div class="block">
|
||
打印具有指定作业属性的文档。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/DocPrintJob.html#removePrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-">removePrintJobAttributeListener</a></span>(<a href="../../javax/print/event/PrintJobAttributeListener.html" title="interface in javax.print.event">PrintJobAttributeListener</a> listener)</code>
|
||
<div class="block">
|
||
从此打印作业中删除属性侦听器。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/DocPrintJob.html#removePrintJobListener-javax.print.event.PrintJobListener-">removePrintJobListener</a></span>(<a href="../../javax/print/event/PrintJobListener.html" title="interface in javax.print.event">PrintJobListener</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="getPrintService--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getPrintService</h4> <pre><a href="../../javax/print/PrintService.html" title="interface in javax.print">PrintService</a> getPrintService()</pre>
|
||
<div class="block">
|
||
<span>确定绑定此打印作业对象的<a href="../../javax/print/PrintService.html" title="javax.print中的接口"><code>PrintService</code></a>对象。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>PrintService</code>对象。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getAttributes--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttributes</h4> <pre><a href="../../javax/print/attribute/PrintJobAttributeSet.html" title="interface in javax.print.attribute">PrintJobAttributeSet</a> getAttributes()</pre>
|
||
<div class="block">
|
||
<span>获取此打印作业的一组打印属性。</span>
|
||
<span>返回的属性集对象是不可修改的。</span>
|
||
<span>返回的属性集对象是此打印作业在<a href="../../javax/print/DocPrintJob.html#getAttributes--"><code>getAttributes()</code></a>方法调用时设置的属性的“快照”;</span>
|
||
<span>也就是说，如果此打印作业的属性集的内容在将来更改，则返回的属性集的对象的内容将不会被更新。</span>
|
||
<span>要检测属性值的更改，请再次调用<code>getAttributes()</code> ，并将新属性集与先前的属性集进行比较;</span>
|
||
<span>或者，为打印作业事件注册一个侦听器。</span>
|
||
<span>返回的值可能是空集，但不应为空。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
打印作业属性
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="addPrintJobListener-javax.print.event.PrintJobListener-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>addPrintJobListener</h4> <pre>void addPrintJobListener(<a href="../../javax/print/event/PrintJobListener.html" title="interface in javax.print.event">PrintJobListener</a> listener)</pre>
|
||
<div class="block">
|
||
<span>为此打印作业期间发生的事件注册一个侦听器。</span>
|
||
<span>如果侦听器为空，则不会抛出异常，也不会执行任何操作。</span>
|
||
<span>如果听众已经注册，它将被重新注册。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>listener</code> - 实现侦听器接口的对象
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../javax/print/DocPrintJob.html#removePrintJobListener-javax.print.event.PrintJobListener-"><code>removePrintJobListener(javax.print.event.PrintJobListener)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="removePrintJobListener-javax.print.event.PrintJobListener-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>removePrintJobListener</h4> <pre>void removePrintJobListener(<a href="../../javax/print/event/PrintJobListener.html" title="interface in javax.print.event">PrintJobListener</a> listener)</pre>
|
||
<div class="block">
|
||
<span>从此打印作业中移除侦听器。</span>
|
||
<span>如果参数指定的侦听器以前未添加到此组件中，则此方法不执行任何功能，也不会抛出异常。</span>
|
||
<span>如果侦听器为空，则不会抛出异常，也不会执行任何操作。</span>
|
||
<span>如果一个监听器被注册不止一次，只有一个注册将被删除。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>listener</code> - 实现侦听器接口的对象
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../javax/print/DocPrintJob.html#addPrintJobListener-javax.print.event.PrintJobListener-"><code>addPrintJobListener(javax.print.event.PrintJobListener)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="addPrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-javax.print.attribute.PrintJobAttributeSet-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>addPrintJobAttributeListener</h4> <pre>void addPrintJobAttributeListener(<a href="../../javax/print/event/PrintJobAttributeListener.html" title="interface in javax.print.event">PrintJobAttributeListener</a> listener,
|
||
<a href="../../javax/print/attribute/PrintJobAttributeSet.html" title="interface in javax.print.attribute">PrintJobAttributeSet</a> attributes)</pre>
|
||
<div class="block">
|
||
<span>注册侦听器以指定属性的更改。</span>
|
||
<span>如果侦听器为空，则不会抛出异常，也不会执行任何操作。</span>
|
||
<span>要确定此作业可能报告的属性更新，客户端可以调用<code>getAttributes()</code>并识别有趣且可能向侦听器报告的子集。</span>
|
||
<span>希望对特定作业属性中的更改进行更新的客户端应验证它是否在该集合中，但是仅当更改关于属性的更新，并且该作业才能检测到属性时才会进行更新。</span>
|
||
<span>此外，更新可能会受到作业的批处理。</span>
|
||
<span>为了最小化打印作业处理的开销，建议只监听可能会发生变化的属性子集。</span>
|
||
<span>如果指定的集合为空，则不会将属性更新报告给侦听器。</span>
|
||
<span>如果属性集为空，那么这意味着监听该作业支持的所有动态属性。</span>
|
||
<span>如果作业无法报告任何属性更新，则可能导致没有更新通知。</span>
|
||
<span>如果听众已经注册，它将被重新注册。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>listener</code> - 实现侦听器接口的对象
|
||
</dd>
|
||
<dd>
|
||
<code>attributes</code> - 要监听的属性，或null表示可以更改的所有属性（由作业确定）。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../javax/print/DocPrintJob.html#removePrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-"><code>removePrintJobAttributeListener(javax.print.event.PrintJobAttributeListener)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="removePrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>removePrintJobAttributeListener</h4> <pre>void removePrintJobAttributeListener(<a href="../../javax/print/event/PrintJobAttributeListener.html" title="interface in javax.print.event">PrintJobAttributeListener</a> listener)</pre>
|
||
<div class="block">
|
||
<span>从此打印作业中删除属性侦听器。</span>
|
||
<span>如果参数指定的侦听器以前未添加到此组件中，则此方法不执行任何功能，也不会抛出异常。</span>
|
||
<span>如果监听器为空，则不会抛出异常，并且不执行任何操作。</span>
|
||
<span>如果一个监听器被注册不止一次，即使对于一组不同的属性，也不保证哪个监听器被删除。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>listener</code> - 实现侦听器接口的对象
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../javax/print/DocPrintJob.html#addPrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-javax.print.attribute.PrintJobAttributeSet-"><code>addPrintJobAttributeListener(javax.print.event.PrintJobAttributeListener, javax.print.attribute.PrintJobAttributeSet)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="print-javax.print.Doc-javax.print.attribute.PrintRequestAttributeSet-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>print</h4> <pre>void print(<a href="../../javax/print/Doc.html" title="interface in javax.print">Doc</a> doc,
|
||
<a href="../../javax/print/attribute/PrintRequestAttributeSet.html" title="interface in javax.print.attribute">PrintRequestAttributeSet</a> attributes)
|
||
throws <a href="../../javax/print/PrintException.html" title="class in javax.print">PrintException</a></pre>
|
||
<div class="block">
|
||
<span>打印具有指定作业属性的文档。</span>
|
||
<span>对于给定的打印作业，此方法只应调用一次。</span>
|
||
<span>再次调用它不会导致新作业假脱机到打印机。</span>
|
||
<span>服务实现将定义服务中断和恢复的策略。</span>
|
||
<span>当打印方法返回时，打印可能尚未完成，因为打印可能异步发生，也许在不同的线程中。</span>
|
||
<span>想要监视成功或失败的应用程序客户端应该注册一个PrintJobListener。</span>
|
||
<p> <span>打印服务实现者应该关闭他们从客户端文档获取的任何打印数据流（即Reader或InputStream实现）。</span> <span>稳健的客户可能仍然希望验证这一点。</span> <span>总是产生一个异常，如果一个<code>DocFlavor</code>不能打印。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>doc</code> - 要印刷的文件。</span>
|
||
<span>如果必须是此PrintJob支持的风味。</span>
|
||
</dd>
|
||
<dd>
|
||
<span><code>attributes</code> - 要应用于此打印作业的作业属性。</span>
|
||
<span>如果此参数为null，则使用默认属性。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code><a href="../../javax/print/PrintException.html" title="class in javax.print">PrintException</a></code> - 该异常还可以实现更准确地描述异常原因的接口</span>
|
||
<ul>
|
||
<li> <span>FlavorException。</span> <span>如果文档具有此打印作业不支持的风味。</span> </li>
|
||
<li> <span>AttributeException。</span> <span>如果一个或多个属性对该打印作业无效。</span> </li>
|
||
</ul>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |