javax.print.attribute.standard
클래스 MediaPrintableArea

java.lang.Object 
  |
  +--javax.print.attribute.standard.MediaPrintableArea

모든 구현 인터페이스:

Attribute , DocAttribute , PrintJobAttribute , PrintRequestAttribute , Serializable

public final class MediaPrintableArea

extends Object

implements DocAttribute , PrintRequestAttribute , PrintJobAttribute

MediaPrintableArea 는 매체의 인쇄 가능 area와 인쇄 불가능 area를 구별하는 인쇄 속성입니다.

인쇄 가능 area는 매체의 치수내에 들어가는 구형으로서 지정합니다.

대부분의 프린터에는 하드웨어상의 제한이 있어, 매체의 표면 전체에 인쇄할 수 없습니다. 이 클래스는 인쇄 작업의 허용치 조회, 인쇄 작업으로 사용할 수 있는 인쇄 가능 area의 제한내에서의 area 요구에 사용할 수 있습니다.

인쇄 가능 area를 조회하는 경우, 클라이언트측에서 적절한 문맥을 제공할 필요가 있습니다. 적어도 사용하는 매체의 사이즈가 지정되어 있지 않으면, 인쇄 가능 area로서 유효한 값을 취득할 수 없습니다.

이 속성은 용지의 구석으로부터의 거리로서는 기술되지 않습니다. 이 이유의 1 개로서 들고 있는 것은 이 속성은 특정의 매체와 관련한 것인 것을 강조하기 (위해)때문에입니다. 이 속성은 다른 속성 선택의 문맥내에서 기술할 필요가 있습니다. 또 클라이언트측의 처리도 인쇄 가능 area를 지정하는 편이 통상은 용이하게 됩니다.

하드웨어의 최소 마진은 프린터의 프로퍼티 뿐만이 아니라, 매체의 사이즈, 방향, 타입, 지정된 마무리등의 영향을 받습니다. 적절한 문맥으로 속성이 서포트하는 값을 PrintService 가 제공하는 메소드로 조회할 수가 있습니다. PrintService.getSupportedAttributeValues() 를 참조해 주세요.

구형의 인쇄 가능 area를 결정하는 경우, 요구하고 있는 문맥내에서 지정되고 있을 방향으로 관련되지 않고 poatrait 모드로 인쇄하는 경우의 용지의 좌상 위치가 원점이 되어, 그 좌표 (x, y)가 설정됩니다. 예를 들어 A4 사이즈 용지의 인쇄 가능 area는 poatrait 모드 및 가로 방향의 어느 쪽의 경우에서도, 높이가 폭보다 커집니다.

인쇄 가능 area 속성의 값은 내부적으로는 micrometer (µm) 단위의 정수로서 저장됩니다. 1 micrometer = 10^-6 meter = 1/1000 millimeter = 1/25400 inch 입니다. 즉 치수를 1/1000 mm (= 1 µm) 또는 1/100 inch (= 254 µm)의 정밀도로 나타낼 수가 있습니다. 소수점 이하의 inch 를 2 의 부 말하고 나무승으로 나타내는 경우, 치수를 1/8 inch (= 3175 µm) 정밀도로 나타낼 수가 있습니다만,1/16 inch 정밀도로 나타낼 수 없습니다. 이것은 1/16 inch 가 µm 의 적분치와 일치하지 않기 때문입니다.

IPP 호환성: MediaPrintableArea 는 IPP 속성이 아닙니다.

관련 항목:

직렬화 된 형식

필드의 개요

static int	INCH inch (in)의 단위를 나타내는 값입니다.
static int	MM millimeter (mm)의 단위를 나타내는 값입니다.

생성자의 개요

MediaPrintableArea (float x, float y, float w, float h, int units)
부동 소수점치로부터 MediaPrintableArea 오브젝트를 구축합니다.

MediaPrintableArea (int x, int y, int w, int h, int units)
정수치로부터 MediaPrintableArea 오브젝트를 구축합니다.

메소드의 개요

boolean	equals (Object object) 이 매체 마진 속성이 오브젝트로 건네받는 것과 일치할지 어떨지를 돌려줍니다.
Class	getCategory () 이 인쇄 속성치의 「카테고리」로서 사용되는 인쇄 속성 클래스를 돌려줍니다.
float	getHeight (int units) 인쇄 가능 area의 높이가 지정된 단위로 돌려줍니다.
String	getName () 이 속성치가 인스턴스인 카테고리의 명칭을 돌려줍니다.
float[]	getPrintableArea (int units) x, y, w, h 의 4 개의 값의 이 순서의 배열로서 인쇄 가능 area를 돌려줍니다.
float	getWidth (int units) 인쇄 가능 area의 폭이 지정된 단위로 돌려줍니다.
float	getX (int units) 인쇄 가능 area의 원점의 x 좌표가 지정된 단위로 돌려줍니다.
float	getY (int units) 인쇄 가능 area의 원점의 y 좌표가 지정된 단위로 돌려줍니다.
int	hashCode () 이 속성의 해시 코드치를 돌려줍니다.
String	toString () 이 구형 사이즈 속성을 mm 단위로, 캐릭터 라인 형식에서 돌려줍니다.
String	toString (int units, String unitsName) 이 구형 사이즈 속성이 지정된 단위로, 캐릭터 라인 형식에서 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

INCH

public static final int INCH

