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는 타테나가에 두었을 경우의 매체의 크기를 2 차원의 사이즈값으로 가리키는 인쇄 속성 클래스입니다. X 차원이 저변의 길이, Y 차원이 좌변의 길이를 나타냅니다. Y 차원의 값은 X 차원의 값이상일 필요가 있습니다. 많은 표준적인 매체의 사이즈값이 선언되어 상자로 되고 있는 ISO, JIS, 북미 규격, 기술 규격, 그 외 매체등의 클래스에 각각 정리하고 있습니다.

MediaSize는 현재는 아직 매체의 지정에는 사용되지 않습니다. 현재의 역할은 지정된 매체에의 매핑입니다 (MediaSizeName를 참조). 클라이언트측에서 매핑 메서드 MediaSize.getMediaSizeForName(MediaSizeName)를 사용해, 이 API 로 열거되고 있는 MediaSizeName 인스턴스의 물리적인 크기를 검색할 수 있습니다 . 이 메서드는 이 정보를 인쇄의 서식 설정과 페이지 작성에 사용하는 클라이언트로 유효합니다.

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

static class	MediaSize.Engineering MediaSize.Engineering 클래스에는 기술 규격 매체 MediaSize 값이 포함되어 있습니다.
static class	MediaSize.ISO MediaSize.ISO 클래스에는 ISO 매체 MediaSize 값이 포함되어 있습니다.
static class	MediaSize.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 인스턴스를 검색합니다.
Class <? 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

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

MediaSize

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

지정된 부동 소수점치를 사용해 새로운 매체 사이즈 속성을 구축합니다.

파라미터:

x - X 차원

y - Y 차원

units - Size2DSyntax.INCH 나 Size2DSyntax.MM 등의 단위 변환계수

예외:

IllegalArgumentException - 미확인의 예외. x 또는 y가 제로보다 작은 경우, units가 1 보다 작은 경우, 또는 x가 y 보다 큰 경우

MediaSize

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

지정된 정수값을 사용해 새로운 매체 사이즈 속성을 구축합니다.

파라미터:

x - X 차원

y - Y 차원

units - Size2DSyntax.INCH 나 Size2DSyntax.MM 등의 단위 변환계수

예외:

IllegalArgumentException - 미확인의 예외. x 또는 y가 제로보다 작은 경우, 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 또는 y가 제로보다 작은 경우, 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 또는 y가 제로보다 작은 경우, 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)

이 매체 사이즈 속성이 객체로 건네받는 것과 일치할지 어떨지를 리턴합니다. 다음의 조건이 모두 true인 경우에 일치한다고 보입니다.

1. object가 null은 아니다
2. object가 MediaSize 클래스의 인스턴스이다
3. 이 매체 사이즈 속성의 X 차원이 object X 차원과 동일하다
4. 이 매체 사이즈 속성의 Y 차원이 object Y 차원과 동일하다

오버라이드(override):

클래스 Size2DSyntax 내의 equals

파라미터:

object - 비교 대상의 객체

반환값:

object가 이 매체 사이즈 속성과 동등한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

getCategory

public final Class <?  extends Attribute > getCategory()

이 인쇄 속성값의 「카테고리」로서 사용되는 인쇄 속성 클래스를 리턴합니다.

MediaSize 클래스 및 벤더 정의의 임의의 서브 클래스에서는 카테고리는 MediaSize 클래스 자신이 됩니다.

정의:

인터페이스 Attribute 내의 getCategory

반환값:

인쇄 속성 클래스 (카테고리), java.lang.Class 클래스의 인스턴스

getName

public final String  getName()

속성값이 인스턴스가 되는 카테고리의 이름을 리턴합니다.

MediaSize 클래스 및 벤더 정의의 임의의 서브 클래스에서는 카테고리명은 media-size가 됩니다.

정의:

인터페이스 Attribute 내의 getName

반환값:

속성 카테고리의 이름