javax.print.attribute.standard
클래스 MediaSize

java.lang.Object 
  |
  +--javax.print.attribute.Size2DSyntax 
        |
        +--javax.print.attribute.standard.MediaSize

모든 구현 인터페이스:

Attribute , Cloneable , Serializable

public class MediaSize

extends Size2DSyntax

implements Attribute

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

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

관련 항목:

직렬화 된 형식

중첩된 클래스의 개요

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	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

getCategory

public final Class  getCategory()

이 인쇄 속성치의 「카테고리」로서 사용되는 인쇄 속성 클래스를 돌려줍니다.

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

정의:

인터페이스 Attribute 내의 getCategory

반환값:

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

getName

public final String  getName()

이 속성치가 인스턴스인 카테고리의 명칭을 돌려줍니다.

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

정의:

인터페이스 Attribute 내의 getName

반환값:

속성 카테고리명