uTools-Manuals/docs/java/javax/print/attribute/standard/PageRanges.html

<div class="header">
<div class="subTitle">
     javax.print.attribute.standard 
   </div>
<h2 class="title" title="Class PageRanges">Class PageRanges</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><a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html" title="class in javax.print.attribute">javax.print.attribute.SetOfIntegerSyntax</a></li>
<li>
<ul class="inheritance">
<li>javax.print.attribute.standard.PageRanges</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Implemented Interfaces: 
       </dt>
<dd>
<span><a href="../../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a> ， <a href="../../../../java/lang/Cloneable.html" title="java.lang中的接口">Cloneable</a> ， <a href="../../../../javax/print/attribute/Attribute.html" title="javax.print.attribute中的接口">Attribute</a> ， <a href="../../../../javax/print/attribute/DocAttribute.html" title="javax.print.attribute中的接口">DocAttribute</a> ， <a href="../../../../javax/print/attribute/PrintJobAttribute.html" title="javax.print.attribute中的接口">PrintJobAttribute</a> ， <a href="../../../../javax/print/attribute/PrintRequestAttribute.html" title="javax.print.attribute中的接口">PrintRequestAttribute</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public final class <span class="typeNameLabel">PageRanges</span>
extends <a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html" title="class in javax.print.attribute">SetOfIntegerSyntax</a>
implements <a href="../../../../javax/print/attribute/DocAttribute.html" title="interface in javax.print.attribute">DocAttribute</a>, <a href="../../../../javax/print/attribute/PrintRequestAttribute.html" title="interface in javax.print.attribute">PrintRequestAttribute</a>, <a href="../../../../javax/print/attribute/PrintJobAttribute.html" title="interface in javax.print.attribute">PrintJobAttribute</a></pre>
<div class="block">
<span>Class PageRanges是一个打印属性类，一组整数，用于标识打印机对象用于打印每个文档的每个副本的打印流页面的范围。</span>
<span>对于文档中不存在的任何已标识的页面，不打印任何内容。</span>
<span>该属性与<i>打印流</i>页面（不是应用程序编号的页面）相关联（例如，页眉和/或页脚中找到的某些文字处理应用程序的页码）。</span>
<p> <span>在大多数情况下，要打印的确切页面将由设备驱动程序生成，并且不需要此属性。</span> <span>然而，当打印已经格式化的归档文档时，最终用户可以选择仅打印包含在文档中的页面的一部分。</span> <span>在这种情况下，如果指定了页面范围<code>"<i>n</i>-<i>m</i>"</code> ，则要打印的第一页将为第<i>n</i>页<i>。</i></span> <span>文件的所有后续页面将通过并包括第<i>m</i>页打印<i>。</i></span> </p>
<p> <span>如果没有为打印作业指定PageRanges属性，则将打印文档的所有页面。</span> <span>换句话说，PageRanges属性的默认值始终为<code>{{1, Integer.MAX_VALUE}}</code> 。</span> </p>
<p> <span>PageRanges属性对多点打印作业（具有多个文档的作业）的影响取决于所有文档是否具有指定的相同页面范围，或者是否指定了不同的文档具有不同的页面范围，以及（可能默认的） <a href="../../../../javax/print/attribute/standard/MultipleDocumentHandling.html" title="javax.print.attribute.standard中的类"><code>MultipleDocumentHandling</code></a>属性。</span> </p>
<ul>
<li> <span>如果所有文档具有指定的相同页面范围，那么<code>MultipleDocumentHandling</code>的任何值<a href="../../../../javax/print/attribute/standard/MultipleDocumentHandling.html" title="javax.print.attribute.standard中的类">都是</a>有意义的，打印机的处理取决于<a href="../../../../javax/print/attribute/standard/MultipleDocumentHandling.html" title="javax.print.attribute.standard中的类"><code>MultipleDocumentHandling</code></a>值：</span>
<ul>
<li> <span>SINGLE_DOCUMENT - 所有的输入文档将被合并到一个输出文档中。</span> <span>将打印该输出文档的指定页面范围。</span> <p></p></li>
<li> <span>SINGLE_DOCUMENT_NEW_SHEET - 所有输入文档将被合并到一个输出文档中，并且每个输入文档的第一印象将始终在新的介质页面上开始。</span> <span>将打印该输出文档的指定页面范围。</span> <p></p></li>
<li> <span>SEPARATE_DOCUMENTS_UNCOLLATED_COPIES - 对于每个单独的输入文档，将打印指定的页面范围。</span> <p></p></li>
<li> <span>SEPARATE_DOCUMENTS_COLLATED_COPIES - 对于每个单独的输入文档，将打印指定的页面范围。</span> </li>
</ul>
<ul>
<li> <span>SEPARATE_DOCUMENTS_UNCOLLATED_COPIES - 对于每个单独的输入文档，将打印其自己指定的页面范围。</span> <p></p></li>
<li> <span>SEPARATE_DOCUMENTS_COLLATED_COPIES - 对于每个单独的输入文档，将打印其自己指定的页面范围。</span> </li>
</ul></li>
</ul>
<p> <span><b>IPP兼容性：</b> PageRanges属性的规范数组形式为要包含的每个范围的页面和IPP“page-ranges”属性提供下限和上限。</span> <span>有关规范数组形式的说明，请参见<a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html" title="javax.print.attribute中的类"><code>SetOfIntegerSyntax</code></a>类。</span> <span>由<code>getName()</code>返回的类别名称提供IPP属性名称。</span> </p>
<p></p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../serialized-form.html#javax.print.attribute.standard.PageRanges">Serialized Form</a>
</dd>
</dl> </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/attribute/standard/PageRanges.html#PageRanges-int-">PageRanges</a></span>(int member)</code>
<div class="block">
              构造包含单个整数的新页面范围属性。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/print/attribute/standard/PageRanges.html#PageRanges-int:A:A-">PageRanges</a></span>(int[][] members)</code>
