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

211 lines
12 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.print
</div>
<h2 class="title" title="Class StreamPrintServiceFactory">Class StreamPrintServiceFactory</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>javax.print.StreamPrintServiceFactory</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">StreamPrintServiceFactory</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>A <code>StreamPrintServiceFactory</code><a href="../../javax/print/StreamPrintService.html" title="javax.print中的类"><code>StreamPrintService</code></a>实例的工厂可以以描述为MIME类型的特定文档格式打印到输出流。</span>
<span>典型的输出文档格式可以是PostscriptTM</span>
<p> <span>此类由服务实现和定位是通过使用实施<a href="../../../technotes/guides/jar/jar.html#Service Provider">SPI JAR File specification</a></span> </p>
<p> <span>应用程序通过调用<a href="../../javax/print/StreamPrintServiceFactory.html#lookupStreamPrintServiceFactories-javax.print.DocFlavor-java.lang.String-"><code>lookupStreamPrintServiceFactories(DocFlavor, String)</code></a>方法来定位此类的实例。</span> </p>
<p> <span>应用程序可以使用一个<code>StreamPrintService</code>代替的从工厂获得<code>PrintService</code> ,其表示物理打印机设备。</span> </p>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/print/StreamPrintServiceFactory.html#StreamPrintServiceFactory--">StreamPrintServiceFactory</a></span>()</code> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== 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="t1"><span><a href="javascript:show(1);">静态方法</a></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>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</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>abstract <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/StreamPrintServiceFactory.html#getOutputFormat--">getOutputFormat</a></span>()</code>
<div class="block">
查询工厂获得的打印机发出的文档格式。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract <a href="../../javax/print/StreamPrintService.html" title="class in javax.print">StreamPrintService</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/StreamPrintServiceFactory.html#getPrintService-java.io.OutputStream-">getPrintService</a></span>(<a href="../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> out)</code>
<div class="block">
返回
<code>StreamPrintService</code> ,可以打印到指定的输出流。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <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/StreamPrintServiceFactory.html#getSupportedDocFlavors--">getSupportedDocFlavors</a></span>()</code>
<div class="block">
查询工厂的文件风味,可以从本厂获得的打印机接受。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>static <a href="../../javax/print/StreamPrintServiceFactory.html" title="class in javax.print">StreamPrintServiceFactory</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/StreamPrintServiceFactory.html#lookupStreamPrintServiceFactories-javax.print.DocFlavor-java.lang.String-">lookupStreamPrintServiceFactories</a></span>(<a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor, <a href="../../java/lang/String.html" title="class in java.lang">String</a> outputMimeType)</code>
<div class="block">
找到可用于打印作业的打印服务的工厂,以
<code>outputMimeType</code>的格式输出数据流。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../java/lang/Object.html#clone--">clone</a>, <a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../java/lang/Object.html#notify--">notify</a>, <a href="../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../java/lang/Object.html#toString--">toString</a>, <a href="../../java/lang/Object.html#wait--">wait</a>, <a href="../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="StreamPrintServiceFactory--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>StreamPrintServiceFactory</h4> <pre>public StreamPrintServiceFactory()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="lookupStreamPrintServiceFactories-javax.print.DocFlavor-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>lookupStreamPrintServiceFactories</h4> <pre>public static <a href="../../javax/print/StreamPrintServiceFactory.html" title="class in javax.print">StreamPrintServiceFactory</a>[] lookupStreamPrintServiceFactories(<a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a> flavor,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> outputMimeType)</pre>
<div class="block">
<span>找到可与打印作业一起使用的打印服务的工厂,以<code>outputMimeType</code>的格式输出数据流。</span>
<p> <span><code>outputMimeType</code>参数描述要创建的文档类型,而<code>flavor</code>参数描述了应用程序将输入数据提供给StreamPrintService的<code>StreamPrintService</code></span> </p>
<p> <span>尽管null是用于查找流打印服务的可接受的值但是典型的是搜索特定期望的格式例如PostscriptTM</span> </p>
<p></p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>flavor</code> - 输入文档类型 - null表示匹配所有类型。
</dd>
<dd>
<span><code>outputMimeType</code> - 代表所需的输出格式,用于识别合适的流打印机工厂。</span>
<span>值为null表示匹配所有格式。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
- 匹配工厂的流打印服务实例,如果没有合适的工厂可以找到空的。
</dd>
</dl> </li>
</ul> <a name="getOutputFormat--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getOutputFormat</h4> <pre>public abstract <a href="../../java/lang/String.html" title="class in java.lang">String</a> getOutputFormat()</pre>
<div class="block">
查询工厂获得的打印机发出的文档格式。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
输出格式描述为mime类型。
</dd>
</dl> </li>
</ul> <a name="getSupportedDocFlavors--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSupportedDocFlavors</h4> <pre>public abstract <a href="../../javax/print/DocFlavor.html" title="class in javax.print">DocFlavor</a>[] getSupportedDocFlavors()</pre>
<div class="block">
查询工厂的文件风味,可以从本厂获得的打印机接受。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
数组支持的doc风味。
</dd>
</dl> </li>
</ul> <a name="getPrintService-java.io.OutputStream-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getPrintService</h4> <pre>public abstract <a href="../../javax/print/StreamPrintService.html" title="class in javax.print">StreamPrintService</a> getPrintService(<a href="../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> out)</pre>
<div class="block">
<span>返回<code>StreamPrintService</code> ,可以打印到指定的输出流。</span>
<span>输出流由应用程序创建和管理。</span>
<span>应用程序有责任关闭流,并确保本打印机不被重复使用。</span>
<span>在从打印机创建的任何打印作业完成之前,应用程序不应关闭此流。</span>
<span>以前执行此操作可能会生成<code>PrinterException</code>和表示作业失败的事件。</span>
<p> <span><code>PrintService</code>连接到物理打印机可以重复使用,一个<code>StreamPrintService</code>连接到流不能。</span> <span>底层<code>StreamPrintService</code>可通过与所述打印系统被布置<a href="../../javax/print/StreamPrintService.html#dispose--"><code>dispose</code></a>方法从返回之前<a href="../../javax/print/DocPrintJob.html#print-javax.print.Doc-javax.print.attribute.PrintRequestAttributeSet-"><code>print</code></a>的方法<code>DocPrintJob</code> ,使得打印系统知道该打印机不再可用。</span> <span>这相当于一个物理打印机永久脱机。</span> <span>应用程序可以提供空打印流来创建可查询的服务。</span> <span>为这样一个流创建一个PrintJob是无效的。</span> <span>在构建时分配资源的实现应该检查流,并且如果流是非空的,可能希望仅分配资源。</span> </p>
<p></p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>out</code> - 生成输出的目标流。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个PrintService它将生成由本工厂支持的DocFlavor指定的格式。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>