PageAttributes (Java Platform SE 8 )

java.lang.Object
- java.awt.PageAttributes

All Implemented Interfaces:

Cloneable
```
public final class PageAttributes
extends Object
implements Cloneable
```
控制打印页的输出的一组属性。
这个类的实例控制颜色状态，纸张大小（媒体类型），方向，逻辑原点，打印质量，以及使用实例的每一个页面的分辨率。属性名是符合互联网打印协议（IPP）1.1可能。属性值在可能的情况下部分兼容。

要使用一个方法，它需要一个内部类类型，通过引用一个内部类的常量字段。客户端代码无法创建内部类类型的新实例，因为这些类中没有一个有公共构造函数。例如，要将颜色状态设置为单色，使用下面的代码：
```
进口java.awt.pageattributes；公共课monochromeexample {公共无效setmonochrome（PageAttributes pageAttributes）{pageattributes。设置颜色（pageattributes。颜色类型。单色）；}}
```
每一个IPP属性支持空属性-默认值有相应的setattributeNameToDefault方法。未提供默认值字段。
从以下版本开始：

一点三

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`PageAttributes.ColorType` 一种可能的颜色状态的类型安全枚举。
`static class`	`PageAttributes.MediaType` 一种可能的纸张尺寸的类型安全枚举。
`static class`	`PageAttributes.OrientationRequestedType` 一种可能的方向的类型安全枚举。
`static class`	`PageAttributes.OriginType` 一种可能的起源的类型安全枚举。
`static class`	`PageAttributes.PrintQualityType` 打印质量可能的打印质量的类型安全枚举。

构造方法摘要

构造方法
Constructor and Description
`PageAttributes()` 构建了一个pageattributes实例为每个属性的默认值。
`PageAttributes(PageAttributes.ColorType color, PageAttributes.MediaType media, PageAttributes.OrientationRequestedType orientationRequested, PageAttributes.OriginType origin, PageAttributes.PrintQualityType printQuality, int[] printerResolution)` 构建了一个pageattributes实例为每个属性指定的值。
`PageAttributes(PageAttributes obj)` 构建了一个pageattributes实例是一个副本的提供PageAttributes。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 创建并返回一个拷贝本PageAttributes。
`boolean`	`equals(Object obj)` 确定两个pageattributes相等。
`PageAttributes.ColorType`	`getColor()` 返回使用这些属性的页面是否会在颜色或单色。
`PageAttributes.MediaType`	`getMedia()` 使用这些属性返回页面的纸张大小。
`PageAttributes.OrientationRequestedType`	`getOrientationRequested()` 返回使用这些属性的页面的打印方向。
`PageAttributes.OriginType`	`getOrigin()` 返回是否画在（0，0）使用这些属性页将在物理页面的左上角，或在可打印区域的左上角。
`int[]`	`getPrinterResolution()` 使用这些属性返回页面的打印分辨率。
`PageAttributes.PrintQualityType`	`getPrintQuality()` 使用这些属性返回页面的打印质量。
`int`	`hashCode()` 返回此pageattributes哈希代码值。
`void`	`set(PageAttributes obj)` 集所有这PageAttributes属性相同的值作为对象的属性。
`void`	`setColor(PageAttributes.ColorType color)` 指定使用这些属性的页面是否会在颜色或单色性中呈现。
`void`	`setMedia(PageAttributes.MediaType media)` 指定使用这些属性的页面所需的纸张大小。
`void`	`setMediaToDefault()` 将这些属性设置为默认区域设置的默认大小的页面的纸张大小。
`void`	`setOrientationRequested(int orientationRequested)` 指定使用这些属性的页面的打印方向。
`void`	`setOrientationRequested(PageAttributes.OrientationRequestedType orientationRequested)` 指定使用这些属性的页面的打印方向。
`void`	`setOrientationRequestedToDefault()` 将这些属性设置为默认的页面的打印方向。
`void`	`setOrigin(PageAttributes.OriginType origin)` 指定是否在（0，0）使用这些属性页将在物理页面的左上角，或在可打印区域的左上角。
`void`	`setPrinterResolution(int printerResolution)` 指定使用这些属性的页面中的每英寸点数指定所需的交叉饲料和饲料打印分辨率。
`void`	`setPrinterResolution(int[] printerResolution)` 指定使用这些属性的页面的所需的打印分辨率。
`void`	`setPrinterResolutionToDefault()` 将使用这些属性的页面设置为默认的打印机分辨率。
`void`	`setPrintQuality(int printQuality)` 指定使用这些属性的页面的打印质量。
`void`	`setPrintQuality(PageAttributes.PrintQualityType printQuality)` 指定使用这些属性的页面的打印质量。
`void`	`setPrintQualityToDefault()` 将这些属性设置为默认的页面的打印质量。
`String`	`toString()` 返回字符串表示这PageAttributes。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - PageAttributes
```
public PageAttributes()
```
    构建了一个pageattributes实例为每个属性的默认值。
  - PageAttributes
