|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.JobAttributes
public final class JobAttributes
控制打印作业的属性集合。
此类的实例控制份数、默认选择、目标、打印对话框、文件和打印机名称、页面范围、多文档处理(包括整理)和使用此实例的每个打印作业的多页整版(如双面)。在可能的地方属性名遵守 Internet Printing Protocol (IPP) 1.1。在可能的地方属性值部分地遵守 Internet Printing Protocol (IPP) 1.1。
要使用采用内部类类型的方法,需要将引用传递给内部类的常量字段之一。客户端代码无法创建内部类类型的新实例,因为这些类都不具有公共构造方法。例如,将打印对话框类型设置为跨平台的纯 Java 打印对话框,使用以下代码:
import java.awt.JobAttributes; public class PureJavaPrintDialogExample { public void setPureJavaPrintDialog(JobAttributes jobAttributes) { jobAttributes.setDialog(JobAttributes.DialogType.COMMON); } }
每个支持 attributeName(默认值)的 IPP 属性都具有相应的 setattributeNameToDefault
方法。未提供默认值字段。
嵌套类摘要 | |
---|---|
static class |
JobAttributes.DefaultSelectionType
可能的默认选择状态的类型安全的枚举。 |
static class |
JobAttributes.DestinationType
可能的作业目标的类型安全枚举。 |
static class |
JobAttributes.DialogType
显示给用户的可能对话框的类型安全枚举。 |
static class |
JobAttributes.MultipleDocumentHandlingType
可能的多副本处理状态的类型安全枚举。 |
static class |
JobAttributes.SidesType
可能的多页整版的类型安全枚举。 |
构造方法摘要 | |
---|---|
JobAttributes()
构造一个具有每个属性的默认值的 JobAttributes 实例。 |
|
JobAttributes(int copies,
JobAttributes.DefaultSelectionType defaultSelection,
JobAttributes.DestinationType destination,
JobAttributes.DialogType dialog,
String fileName,
int maxPage,
int minPage,
JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling,
int[][] pageRanges,
String printer,
JobAttributes.SidesType sides)
构造一个具有每个属性指定值的 JobAttributes 实例。 |
|
JobAttributes(JobAttributes obj)
构造一个 JobAttributes 实例,作为所提供的 JobAttributes 的副本。 |
方法摘要 | |
---|---|
Object |
clone()
创建并返回此 JobAttributes 的一个副本。 |
boolean |
equals(Object obj)
确定两个 JobAttributes 是否相等。 |
int |
getCopies()
返回应用程序应该使用这些属性呈现作业的份数。 |
JobAttributes.DefaultSelectionType |
getDefaultSelection()
指定应用程序应该为使用这些属性的作业打印所有页面,即 getPageRanges 的返回值所指定范围的页面,还是打印当前选择的页面。 |
JobAttributes.DestinationType |
getDestination()
指定将输出到打印机还是使用这些属性的作业文件。 |
JobAttributes.DialogType |
getDialog()
返回对于使用这些属性的作业,用户是否应该看到用于修改打印设置的打印对话框,以及显示哪种类型的打印对话框。 |
String |
getFileName()
指定使用这些属性的作业的输出文件的文件名。 |
int |
getFromPage()
对于使用这些属性的作业,如果要打印某个范围的页面,则返回要打印的第一页。 |
int |
getMaxPage()
指定对于使用这些属性的作业,用户可以指定为要打印的最后一页的最大值。 |
int |
getMinPage()
指定对于使用这些属性的作业,用户可以指定为要打印的第一页的最小值。 |
JobAttributes.MultipleDocumentHandlingType |
getMultipleDocumentHandling()
为使用这些属性的作业指定多份处理,包括整理。 |
int[][] |
getPageRanges()
对于使用这些属性的作业,如果要打印某个范围的页面,则指定要打印的页面范围。 |
String |
getPrinter()
为使用这些属性的作业返回目标打印机。 |
JobAttributes.SidesType |
getSides()
返回对于使用这些属性的作业,如何在打印介质的面上强制应用连续页。 |
int |
getToPage()
对于使用这些属性的作业,如果要打印某个范围的页面,则返回要打印的最后一页(包括该页)。 |
int |
hashCode()
返回此 JobAttributes 的哈希码值。 |
void |
set(JobAttributes obj)
将此 JobAttributes 的所有属性设置为与 obj 的属性相同的值。 |
void |
setCopies(int copies)
指定应用程序应该使用这些属性呈现作业的份数。 |
void |
setCopiesToDefault()
将应用程序应该使用这些属性呈现作业的份数设置为默认值。 |
void |
setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)
指定应用程序应该为使用这些属性的作业打印所有页面,即 getPageRanges 的返回值所指定范围的页面,还是打印当前选择的页面。 |
void |
setDestination(JobAttributes.DestinationType destination)
指定将输出到打印机还是使用这些属性的作业文件。 |
void |
setDialog(JobAttributes.DialogType dialog)
指定对于使用这些属性的作业,用户是否应该看到用于修改打印设置的打印对话框,以及显示哪种类型的打印对话框。 |
void |
setFileName(String fileName)
指定使用这些属性的作业的输出文件的文件名。 |
void |
setFromPage(int fromPage)
对于使用这些属性的作业,如果要打印某个范围的页面,则指定要打印的第一页。 |
void |
setMaxPage(int maxPage)
指定对于使用这些属性的作业,用户可以指定为要打印的最后一页的最大值。 |
void |
setMinPage(int minPage)
指定对于使用这些属性的作业,用户可以指定为要打印的第一页的最小值。 |
void |
setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling)
为使用这些属性的作业指定多份处理,包括整理。 |
void |
setMultipleDocumentHandlingToDefault()
对于使用这些属性的作业,将多份处理(包括整理)设置为默认值。 |
void |
setPageRanges(int[][] pageRanges)
对于使用这些属性的作业,如果要打印某个范围的页面,则指定要打印的页面范围。 |
void |
setPrinter(String printer)
为使用这些属性的作业指定目标打印机。 |
void |
setSides(JobAttributes.SidesType sides)
指定对于使用这些属性的作业,如何在打印介质的面上强制应用连续页。 |
void |
setSidesToDefault()
对于使用这些属性的作业,将如何在打印介质的面上强制应用连续页设置为默认值。 |
void |
setToPage(int toPage)
对于使用这些属性的作业,如果要打印某个范围的页面,则指定要打印的最后一页(包括该页)。 |
String |
toString()
返回此 JobAttributes 的字符串表示形式。 |
从类 java.lang.Object 继承的方法 |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
public JobAttributes()
JobAttributes
实例。对话框默认为 DialogType.NATIVE
。最小页默认为 1
。最大页默认为 Integer.MAX_VALUE
。目标默认为 DestinationType.PRINTER
。选择默认为 DefaultSelectionType.ALL
。份数默认为 1
。多文档处理默认为 MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES
。面默认为 SidesType.ONE_SIDED
。文件名默认为 null
。
public JobAttributes(JobAttributes obj)
JobAttributes
实例,作为所提供的 JobAttributes
的副本。
obj
- 要复制的 JobAttributes
public JobAttributes(int copies, JobAttributes.DefaultSelectionType defaultSelection, JobAttributes.DestinationType destination, JobAttributes.DialogType dialog, String fileName, int maxPage, int minPage, JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling, int[][] pageRanges, String printer, JobAttributes.SidesType sides)
JobAttributes
实例。
copies
- 复制一个大于 0 的整数defaultSelection
- DefaultSelectionType.ALL
、DefaultSelectionType.RANGE
和 DefaultSelectionType.SELECTION
destination
- DesintationType.FILE
或 DesintationType.PRINTER
dialog
- DialogType.COMMON
、DialogType.NATIVE
或 DialogType.NONE
fileName
- 可能为 null
文件名maxPage
- 大于零且大于或等于 minPage 的整数minPage
- 大于零且小于或等于 maxPage 的整数multipleDocumentHandling
- MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES
或 MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES
pageRanges
- 两个元素的整数数组的数组;数组的范围被解释为包括两个指定页面以及它们之间的所有页面;范围必须为升序并且一定不能重叠;指定的页码既不能小于 minPage 也不能大于 maxPage;例如:
(new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }),指定页面 1、2、3、5、15、16、17、18 和 19。注意,(
new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }
) 是一种无效的页面范围设置,因为两个范围重叠printer
- 可能为 null
打印机名称sides
- SidesType.ONE_SIDED
、SidesType.TWO_SIDED_LONG_EDGE
或 SidesType.TWO_SIDED_SHORT_EDGE
IllegalArgumentException
- 如果违反了一个或多个上述条件方法详细信息 |
---|
public Object clone()
JobAttributes
的一个副本。
Object
中的 clone
JobAttributes
Cloneable
public void set(JobAttributes obj)
JobAttributes
的所有属性设置为与 obj 的属性相同的值。
obj
- 要复制的 JobAttributes
public int getCopies()
public void setCopies(int copies)
1
。
copies
- 复制一个大于 0 的整数
IllegalArgumentException
- 如果 copies
小于或等于 0public void setCopiesToDefault()
public JobAttributes.DefaultSelectionType getDefaultSelection()
getPageRanges
的返回值所指定范围的页面,还是打印当前选择的页面。将此属性更新为用户选择的值。
public void setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)
getPageRanges
的返回值所指定范围的页面,还是打印当前选择的页面。不指定此属性等效于指定 DefaultSelectionType.ALL。
defaultSelection
- DefaultSelectionType.ALL、DefaultSelectionType.RANGE 或 DefaultSelectionType.SELECTION。
IllegalArgumentException
- 如果 defaultSelection 为 null
public JobAttributes.DestinationType getDestination()
public void setDestination(JobAttributes.DestinationType destination)
destination
- DesintationType.FILE 或 DesintationType.PRINTER。
IllegalArgumentException
- 如果目标为 null。public JobAttributes.DialogType getDialog()
DialogType.COMMON
、DialogType.NATIVE
或 DialogType.NONE
public void setDialog(JobAttributes.DialogType dialog)
dialog
- DialogType.COMMON、DialogType.NATIVE 或 DialogType.NONE。
IllegalArgumentException
- 如果对话框为 null。public String getFileName()
null
文件名public void setFileName(String fileName)
fileName
- 可能为 null 文件名。public int getFromPage()
getDefaultSelection
方法的返回值为 DefaultSelectionType.RANGE。如有可能,应用程序应该优先使用 getPageRanges
的返回值而不是此方法的返回值。
public void setFromPage(int fromPage)
fromPage
- 大于零且小于或等于 toPage 并且大于或等于 minPage 且小于或等于 maxPage 的整数。
IllegalArgumentException
- 如果违反了一个或多个上述条件。public int getMaxPage()
public void setMaxPage(int maxPage)
Integer.MAX_VALUE
。
maxPage
- 大于零且大于或等于 minPage 的整数
IllegalArgumentException
- 如果违反了一个或多个上述条件public int getMinPage()
public void setMinPage(int minPage)
1
。
minPage
- 大于零且小于或等于 maxPage 的整数。
IllegalArgumentException
- 如果违反了一个或多个上述条件。public JobAttributes.MultipleDocumentHandlingType getMultipleDocumentHandling()
public void setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling)
multipleDocumentHandling
- MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES 或 MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES。
IllegalArgumentException
- 如果 multipleDocumentHandling 为 null。public void setMultipleDocumentHandlingToDefault()
public int[][] getPageRanges()
getDefaultSelection
方法的返回值为 DefaultSelectionType.RANGE。
public void setPageRanges(int[][] pageRanges)
pageRanges
- 两个元素的整数数组的数组。数组的范围被解释为包括两个指定页面以及它们之间的所有页面。范围必须为升序并且一定不能重叠。指定的页码不能小于 minPage,也不能大于 maxPage。例如:(new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }) 指定页面 1、2、3、5、15、16、17、18 和 19。注意,(new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }) 是一种页面范围的无效设置,因为两个范围重叠。
IllegalArgumentException
- 如果违反了一个或多个上述条件。public String getPrinter()
public void setPrinter(String printer)
printer
- 可能为 null 打印机名称。public JobAttributes.SidesType getSides()
public void setSides(JobAttributes.SidesType sides)
sides
- SidesType.ONE_SIDED、SidesType.TWO_SIDED_LONG_EDGE 或 SidesType.TWO_SIDED_SHORT_EDGE。
IllegalArgumentException
- 如果面为 null。public void setSidesToDefault()
public int getToPage()
getDefaultSelection
方法的返回值是 DefaultSelectionType.RANGE。如果可能,应用程序应该优先使用 getPageRanges
的返回值而不用此方法的返回值。
public void setToPage(int toPage)
toPage
- 大于零且大于或等于 fromPage 并且大于或等于 minPage 且小于或等于 maxPage 的整数。
IllegalArgumentException
- 如果违反了一个或多个上述条件。public boolean equals(Object obj)
当且仅当两个 JobAttributes 的每个属性都相等时,这两个 JobAttributes 才相等。当且仅当字段都引用同一个惟一枚举对象时,枚举类型的属性才相等。当且仅当范围集合长度相等,每个范围枚举相同的页面并且这些范围顺序都相同时,页面范围的集合才相等。
Object
中的 equals
obj
- 将检查其相等性的对象。
Object.hashCode()
,
Hashtable
public int hashCode()
Object
中的 hashCode
Object.equals(java.lang.Object)
,
Hashtable
public String toString()
Object
中的 toString
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。