模块 java.desktop
包 javax.print.attribute.standard

类 MediaSize

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 实例的物理维度。这对于需要此信息来格式化和分页打印的客户很有用。

参见：

  • 构造方法详细信息

    • 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)
      返回此媒体大小属性是否等效于传入的对象。要等效，必须满足以下所有条件：
      1. object 不是 null。
      2. object 是类 MediaSize 的实例。
      3. 此媒体大小属性的 X 维度等于 object 的 X 维度。
      4. 此媒体大小属性的 Y 维度等于 object 的 Y 维度。
      重写：
      equals 在类 Size2DSyntax 中
      参数：
      object - Object 比较
      返回：
      true 如果 object 等于此媒体大小属性，false 否则
      参见：

    • getCategory

      public final Class <? extends Attribute > getCategory()
      获取将用作此打印属性值的“类别”的打印属性类。

      对于类 MediaSize 和任何供应商定义的子类，类别是类 MediaSize 本身。

      指定者：
      getCategory 在接口 Attribute 中
      返回：
      打印属性类（类别），类java.lang.Class 的一个实例

    • getName

      public final String  getName()
      获取此属性值是其实例的类别的名称。

      对于类 MediaSize 和任何供应商定义的子类，类别名称为 "media-size"。

      指定者：
      getName 在接口 Attribute 中
      返回：
      属性类别名称