inch (in)의 단위를 나타내는 값입니다. 실제는 inch 를 µm 로 변환하기 위한 변환계수 (25400)입니다.

관련 항목:

정수 필드치

MM

public static final int MM

millimeter (mm)의 단위를 나타내는 값입니다. 실제는 mm 를 µm 로 변환하기 위한 변환계수 (1000)입니다.

관련 항목:

정수 필드치

생성자의 상세

MediaPrintableArea

public MediaPrintableArea(float x,
                          float y,
                          float w,
                          float h,
                          int units)

부동 소수점치로부터 MediaPrintableArea 오브젝트를 구축합니다.

파라미터:

x - 인쇄 가능 area의 원점의 x 좌표

y - 인쇄 가능 area의 원점의 y 좌표

w - 인쇄 가능 area의 폭

h - 인쇄 가능 area의 높이

units - 치의 단위

예외:

IllegalArgumentException - x 또는 y 가 제로보다 작은 경우,w 또는 h 가 제로 이하의 경우, 또는 units 가 1 보다 작은 경우

MediaPrintableArea

public MediaPrintableArea(int x,
                          int y,
                          int w,
                          int h,
                          int units)

정수치로부터 MediaPrintableArea 오브젝트를 구축합니다.

파라미터:

x - 인쇄 가능 area의 원점의 x 좌표

y - 인쇄 가능 area의 원점의 y 좌표

w - 인쇄 가능 area의 폭

h - 인쇄 가능 area의 높이

units - 치의 단위

예외:

IllegalArgumentException - x 또는 y 가 제로보다 작은 경우,w 또는 h 가 제로 이하의 경우, 또는 units 가 1 보다 작은 경우

메소드의 상세

getPrintableArea

public float[] getPrintableArea(int units)

x, y, w, h 의 4 개의 값의 이 순서의 배열로서 인쇄 가능 area를 돌려줍니다. 지정된 단위에서의 값이 돌려주어집니다.

파라미터:

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

반환값:

지정된 단위의 x, y, w, h 의 배열로서 나타내지는 인쇄 가능 area

예외:

IllegalArgumentException - 미확인의 예외. units 가 1 보다 작은 경우

getX

public float getX(int units)

인쇄 가능 area의 원점의 x 좌표가 지정된 단위로 돌려줍니다.

파라미터:

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

반환값:

지정된 단위로 나타내지는 인쇄 가능 area의 원점의 x 좌표

예외:

IllegalArgumentException - 미확인의 예외. units 가 1 보다 작은 경우

getY

public float getY(int units)

인쇄 가능 area의 원점의 y 좌표가 지정된 단위로 돌려줍니다.

파라미터:

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

반환값:

지정된 단위로 나타내지는 인쇄 가능 area의 원점의 y 좌표

예외:

IllegalArgumentException - 미확인의 예외. units 가 1 보다 작은 경우

getWidth

public float getWidth(int units)

인쇄 가능 area의 폭이 지정된 단위로 돌려줍니다.

파라미터:

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

반환값:

지정된 단위로 나타내지는 인쇄 가능 area의 폭

예외:

IllegalArgumentException - 미확인의 예외. units 가 1 보다 작은 경우

getHeight

public float getHeight(int units)

인쇄 가능 area의 높이가 지정된 단위로 돌려줍니다.

파라미터:

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

반환값:

지정된 단위로 나타내지는 인쇄 가능 area의 높이

예외:

IllegalArgumentException - 미확인의 예외. units 가 1 보다 작은 경우

equals

public boolean equals(Object  object)

이 매체 마진 속성이 오브젝트로 건네받는 것과 일치할지 어떨지를 돌려줍니다. 다음의 조건이 모두 true 의 경우에 일치한다고 보입니다.

1. object 가 null 가 아니다
2. object 가 MediaPrintableArea 클래스의 인스턴스이다
3. 원점과 치수가 같다

오버라이드(override):

클래스 Object 내의 equals

파라미터:

object - 비교 대상의 오브젝트

반환값:

object 가 이 매체 마진 속성과 일치하는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable

getCategory

public final Class  getCategory()

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

MediaPrintableArea 클래스의 경우, 카테고리는 MediaPrintableArea 클래스 자신입니다.

정의:

인터페이스 Attribute 내의 getCategory

반환값:

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

getName

public final String  getName()

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

MediaPrintableArea 클래스의 경우, 카테고리명은 media-printable-area 가 됩니다.

이것은 IPP V1. 1 속성이 아닙니다.

정의:

인터페이스 Attribute 내의 getName

반환값:

속성 카테고리명

toString

public String  toString(int units,
                       String  unitsName)

이 구형 사이즈 속성이 지정된 단위로, 캐릭터 라인 형식에서 돌려줍니다.

파라미터:

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

unitsName - 단위명을 나타내는 캐릭터 라인. in 나 mm 등. null 의 경우, 결과에는 단위명은 포함되지 않는다

반환값:

이 2 차원 사이즈 속성의 캐릭터 라인 버젼

예외:

IllegalArgumentException - 미확인의 예외. units 가 1 보다 작은 경우

toString

public String  toString()

이 구형 사이즈 속성을 mm 단위로, 캐릭터 라인 형식에서 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 오브젝트의 캐릭터 라인 표현

hashCode

public int hashCode()

이 속성의 해시 코드치를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 오브젝트의 해시 코드치

관련 항목:

Object.equals(java.lang.Object) , Hashtable