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

<div class="header">
<div class="subTitle">
     javax.print 
   </div>
<h2 class="title" title="Interface CancelablePrintJob">Interface CancelablePrintJob</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Superinterfaces: 
       </dt>
<dd>
<span><a href="../../javax/print/DocPrintJob.html" title="javax.print中的接口">DocPrintJob</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">CancelablePrintJob</span>
extends <a href="../../javax/print/DocPrintJob.html" title="interface in javax.print">DocPrintJob</a></pre>
<div class="block">
<span>此接口由打印应用程序用于取消打印作业。</span>
<span>此界面扩展了<a href="../../javax/print/DocPrintJob.html" title="javax.print中的接口"><code>DocPrintJob</code></a> 。</span>
<span>一个<code>DocPrintJob</code>从打印服务返回的实施实现了这个接口，如果打印工作可以取消。</span>
<span>在尝试取消打印作业之前，客户端需要测试从打印服务返回的<code>DocPrintJob</code>对象是否实际实现此接口。</span>
<span>客户端不应该假设一个<code>DocPrintJob</code>实现了这个接口。</span>
<span>打印服务可能仅支持某些类型的打印数据和表示类名称的取消。</span>
<span>这意味着只有一些从服务返回的<code>DocPrintJob</code>对象将实现此接口。</span>
<p> <span>鼓励服务实现者实现此可选接口，并且如果使用此接口的实现成功取消作业，则向任何侦听器传递javax.print.event.PrintJobEvent.JOB_CANCELLED事件。</span> <span>服务还应该注意到，这种方法的实现可以由单独的客户端线程制作，而不是制作打印请求。</span> <span>因此，这个接口的实现必须使线程安全。</span> </p>
</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/CancelablePrintJob.html#cancel--">cancel</a></span>()</code>
<div class="block">
              停止打印作业的进一步处理。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.print.DocPrintJob">
<!-- --> </a> <h3>Methods inherited from interface javax.print.<a href="../../javax/print/DocPrintJob.html" title="interface in javax.print">DocPrintJob</a></h3> <code><a href="../../javax/print/DocPrintJob.html#addPrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-javax.print.attribute.PrintJobAttributeSet-">addPrintJobAttributeListener</a>, <a href="../../javax/print/DocPrintJob.html#addPrintJobListener-javax.print.event.PrintJobListener-">addPrintJobListener</a>, <a href="../../javax/print/DocPrintJob.html#getAttributes--">getAttributes</a>, <a href="../../javax/print/DocPrintJob.html#getPrintService--">getPrintService</a>, <a href="../../javax/print/DocPrintJob.html#print-javax.print.Doc-javax.print.attribute.PrintRequestAttributeSet-">print</a>, <a href="../../javax/print/DocPrintJob.html#removePrintJobAttributeListener-javax.print.event.PrintJobAttributeListener-">removePrintJobAttributeListener</a>, <a href="../../javax/print/DocPrintJob.html#removePrintJobListener-javax.print.event.PrintJobListener-">removePrintJobListener</a></code></li>
</ul> </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="cancel--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>cancel</h4> <pre>void cancel()
     throws <a href="../../javax/print/PrintException.html" title="class in javax.print">PrintException</a></pre>
<div class="block">
<span>停止打印作业的进一步处理。</span>
<p> <span>如果一项服务支持这种方法，则不能断定作业取消将始终成功。</span> <span>一旦达到并通过了处理中的某一点，工作可能无法取消。</span> <span>取消成功仅表示整个作业未打印，某些部分可能在取消退货时已经打印。</span> </p>
<p> <span>如果取消不成功，该服务将抛出一个PrintException。</span> <span>尚未提交印刷的作业应抛出此异常。</span> <span>取消已经成功取消的打印作业不被认为是错误，并且将始终成功。</span> </p>
<p> <span>某些服务中的取消可能是一个冗长的过程，涉及对服务器的请求和其打印队列的处理。</span> <span>客户可能希望在不影响应用程序执行的线程中执行取消。</span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/print/PrintException.html" title="class in javax.print">PrintException</a></code> - 如果作业无法成功取消。 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>