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

383 lines
16 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 ServiceUIFactory">Class ServiceUIFactory</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.ServiceUIFactory</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">ServiceUIFactory</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>服务可以可选地提供UI其允许不同角色的不同风格的交互。</span>
<span>一个角色可能是最终用户浏览和设置打印选项。</span>
<span>另一个角色可能是管理打印服务。</span>
<p> <span>虽然Print Service API目前不提供管理打印服务的标准化支持但是可以监视打印服务并且UI可以提供私有更新机制。</span> </p>
<p> <span>基本的设计意图是允许应用程序在需要的时候只需在没有任何API依赖关系的情况下才能轻松地定位和初始化服务除非在使用它们的环境中。</span> </p>
<p> <span>Swing UI是首选因为它们提供更一致的LF并且可以支持可访问性API。</span> </p>
<p> <span>使用示例</span> </p>
<pre> <span>ServiceUIFactory factory = printService.getServiceUIFactory();
if (factory != null) {
JComponent swingui = (JComponent)factory.getUI(
ServiceUIFactory.MAIN_UIROLE,
ServiceUIFactory.JCOMPONENT_UI);
if (swingui != null) {
tabbedpane.add("Custom UI", swingui);
}
}</span> </pre>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/ServiceUIFactory.html#ABOUT_UIROLE">ABOUT_UIROLE</a></span></code>
<div class="block">
表示执行信息丰富的“关于”角色的UI。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/ServiceUIFactory.html#ADMIN_UIROLE">ADMIN_UIROLE</a></span></code>
<div class="block">
表示执行管理角色的UI。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <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/ServiceUIFactory.html#DIALOG_UI">DIALOG_UI</a></span></code>
<div class="block">
表示实现为AWT对话框的UI。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <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/ServiceUIFactory.html#JCOMPONENT_UI">JCOMPONENT_UI</a></span></code>
<div class="block">
表示实现为Swing组件的UI。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <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/ServiceUIFactory.html#JDIALOG_UI">JDIALOG_UI</a></span></code>
<div class="block">
表示实现为Swing对话框的UI。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/ServiceUIFactory.html#MAIN_UIROLE">MAIN_UIROLE</a></span></code>
<div class="block">
表示执行正常最终用户角色的UI。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <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/ServiceUIFactory.html#PANEL_UI">PANEL_UI</a></span></code>
<div class="block">
表示作为AWT面板实现的UI。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/print/ServiceUIFactory.html#RESERVED_UIROLE">RESERVED_UIROLE</a></span></code>
<div class="block">
不是有效的角色但角色ID大于此可能用于服务支持的私有角色。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ======== 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/ServiceUIFactory.html#ServiceUIFactory--">ServiceUIFactory</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="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>abstract <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/ServiceUIFactory.html#getUI-int-java.lang.String-">getUI</a></span>(int role, <a href="../../java/lang/String.html" title="class in java.lang">String</a> ui)</code>
<div class="block">
获取UI对象该对象可能被应用程序转换为请求的UI类型并在其用户界面中使用。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<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/ServiceUIFactory.html#getUIClassNamesForRole-int-">getUIClassNamesForRole</a></span>(int role)</code>
<div class="block">
给定从这个工厂获得的UI角色获取从这个工厂实现这个角色的UI类型。
</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">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="JCOMPONENT_UI">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>JCOMPONENT_UI</h4> <pre>public static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> JCOMPONENT_UI</pre>
<div class="block">
<span>表示实现为Swing组件的UI。</span>
<span>String的值是完全限定的类名“javax.swing.JComponent”。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.JCOMPONENT_UI">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="PANEL_UI">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>PANEL_UI</h4> <pre>public static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> PANEL_UI</pre>
<div class="block">
<span>表示作为AWT面板实现的UI。</span>
<span>String的值是完全限定的类名“java.awt.Panel”</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.PANEL_UI">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="DIALOG_UI">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>DIALOG_UI</h4> <pre>public static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> DIALOG_UI</pre>
<div class="block">
<span>表示实现为AWT对话框的UI。</span>
<span>String的值是完全限定的类名“java.awt.Dialog”</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.DIALOG_UI">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="JDIALOG_UI">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>JDIALOG_UI</h4> <pre>public static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> JDIALOG_UI</pre>
<div class="block">
<span>表示实现为Swing对话框的UI。</span>
<span>String的值是完全限定的类名“javax.swing.JDialog”</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.JDIALOG_UI">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="ABOUT_UIROLE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ABOUT_UIROLE</h4> <pre>public static final int ABOUT_UIROLE</pre>
<div class="block">
表示执行信息丰富的“关于”角色的UI。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.ABOUT_UIROLE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="ADMIN_UIROLE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ADMIN_UIROLE</h4> <pre>public static final int ADMIN_UIROLE</pre>
<div class="block">
表示执行管理角色的UI。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.ADMIN_UIROLE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="MAIN_UIROLE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MAIN_UIROLE</h4> <pre>public static final int MAIN_UIROLE</pre>
<div class="block">
表示执行正常最终用户角色的UI。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.MAIN_UIROLE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="RESERVED_UIROLE">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>RESERVED_UIROLE</h4> <pre>public static final int RESERVED_UIROLE</pre>
<div class="block">
<span>不是有效的角色但角色ID大于此可能用于服务支持的私有角色。</span>
<span>需要知道这个角色执行的功能才能正确使用它。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.print.ServiceUIFactory.RESERVED_UIROLE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="ServiceUIFactory--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ServiceUIFactory</h4> <pre>public ServiceUIFactory()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getUI-int-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getUI</h4> <pre>public abstract <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getUI(int role,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> ui)</pre>
<div class="block">
获取UI对象该对象可能被应用程序转换为请求的UI类型并在其用户界面中使用。
<p></p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>role</code> - 已请求。</span>
<span>必须是此工厂支持的标准角色或私人角色之一。</span>
</dd>
<dd>
<code>ui</code> -
<code>ui</code>角色的类型。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
UI角色如果请求的UI角色不可用于此工厂则为null
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果角色或者用户既不是标准的,也不是工厂支持的私有的。
</dd>
</dl> </li>
</ul> <a name="getUIClassNamesForRole-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getUIClassNamesForRole</h4> <pre>public abstract <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getUIClassNamesForRole(int role)</pre>
<div class="block">
<span>给定从这个工厂获得的UI角色获取从这个工厂实现这个角色的UI类型。</span>
<span>返回的字符串应该引用此类中定义的静态变量,以便应用程序可以使用相等的引用(“==”)。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>role</code> - 要查找。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该类为指定角色支持的UI类型如果没有可用于角色的UI则为null。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 作用是这个工厂不支持的非标准角色。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>