javax.print.attribute.standard

Class MediaSize

java.lang.Object

javax.print.attribute.Size2DSyntax

javax.print.attribute.standard.MediaSize

All Implemented Interfaces:

Serializable， Cloneable， Attribute

public class MediaSize
extends Size2DSyntax
implements Attribute

类mediasize是二维尺寸值打印属性类，表明在一个纵向的维度中，与X维沿底部边缘运行和Y维沿左边缘运行。因此，Y维度必须大于或等于X维度。这类mediasize许多标准介质尺寸值，分为嵌套类的ISO、JIS、北美，工程，和其他媒体。

mediasize尚未指定媒体。它的作用是作为一个名为媒体映射（见MediaSizeName）。客户可以用作图的方法MediaSize.getMediaSizeForName(MediaSizeName)找到的mediasizename实例这个API枚举的物理尺寸。这是非常有用的客户需要此信息格式和分页打印。

另请参见：

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MediaSize.Engineering 类mediasize。工程包括工程媒体 MediaSize值。
static class	MediaSize.ISO 类mediasize.iso包括 MediaSize ISO媒体价值。
static class	MediaSize.JIS 类mediasize.jis包括JIS（日本）媒体 MediaSize值。
static class	MediaSize.NA 类mediasize.na包括北美媒体 MediaSize值。
static class	MediaSize.Other 类mediasize。其他包括各种媒体 MediaSize值。

Field Summary

Fields inherited from class javax.print.attribute.Size2DSyntax

INCH, MM

构造方法摘要

构造方法

Constructor and Description
MediaSize(float x, float y, int units) 从给定的浮点值构造一个新的媒体大小属性。
MediaSize(float x, float y, int units, MediaSizeName media) 从给定的浮点值构造一个新的媒体大小属性。
MediaSize(int x, int y, int units) 从给定的整数值构造一个新的媒体大小属性。
MediaSize(int x, int y, int units, MediaSizeName media) 从给定的整数值构造一个新的媒体大小属性。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object object) 返回此媒体大小属性是否等效于对象的传递。
static MediaSizeName	findMedia(float x, float y, int units) 指定的尺寸用于定位匹配mediasize实例从所有标准mediasize实例。
类<? extends Attribute>	getCategory() 获取要用作该打印属性值的“类别”的打印属性类。
static MediaSize	getMediaSizeForName(MediaSizeName media) 获得指定的媒体mediasize命名。
MediaSizeName	getMediaSizeName() 获取此大小的媒体名称，如果有的话。
String	getName() 获取此属性值的类别的名称，即一个实例。

Methods inherited from class javax.print.attribute.Size2DSyntax

getSize, getX, getXMicrometers, getY, getYMicrometers, hashCode, toString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaSize

public MediaSize(float x,
                 float y,
                 int units)

从给定的浮点值构造一个新的媒体大小属性。

参数

x X维。

y Y维度。

units单位转换因子，如 Size2DSyntax.INCH或 Size2DSyntax.MM。

异常

IllegalArgumentException -（unchecked异常）如果 x < 0或 y < 0或 units < 1或 x > y扔。

MediaSize

public MediaSize(int x,
                 int y,
                 int units)

从给定的整数值构造一个新的媒体大小属性。

参数

x X维。

y Y维度。

units单位转换因子，如 Size2DSyntax.INCH或 Size2DSyntax.MM。

异常

IllegalArgumentException -（unchecked异常）如果 x < 0或 y < 0或 units < 1或 x > y扔。

MediaSize

public MediaSize(float x,
                 float y,
                 int units,
                 MediaSizeName media)

从给定的浮点值构造一个新的媒体大小属性。

参数

x X维。

y Y维度。

units单位转换因子，如 Size2DSyntax.INCH或 Size2DSyntax.MM。

media -媒体名称与本mediasize副

异常

IllegalArgumentException -（unchecked异常）如果 x < 0或 y < 0或 units < 1或 x > y扔。

MediaSize

public MediaSize(int x,
                 int y,
                 int units,
                 MediaSizeName media)

从给定的整数值构造一个新的媒体大小属性。

参数

x X维。

y Y维度。

units单位转换因子，如 Size2DSyntax.INCH或 Size2DSyntax.MM。

media -媒体名称与本mediasize副

异常

IllegalArgumentException -（unchecked异常）如果 x < 0或 y < 0或 units < 1或 x > y扔。

方法详细信息

getMediaSizeName

public MediaSizeName getMediaSizeName()

获取此大小的媒体名称，如果有的话。

结果

此媒体大小的名称，或为空，如果没有名称与此大小关联（一个匿名大小）。

getMediaSizeForName

public static MediaSize getMediaSizeForName(MediaSizeName media)

获得指定的媒体mediasize命名。

参数

media - -媒体的大小是名寻求

结果

媒体的大小，或如果此媒体不与任何大小关联的空。

findMedia

public static MediaSizeName findMedia(float x,
                                      float y,
                                      int units)

指定的尺寸用于定位匹配mediasize实例从所有标准mediasize实例。如果没有精确的匹配，则使用最接近的匹配。

的mediasize依次是用来定位mediasizename对象。这种方法如果最匹配的mediasize没有相应的媒体实例返回null。

此方法是有用的，只有尺寸的客户，并希望找到一个媒体对应的尺寸。

参数

x -尺寸

y - Y维度。

units单位转换因子，如 Size2DSyntax.INCH或 Size2DSyntax.MM

结果

mediasizename匹配这些尺寸，或空。

异常

IllegalArgumentException -如果 x <= 0， y <= 0，或 units < 1。

equals

public boolean equals(Object object)

返回此媒体大小属性是否等效于对象的传递。是相等的，以下所有条件必须是真实的：

1. object不空。
2. object是类mediasize实例。
3. 该媒体大小属性的X尺寸等于object X维。
4. 该媒体大小属性的Y维数等于object的Y尺寸。

重写：

equals 方法重写，继承类 Size2DSyntax

参数

object对象比较。

结果

如果 object相当于该媒体大小属性真，否则为假。

另请参见：

Object.hashCode()， HashMap

getCategory

public final 类<? extends Attribute> getCategory()

获取要用作该打印属性值的“类别”的打印属性类。

方法重写，继承类mediasize和任何厂商定义的子类，类是类mediasize本身。

Specified by:

getCategory 接口 Attribute

结果

打印属性类（类）， java.lang.Class类实例。

getName

public final String getName()

获取此属性值的类别的名称，即一个实例。

方法重写，继承类mediasize和任何厂商定义的子类，类的名字是"media-size"。

Specified by:

getName 接口 Attribute

结果

属性类别名称。