javax.print.attribute.standard
類別 PageRanges

java.lang.Object
  javax.print.attribute.SetOfIntegerSyntax
      javax.print.attribute.standard.PageRanges

所有已實作的介面：

Serializable, Cloneable, Attribute, DocAttribute, PrintJobAttribute, PrintRequestAttribute

public final class PageRanges
extends SetOfIntegerSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute

PageRanges 類別是列印屬性類別，它是一個整數集，標識 Printer 物件為所要列印的每個文檔的每份副本所使用的列印串流頁範圍。對於那些標識為文檔中不存在的頁，將不會列印任何內容。該屬性與列印串流 頁相關，而與應用程序編號的頁無關（例如，某些字處理應用程序的標題或腳注中的頁數）。

在大多數情況下，要列印的準確頁數由設備驅動程序產生，因此不需要此屬性。但是當列印已經格式化過的存檔文檔時，最終使用者可以選擇只列印該文檔中所包含的頁子集。在這種情況下，如果將頁範圍指定為 "n-m"，則要列印的第一頁將為頁 n。將列印文檔中後面所有的頁，包括頁 m。

如果沒有為列印作業指定 PageRanges 屬性，則將列印文檔的中所有頁。換句話說，PageRanges 屬性的預設值始終是 {{1, Integer.MAX_VALUE}}。

多文檔列印作業（一個作業帶有多個文檔）的 PageRanges 屬性的效果取決於是為所有的文檔指定了相同的頁範圍，還是為不同的文檔指定了不同的頁範圍，以及 MultipleDocumentHandling 屬性的值（可能是預設值）。

• 如果為所有的文檔指定了相同的頁範圍，則 MultipleDocumentHandling 的任何值都有意義，因此印表機的處理取決於 MultipleDocumentHandling 的值：
  • SINGLE_DOCUMENT -- 所有輸入文檔都將合併到一個輸出文檔中。將列印該輸出文檔指定的頁範圍。

  • SINGLE_DOCUMENT_NEW_SHEET -- 所有的輸入文檔都將合併到一個輸出文檔中，並且始終在新的介質紙張上開始每個輸入文檔的第一個印張。將列印該輸出文檔指定的頁範圍。

  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 對於每個單獨的輸入文檔，都將列印指定的頁範圍。

  • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 對於每個單獨的輸入文檔，都將列印指定的頁範圍。
  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- 對於每個單獨的輸入文檔，將列印出其自己指定的頁範圍。

  • SEPARATE_DOCUMENTS_COLLATED_COPIES -- 對於每個單獨的輸入文檔，將列印出其自己指定的頁範圍。

IPP 相容性： PageRanges 屬性的規範陣列形式提供了要包括在內的所有頁範圍的下邊界和上邊界，以及 IPP "page-ranges" 屬性。有關規範陣列形式的解釋，請參閱類別 SetOfIntegerSyntax。由 getName() 返回的類別別名稱提供了 IPP 屬性名稱。

另請參見：

序列化表格

建構子摘要

PageRanges(int member)
建構一個套件括單個整數的新 PageRanges 屬性。

PageRanges(int[][] members)
建構具有給定成員的新 PageRanges 屬性。

PageRanges(int lowerBound, int upperBound)
建構一個套件括單一整數範圍的新 PageRanges 屬性。

PageRanges(String members)
建構具有給定成員（字元串形式）的新 PageRanges 屬性。

方法摘要

boolean	equals(Object object) 返回此 PageRanges 屬性是否等效於傳入的物件。
Class<? extends Attribute>	getCategory() 獲取將用作此列印屬性值的“類別別”的列印屬性類別。
String	getName() 獲取類別別的名稱，此屬性值是該類別別的一個實例。

從類別 javax.print.attribute.SetOfIntegerSyntax 繼承的方法

contains, contains, getMembers, hashCode, next, toString

從類別 java.lang.Object 繼承的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

PageRanges

public PageRanges(int[][] members)

建構具有給定成員的新 PageRanges 屬性。以“陣列形式”指定這些成員，有關陣列形式的解釋，請參閱類別 SetOfIntegerSyntax。

參數：

members - 以陣列形式設置的成員。

拋出：

NullPointerException - （未經檢查的異常）如果 members 為 null，或者 members 的任何元素為 null。

IllegalArgumentException - （未經檢查的異常）如果沒有任何 members 元素是長度為一或長度為二的陣列。如果 members 是長度為零的陣列，或者集合中的任何成員都小於 1，則也會拋出此異常。

PageRanges

public PageRanges(String members)

建構具有給定成員（字元串形式）的新 PageRanges 屬性。有關語法的解釋，請參閱類別 SetOfIntegerSyntax。

參數：

members - 以字元串形式設置的成員。

拋出：

NullPointerException - （未經檢查的異常）如果 members 為 null，或者 members 的任何元素為 null。

IllegalArgumentException - （未經檢查的異常）如果 members 沒有遵守正確的語法。如果建構的整數集為零長度的陣列，或者集合中的任何成員小於 1，則也會拋出此異常。

PageRanges

public PageRanges(int member)

建構一個套件括單個整數的新 PageRanges 屬性。也就是說只列印一頁。

參數：

member - 設置的成員。

拋出：

IllegalArgumentException - （未經檢查的異常）如果 member 小於 1。

PageRanges

public PageRanges(int lowerBound,
                  int upperBound)

建構一個套件括單一整數範圍的新 PageRanges 屬性。也就是說只列印那些在一個範圍中的頁。

參數：

lowerBound - 範圍的下邊界。

upperBound - 範圍的上邊界。

拋出：

IllegalArgumentException - （未經檢查的異常）如果指定了 null 範圍，或者指定了非 null 的範圍，但 lowerBound 小於 1。

方法詳細資訊

equals

public boolean equals(Object object)

返回此 PageRanges 屬性是否等效於傳入的物件。若要等效，以下所有條件都必須為 true：

1. object 不為 null。
2. object 是類別 PageRanges 的一個實例。
3. 此 PageRanges 屬性的成員和 object 的成員相同。

覆寫：

類別 SetOfIntegerSyntax 中的 equals

參數：

object - 要比較的物件。

返回：

如果 object 等效於此 PageRanges 屬性，則返回 True，否則返回 false。

另請參見：

Object.hashCode(), Hashtable

getCategory

public final Class<? extends Attribute> getCategory()

獲取將用作此列印屬性值的“類別別”的列印屬性類別。

對於類別 PageRanges，該類別別就是類別 PageRanges 本身。

指定者：

介面 Attribute 中的 getCategory

返回：

列印屬性類別（類別別），這是類別 java.lang.Class 的一個實例。

getName

public final String getName()

獲取類別別的名稱，此屬性值是該類別別的一個實例。

對於類別 PageRanges，該類別別名稱是 "page-ranges"。

指定者：

介面 Attribute 中的 getName

返回：

屬性類別別名稱。