```
public PageAttributes(PageAttributes obj)
```
    构建了一个pageattributes实例是一个副本的提供PageAttributes。
    
    参数
    
    obj -复制pageattributes。
  - PageAttributes
```
public PageAttributes(PageAttributes.ColorType color,
                      PageAttributes.MediaType media,
                      PageAttributes.OrientationRequestedType orientationRequested,
                      PageAttributes.OriginType origin,
                      PageAttributes.PrintQualityType printQuality,
                      int[] printerResolution)
```
    构建了一个pageattributes实例为每个属性指定的值。
    
    参数
    
    color - colortype.color或colortype.monochrome。
    
    media之一MediaType类的常量字段。
    
    orientationRequested - OrientationRequestedType.PORTRAIT或orientationrequestedtype.landscape。
    
    origin - origintype.physical或origintype.printable
    
    printQuality - printqualitytype.draft，PrintQualityType.NORMAL，或printqualitytype.high
    
    printerResolution - 3行一个整数数组。第一个元素必须大于0。必须大于0的第二个元素。第三元必须是 3或 4。
    
    异常
    
    IllegalArgumentException如果上述一个或多个条件被违反。
- 方法详细信息
  - clone
```
public Object clone()
```
    创建并返回一个拷贝本PageAttributes。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    新创建的副本。它是安全的把这个对象转换成一个pageattributes。
    
    另请参见：
    
    Cloneable
  - set
```
public void set(PageAttributes obj)
```
    集所有这PageAttributes属性相同的值作为对象的属性。
    
    参数
    
    obj -复制pageattributes。
  - getColor
```
public PageAttributes.ColorType getColor()
```
    返回使用这些属性的页面是否会在颜色或单色。此属性被更新为由用户选择的值。
    
    结果
    
    colortype.color或colortype.monochrome。
  - setColor
```
public void setColor(PageAttributes.ColorType color)
```
    指定使用这些属性的页面是否会在颜色或单色性中呈现。不指定此属性相当于指定colortype.monochrome。
    
    参数
    
    color - colortype.color或colortype.monochrome。
    
    异常
    
    IllegalArgumentException如果色是空的。
  - getMedia
```
public PageAttributes.MediaType getMedia()
```
    使用这些属性返回页面的纸张大小。此属性被更新为由用户选择的值。
    
    结果
    
    一个班的mediaType常量字段。
  - setMedia
```
public void setMedia(PageAttributes.MediaType media)
```
    指定使用这些属性的页面所需的纸张大小。实际的纸张大小将由目标打印机的限制来决定。如果找不到一个确切的匹配，实现将选择最接近的可能匹配。未指定此属性相当于指定默认区域设置的默认大小。在美国和加拿大地区的默认大小是mediatype.na_letter。对于所有其他区域的默认大小是mediatype.iso_a4。
    
    参数
    
    media之一MediaType类的常量字段。
    
    异常
    
    IllegalArgumentException如果媒体是空的。
  - setMediaToDefault
```
public void setMediaToDefault()
```
    将这些属性设置为默认区域设置的默认大小的页面的纸张大小。在美国和加拿大地区的默认大小是mediatype.na_letter。对于所有其他区域的默认大小是mediatype.iso_a4。
  - getOrientationRequested
```
public PageAttributes.OrientationRequestedType getOrientationRequested()
```
    返回使用这些属性的页面的打印方向。此属性被更新为由用户选择的值。
    
    结果
    
    OrientationRequestedType.PORTRAIT或orientationrequestedtype.landscape。
  - setOrientationRequested
```
public void setOrientationRequested(PageAttributes.OrientationRequestedType orientationRequested)
```
    指定使用这些属性的页面的打印方向。没有指定的属性等同于指定OrientationRequestedType.PORTRAIT。
    
    参数
    
    orientationRequested - OrientationRequestedType.PORTRAIT或orientationrequestedtype.landscape。
    
    异常
    
    IllegalArgumentException -如果orientationrequested是空的。
  - setOrientationRequested
```
public void setOrientationRequested(int orientationRequested)
```
    指定使用这些属性的页面的打印方向。指定 3表示肖像。指定 4表示景观。指定任何其他值将产生一个时。没有指定的属性相当于调用setorientationrequested（orientationrequestedtype。画像）。
    
    参数
    
    orientationRequested - 3或 4
    
    异常
    
    IllegalArgumentException -如果orientationrequested不 3或 4
  - setOrientationRequestedToDefault
```
public void setOrientationRequestedToDefault()
```
    将这些属性设置为默认的页面的打印方向。默认的方向是肖像。
  - getOrigin
```
public PageAttributes.OriginType getOrigin()
```
    返回是否画在（0，0）使用这些属性页将在物理页面的左上角，或在可打印区域的左上角。（请注意，这些位置可能是等效的）这个属性不能被修改，并且不受任何限制，实现或目标打印机。
    
    结果
    
    origintype.physical或origintype.printable
  - setOrigin