<div class="block">
              使用给定的成员构造一个新的页面范围属性。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/print/attribute/standard/PageRanges.html#PageRanges-int-int-">PageRanges</a></span>(int lowerBound, int upperBound)</code>
<div class="block">
              构造包含单个整数范围的新页面范围属性。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/print/attribute/standard/PageRanges.html#PageRanges-java.lang.String-">PageRanges</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> members)</code>
<div class="block">
              使用字符串形式的给定成员构造新的页面范围属性。 
            </div> </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="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>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/print/attribute/standard/PageRanges.html#equals-java.lang.Object-">equals</a></span>(<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> object)</code>
<div class="block">
              返回此页面范围属性是否等同于传入的对象。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><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;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/print/attribute/standard/PageRanges.html#getCategory--">getCategory</a></span>()</code>
<div class="block">
              获取要用作此打印属性值的“类别”的打印属性类。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<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/attribute/standard/PageRanges.html#getName--">getName</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.attribute.SetOfIntegerSyntax">
<!-- --> </a> <h3>Methods inherited from class javax.print.attribute.<a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html" title="class in javax.print.attribute">SetOfIntegerSyntax</a></h3> <code><a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html#contains-int-">contains</a>, <a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html#contains-javax.print.attribute.IntegerSyntax-">contains</a>, <a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html#getMembers--">getMembers</a>, <a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html#hashCode--">hashCode</a>, <a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html#next-int-">next</a>, <a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html#toString--">toString</a></code></li>
</ul>
<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#finalize--">finalize</a>, <a href="../../../../java/lang/Object.html#getClass--">getClass</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#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="PageRanges-int:A:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>PageRanges</h4> <pre>public PageRanges(int[][] members)</pre>
<div class="block">
<span>使用给定的成员构造一个新的页面范围属性。</span>
<span>成员以“数组形式”指定;</span>
<span>有关数组形式的说明，请参见<a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html" title="javax.print.attribute中的类"><code>SetOfIntegerSyntax</code></a>类。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>members</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>members</code>为空或 
            <code>members</code>任何元素为空，则抛出。 
           </dd>
