- java.lang.Object
-
- javax.print.attribute.Size2DSyntax
-
- javax.print.attribute.standard.MediaSize
-
- 实现的所有接口
-
Serializable
,Cloneable
,Attribute
public class MediaSize extends Size2DSyntax implements Attribute
类别MediaSize
是一个二维尺寸值打印属性类,它以纵向方向指示介质的尺寸,其中X
尺寸沿底边运行,Y
尺寸沿左边缘运行。 因此,Y
维度必须大于或等于X
维度。MediaSize
类声明了许多标准介质尺寸值,组织为ISO,JIS,北美,工程和其他介质的嵌套类。MediaSize
尚未用于指定媒体。 它目前的作用是作为命名媒体的映射(见MediaSizeName
)。 客户端可以使用映射方法MediaSize.getMediaSizeForName(MediaSizeName)
查找此API中枚举的MediaSizeName
实例的物理尺寸。 这对需要此信息格式化和分页打印的客户非常有用。- 另请参见:
- Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 static class
MediaSize.Engineering
类别MediaSize.Engineering
包括工程媒体的MediaSize
值。static class
MediaSize.ISO
MediaSize.ISO
类包括ISO媒体的MediaSize
值。static class
MediaSize.JIS
类别MediaSize.JIS
包括JIS(日语)媒体的MediaSize
值。static class
MediaSize.NA
MediaSize.NA
类包括北美媒体的MediaSize
值。static class
MediaSize.Other
MediaSize.Other
类包括其他媒体的MediaSize
值。
-
字段汇总
-
声明的属性在类 javax.print.attribute.Size2DSyntax
INCH, MM
-
-
构造方法摘要
构造方法 构造器 描述 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)
根据给定的整数值构造新的媒体大小属性。
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 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()
获取此属性值为实例的类别的名称。-
声明方法的类 javax.print.attribute.Size2DSyntax
getSize, getX, getXMicrometers, getY, getYMicrometers, hashCode, toString, toString
-
-
-
-
构造方法详细信息
-
MediaSize
public MediaSize(float x, float y, int units)
根据给定的浮点值构造新的媒体大小属性。- 参数
-
x
-X
尺寸 -
y
-Y
尺寸 -
units
- 单位换算系数,例如Size2DSyntax.INCH
或Size2DSyntax.MM
- 异常
-
IllegalArgumentException
- 如果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
- 如果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
- 如果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
- 如果x < 0
或y < 0
或units < 1
或x > y
-
-
方法详细信息
-
getMediaSizeName
public MediaSizeName getMediaSizeName()
获取此大小的媒体名称(如果有)。- 结果
-
此媒体大小的名称,如果没有名称与此大小相关联,
null
(匿名大小)
-
getMediaSizeForName
public static MediaSize getMediaSizeForName(MediaSizeName media)
获取指定命名媒体的MediaSize
。- 参数
-
media
- 要求大小的媒体的名称 - 结果
-
媒体大小,如果此媒体未与任何大小关联,
null
-
findMedia
public static MediaSizeName findMedia(float x, float y, int units)
指定尺寸被用于定位一个匹配MediaSize
从所有标准之中实例MediaSize
实例。 如果没有完全匹配,则使用最接近的匹配。MediaSize
又用于定位MediaSizeName
对象。 如果最接近的匹配MediaSize
没有对应的Media
实例,则该方法可以返回null
。此方法对于仅具有维度并且想要找到对应于维度的
Media
客户端非常有用。- 参数
-
x
-X
维度 -
y
-Y
维度 -
units
- 单位换算系数,例如Size2DSyntax.INCH
或Size2DSyntax.MM
- 结果
-
MediaSizeName
匹配这些尺寸,或null
- 异常
-
IllegalArgumentException
-如果x <= 0
,y <= 0
,或units < 1
-
equals
public boolean equals(Object object)
返回此媒体大小属性是否等效于传入的对象。 为了等效,所有以下条件必须为真:-
object
不是null
。 -
object
是类MediaSize
的实例。 - 此媒体大小属性的
X
维度等于object
的X
维度。 - 此媒体大小属性的
Y
维度等于object
的Y
维度。
- 重写:
-
equals
类Size2DSyntax
- 参数
-
object
-Object
来比较 - 结果
-
true
如果object
等效于此媒体大小属性,false
- 另请参见:
-
Object.hashCode()
,HashMap
-
-
getCategory
public final 类<? extends Attribute> getCategory()
获取将用作此打印属性值的“类别”的打印属性类。对于类
MediaSize
和任何供应商定义的子类,类别为MediaSize
类。- Specified by:
-
getCategory
,界面Attribute
- 结果
-
打印属性类(类别),类
java.lang.Class
的实例
-
-