```
public void setOrigin(PageAttributes.OriginType origin)
```
    指定是否在（0，0）使用这些属性页将在物理页面的左上角，或在可打印区域的左上角。（请注意，这些位置可能是等价的。）不指定的属性等同于指定origintype.physical。
    
    参数
    
    origin - origintype.physical或origintype.printable
    
    异常
    
    IllegalArgumentException如果起源是空的。
  - getPrintQuality
```
public PageAttributes.PrintQualityType getPrintQuality()
```
    使用这些属性返回页面的打印质量。此属性被更新为由用户选择的值。
    
    结果
    
    printqualitytype.draft，PrintQualityType.NORMAL，或printqualitytype.high
  - setPrintQuality
```
public void setPrintQuality(PageAttributes.PrintQualityType printQuality)
```
    指定使用这些属性的页面的打印质量。没有指定的属性等同于指定printqualitytype.normal。
    
    参数
    
    printQuality - printqualitytype.draft，PrintQualityType.NORMAL，或printqualitytype.high
    
    异常
    
    IllegalArgumentException -如果printquality是空的。
  - setPrintQuality
```
public void setPrintQuality(int printQuality)
```
    指定使用这些属性的页面的打印质量。指定 3表示草案。指定 4表示正常。指定 5表示高。指定任何其他值将产生一个时。没有指定的属性相当于调用setprintquality（printqualitytype。正常）。
    
    参数
    
    printQuality - 3， 4，或 5
    
    异常
    
    IllegalArgumentException -如果printquality不 3 ， 4，或 5
  - setPrintQualityToDefault
```
public void setPrintQualityToDefault()
```
    将这些属性设置为默认的页面的打印质量。默认打印质量是正常的。
  - getPrinterResolution
```
public int[] getPrinterResolution()
```
    使用这些属性返回页面的打印分辨率。索引0的数组指定的横向进给方向分辨率（通常是水平分辨率）。索引1的数组指定的进料方向分辨率（通常是垂直分辨率）。指数2的数组指定的分辨率是否每英寸或每厘米点的点。 3表示每英寸点数。 4表示点每厘米。
    
    结果
    
    一个3元素的整数数组。第一个元素必须大于0。必须大于0的第二个元素。第三元必须是 3或 4。
  - setPrinterResolution
```
public void setPrinterResolution(int[] printerResolution)
```
    指定使用这些属性的页面的所需的打印分辨率。实际的解决方案将取决于实现和目标打印机的限制。索引0的数组指定的横向进给方向分辨率（通常是水平分辨率）。索引1的数组指定的进料方向分辨率（通常是垂直分辨率）。指数2的数组指定的分辨率是否每英寸或每厘米点的点。 3表示每英寸点数。 4表示点每厘米。注：1.1打印的实现（工具包。getprintjob）要求进给和横向进给分辨率是相同的。没有指定的属性相当于调用setprinterresolution（72）。
    
    参数
    
    printerResolution - 3行一个整数数组。第一个元素必须大于0。必须大于0的第二个元素。第三元必须是 3或 4。
    
    异常
    
    IllegalArgumentException如果上述一个或多个条件被违反。
  - setPrinterResolution
```
public void setPrinterResolution(int printerResolution)
```
    指定使用这些属性的页面中的每英寸点数指定所需的交叉饲料和饲料打印分辨率。这两项决议都使用相同的值。实际决议将取决于实施和目标打印机的局限性。没有指定的属性等同于指定 72。
    
    参数
    
    printerResolution -大于0的整数。
    
    异常
    
    IllegalArgumentException -如果printerresolution小于或等于0。
  - setPrinterResolutionToDefault
```
public void setPrinterResolutionToDefault()
```
    将使用这些属性的页面设置为默认的打印机分辨率。默认是72 dpi的进给和横向进给分辨率。
  - equals
```
public boolean equals(Object obj)
```
    确定两个pageattributes相等。
    两pageattributes相等当且仅当它们的属性都是平等的。当且仅当字段引用同一个唯一枚举对象时，枚举类型的属性是相等的。这意味着，别名的媒体等于其潜在的独特的媒体。打印机分辨率是相等的，如果和只有当饲料分辨率，交叉饲料分辨率，单位是平等的。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj的平等将被检查的对象。
    
    结果
    
    obj等于这pageattribute按上述标准。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    返回此pageattributes哈希代码值。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    哈希代码。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    返回字符串表示这PageAttributes。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    字符串表示。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class PageAttributes

Nested Class Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

PageAttributes

PageAttributes

PageAttributes

方法详细信息

clone

set

getColor

setColor

getMedia

setMedia

setMediaToDefault

getOrientationRequested

setOrientationRequested

setOrientationRequested

setOrientationRequestedToDefault

getOrigin

setOrigin

getPrintQuality

setPrintQuality

setPrintQuality

setPrintQualityToDefault

getPrinterResolution

setPrinterResolution

setPrinterResolution

setPrinterResolutionToDefault

equals

hashCode

toString