<dd>
<span><code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未经检查的异常）如果的任何元素<code>members</code>不是长度为一个或长度×2阵列。</span>
<span>如果<code>members</code>是零长度数组，或者组中的任何成员小于1，那么也会抛出。</span>
</dd>
</dl> </li>
</ul> <a name="PageRanges-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>PageRanges</h4> <pre>public PageRanges(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> members)</pre>
<div class="block">
<span>使用字符串形式的给定成员构造新的页面范围属性。</span>
<span>有关语法的说明，请参见<a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html" title="javax.print.attribute中的类"><code>SetOfIntegerSyntax</code></a>类。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>members</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>members</code>为空或 
            <code>members</code>任何元素为空，则抛出。 
           </dd>
<dd>
<span><code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未经检查的异常）如果<code>members</code>不符合正确的语法，则抛出。</span>
<span>如果构造的整数整数是零长度数组，或者组中的任何成员小于1，那么也会抛出。</span>
</dd>
</dl> </li>
</ul> <a name="PageRanges-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>PageRanges</h4> <pre>public PageRanges(int member)</pre>
<div class="block">
<span>构造包含单个整数的新页面范围属性。</span>
<span>也就是说，只打印一页。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>member</code> - 设置成员。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未经检查的异常）如果 
            <code>member</code>小于1，则抛出。 
           </dd>
</dl> </li>
</ul> <a name="PageRanges-int-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>PageRanges</h4> <pre>public PageRanges(int lowerBound,
                  int upperBound)</pre>
<div class="block">
<span>构造包含单个整数范围的新页面范围属性。</span>
<span>也就是说，只打印一个范围内的那些页面。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>lowerBound</code> - 下限范围。 
           </dd>
<dd>
<code>upperBound</code> - 范围的上限。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - （未检查的异常）如果指定了一个空范围或者如果指定了一个非空范围（ 
            <code>lowerBound</code>小于1），则抛出异常。 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="equals-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>equals</h4> <pre>public boolean equals(<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a> object)</pre>
<div class="block">
<span>返回此页面范围属性是否等同于传入的对象。</span>
<span>要相等的，所有以下条件必须为真：</span>
<ol type="1">
<li> <span><code>object</code>不为空。</span> </li>
<li> <span><code>object</code>是类PageRanges的一个实例。</span> </li>
<li> <span>这个页面是属性的成员， <code>object</code>的成员是一样的。</span> </li>
</ol>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html#equals-java.lang.Object-">equals</a></code>在 
            <code><a href="../../../../javax/print/attribute/SetOfIntegerSyntax.html" title="class in javax.print.attribute">SetOfIntegerSyntax</a></code>类 
           </dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>object</code> - 要比较的对象。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果 
            <code>object</code>相当于此页面范围属性，则为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="getCategory--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCategory</h4> <pre>public final <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; getCategory()</pre>
<div class="block">
<span>获取要用作此打印属性值的“类别”的打印属性类。</span>
<p> <span>对于类PageRanges，类别是PageRanges本身。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/print/attribute/Attribute.html#getCategory--">getCategory</a></code>在界面 
            <code><a href="../../../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>打印属性类（category），类别为<a href="../../../../java/lang/Class.html" title="java.lang中的类"><code>java.lang.Class</code>的</a>一个实例。</span>
</dd>
</dl> </li>
</ul> <a name="getName--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getName</h4> <pre>public final <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getName()</pre>
<div class="block">
<span>获取此属性值是一个实例的类别的名称。</span>
<p> <span>对于Class PageRanges，类别名称为<code>"page-ranges"</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/print/attribute/Attribute.html#getName--">getName</a></code>在接口 
            <code><a href="../../../../javax/print/attribute/Attribute.html" title="interface in javax.print.attribute">Attribute</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             属性类别名称。 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>