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 인스턴스의 물리적인 치수를 검색할 수가 있습니다. 이 메소드는 이 정보를 인쇄의 서식 설정과 페이지 작성에 사용하는 클라이언트로 유효합니다.

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

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 인스턴스를 검색합니다.
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 < 0 또는 y < 0 또는 units < 1 또는 x > y 의 경우에 throw 된다

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 의 경우에 throw 된다

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 의 경우에 throw 된다

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 의 경우에 throw 된다

메소드의 상세

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

반환값:

속성 카테고리의 이름