Java java.awt 类 PageAttributes（JDK5）

所有类

java.awt
类 PageAttributes

java.lang.Object
  java.awt.PageAttributes

所有已实现的接口：

Cloneable

public final class PageAttributes
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Cloneable
   
   
   
   
   

用来控制打印页面输出的属性集。

此类的实例控制颜色状态、纸张尺寸（介质类型）、打印方向、逻辑原点、打印质量，以及使用实例的每个页面的分辨率。属性名尽可能遵守 Internet Printing Protocol (IPP) 1.1。属性值要尽可能部分地遵守该协议。

要使用采用内部类类型的方法，需要将引用传递给内部类的常量字段之一。客户端代码无法创建内部类类型的新实例，因为这些类都不具有公共构造方法。例如，为了将颜色状态设置为单色，需要使用以下代码：

 import java.awt.PageAttributes;

 public class MonochromeExample {
     public void setMonochrome(PageAttributes pageAttributes) {
         pageAttributes.setColor(PageAttributes.ColorType.MONOCHROME);
     }
 }
 

每个支持 attributeName（默认值）的 IPP 属性均有一个对应的 setattributeNameToDefault 方法。未提供默认值字段。

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，第三个元素必须为 3 或 4。

抛出：

IllegalArgumentException - 如果违反了一个或多个上述条件。

clone

public Object clone()

创建并返回此 PageAttributes 的一个副本。

覆盖：

类 Object 中的 clone

返回：

新创建的副本。可以安全地将此 Object 强制转换为 PageAttributes。

另请参见：

Cloneable

set

public void set(PageAttributes obj)

将此 PageAttributes 的所有属性设置为与 obj 的属性相同的值。

参数：

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 - 如果 color 为 null。

getMedia

public PageAttributes.MediaType getMedia()

返回使用这些属性的页面的纸张尺寸。此属性更新为用户选择的值。

返回：

MediaType 类的常数字段之一。