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 또는 y가 제로보다 작은 경우, w 또는 h가 제로 아래의 경우, 또는 units가 1 보다 작은 경우

MediaPrintableArea

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

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

파라미터:

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

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

w - 인쇄 가능 영역의 폭

h - 인쇄 가능 영역의 높이

units - 치의 단위

예외:

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

메서드의 상세

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