javax.print.attribute.standard
클래스 MediaPrintableArea

java.lang.Object 
  javax.print.attribute.standard.MediaPrintableArea

모든 구현된 인터페이스:

Serializable , Attribute , DocAttribute , PrintJobAttribute , PrintRequestAttribute

public final class MediaPrintableArea
extends Object 
implements DocAttribute , PrintRequestAttribute , PrintJobAttribute 

MediaPrintableArea 는 매체의 인쇄 가능 영역과 인쇄 불가능 영역을 구별하는 인쇄 속성입니다.

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

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

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

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

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

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

인쇄 가능 영역 속성의 값은, 내부적으로는 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 인치 (in) 단위를 나타내는 값입니다.
static int	MM 밀리미터 (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 <? extends Attribute >	getCategory () 이 인쇄 속성치의 「카테고리」로서 사용되는 인쇄 속성 클래스를 돌려줍니다.
float	getHeight (int units) 인쇄 가능 영역의 높이가 지정된 단위로 돌려줍니다.
String	getName () 속성치가 인스턴스가 되는 카테고리의 이름을 돌려줍니다.
float[]	getPrintableArea (int units) x, y, w, h 의 4 개의 값의 이 순서의 배열로서 인쇄 가능 영역을 돌려줍니다.
float	getWidth (int units) 인쇄 가능 영역의 폭이 지정된 단위로 돌려줍니다.
float	getX (int units) 인쇄 가능 영역의 원점의 x 좌표가 지정된 단위로 돌려줍니다.
float	getY (int units) 인쇄 가능 영역의 원점의 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

인치 (in) 단위를 나타내는 값입니다. 이것은, 실제로 인치에 곱셈해 µm (25400)를 산출하는 변환계수입니다.

관련 항목:

정수 필드치

MM

public static final int MM

밀리미터 (mm) 단위를 나타내는 값입니다. 이것은, 실제로 mm 에 곱셈해 µm (1000)를 산출하는 변환계수입니다.

관련 항목:

정수 필드치

생성자 의 상세

MediaPrintableArea

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

부동 소수점치로부터 MediaPrintableArea 객체를 구축합니다.

파라미터:

x - 인쇄 가능 영역의 원점의 x 좌표

y - 인쇄 가능 영역의 원점의 y 좌표

w - 인쇄 가능 영역의 폭

h - 인쇄 가능 영역의 높이

units - 치의 단위

예외:

IllegalArgumentException - x < 0 또는 y < 0 또는 w <= 0 또는 h <= 0 또는 units < 1 의 경우에 throw 된다

MediaPrintableArea

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

정수치로부터 MediaPrintableArea 객체를 구축합니다.

파라미터:

x - 인쇄 가능 영역의 원점의 x 좌표

y - 인쇄 가능 영역의 원점의 y 좌표

w - 인쇄 가능 영역의 폭

h - 인쇄 가능 영역의 높이

units - 치의 단위

예외:

IllegalArgumentException - x < 0 또는 y < 0 또는 w <= 0 또는 h <= 0 또는 units < 1 의 경우에 throw 된다

메소드의 상세

getPrintableArea

public float[] getPrintableArea(int units)

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

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

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

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, throw 된다

getX

public float getX(int units)

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

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

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

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, throw 된다

getY

public float getY(int units)

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

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

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

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, throw 된다

getWidth

public float getWidth(int units)

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

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

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

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, throw 된다

getHeight

public float getHeight(int units)

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

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

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

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, throw 된다

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 <?  extends Attribute > 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 의 경우, throw 된다

toString

public String  toString()

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

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현

hashCode

public int hashCode()

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

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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