java.awt
클래스 PageAttributes

java.lang.Object 
  java.awt.PageAttributes

모든 구현된 인터페이스:

Cloneable

public final class PageAttributes
extends Object 
implements Cloneable 

인쇄한 페이지의 출력을 제어하는 속성 세트입니다.

이 클래스의 인스턴스는 색 상태, 용지 사이즈 (미디어의 종류), 용지 방향, 논리적인 원점, 인쇄 품질 및 인스턴스를 사용하는 각 페이지의 해상도를 제어합니다. 속성명은 Internet Printing Protocol (IPP) 1.1에 준거해, 속성값는 일부가 준거하고 있습니다.

내부 클래스형을 취하는 메서드를 사용하려면, 그 내부 클래스의 정수 필드에 대한 참조를 건네줍니다. 클라이언트 코드는 이 클래스가 public 생성자를 가지지 않기 때문에 내부 클래스형의 새로운 인스턴스를 작성할 수 없습니다. 색 상태를 흑백으로 설정하려면, 다음의 코드를 사용합니다.

 import java.awt.PageAttributes;

 public class MonochromeExample {
     public void setMonochrome(PageAttributes pageAttributes) {
         pageAttributes.setColor(PageAttributes.ColorType.MONOCHROME);
     }
 }
 

attributeName 설정값을 지원하는 모든 IPP 속성은 대응하는 setattributeNameToDefault 메서드를 가지고 있습니다. 기정치의 필드는 제공되지 않습니다.

중첩(Nested) 클래스 개요

static class	PageAttributes.ColorType 사용 가능한 컬러 상태의 형태 보증된 열거
static class	PageAttributes.MediaType 사용 가능한 용지 사이즈의 형태 보증된 열거입니다.
static class	PageAttributes.OrientationRequestedType 사용 가능한 용지 방향의 형태 보증된 열거입니다.
static class	PageAttributes.OriginType 사용 가능한 원점의 형태 보증된 열거입니다.
static class	PageAttributes.PrintQualityType 사용 가능한 인쇄 품질의 형태 보증된 열거입니다.

생성자 개요

PageAttributes ()
각 속성에 디폴트의 값을 가지는 PageAttributes 인스턴스를 생성합니다.

PageAttributes (PageAttributes.ColorType color, PageAttributes.MediaType media, PageAttributes.OrientationRequestedType orientationRequested, PageAttributes.OriginType origin, PageAttributes.PrintQualityType printQuality, int[] printerResolution)
각 속성으로 지정된 값을 가지는 PageAttributes 인스턴스를 생성합니다.

PageAttributes (PageAttributes obj)
지정된 PageAttributes 복사인 PageAttributes 인스턴스를 생성합니다.

메서드 개요

Object	clone () PageAttributes 복사본을 작성해, 리턴합니다.
boolean	equals (Object obj) 2개의 PageAttributes가 같은지 어떤지를 판정합니다.
PageAttributes.ColorType	getColor () 이러한 속성을 사용하는 페이지를 컬러로 렌더링 할까 흑백으로 렌더링 할까를 리턴합니다.
PageAttributes.MediaType	getMedia () 이러한 속성을 사용하는 페이지의 용지 사이즈를 리턴합니다.
PageAttributes.OrientationRequestedType	getOrientationRequested () 이러한 속성을 사용하는 페이지의 용지 방향을 리턴합니다.
PageAttributes.OriginType	getOrigin () 이러한 속성을 사용하는 페이지의 (0, 0) 렌더링를 물리 페이지의 좌상구석으로 하는지, 인쇄 범위의 좌상구석으로 할까를 리턴합니다.
int[]	getPrinterResolution () 이러한 속성을 사용하는 페이지의 인쇄 해상도를 리턴합니다.
PageAttributes.PrintQualityType	getPrintQuality () 이러한 속성을 사용하는 페이지의 인쇄 품질을 리턴합니다.
int	hashCode () 이 PageAttributes 해시 코드값을 리턴합니다.
void	set (PageAttributes obj) PageAttributes 모든 속성을 obj 속성과 같은 값으로 설정합니다.
void	setColor (PageAttributes.ColorType color) 이러한 속성을 사용하는 페이지를 컬러로 렌더링 할까 흑백으로 렌더링 하는지를 지정합니다.
void	setMedia (PageAttributes.MediaType media) 이러한 속성을 사용하는 페이지의 용지 사이즈를 지정합니다.
void	setMediaToDefault () 이러한 속성을 사용하는 페이지의 용지 사이즈를 디폴트 로케일의 디폴트 사이즈로 지정합니다.
void	setOrientationRequested (int orientationRequested) 이러한 속성을 사용해, 페이지의 용지 방향을 지정합니다.
void	setOrientationRequested (PageAttributes.OrientationRequestedType orientationRequested) 이러한 속성을 사용하는 페이지의 용지 방향을 지정합니다.
void	setOrientationRequestedToDefault () 이러한 속성을 사용하는 페이지의 용지 방향을 디폴트로 설정합니다.
void	setOrigin (PageAttributes.OriginType origin) 이러한 속성을 사용하는 페이지의 (0, 0) 렌더링를 물리 페이지의 좌상구석으로 하는지, 인쇄 범위의 좌상구석으로 하는지를 지정합니다.
void	setPrinterResolution (int printerResolution) 이러한 속성을 사용하는 페이지의 전후 보내 또는 송의 인쇄 해상도를 1 인치 당의 닷수로 지정합니다.
void	setPrinterResolution (int[] printerResolution) 이러한 속성을 사용하는 페이지의 인쇄 해상도를 지정합니다.
void	setPrinterResolutionToDefault () 이러한 속성을 사용하는 페이지의 프린터 해상도를 디폴트로 설정합니다.
void	setPrintQuality (int printQuality) 이러한 속성을 사용하는 페이지의 인쇄 품질을 지정합니다.
void	setPrintQuality (PageAttributes.PrintQualityType printQuality) 이러한 속성을 사용하는 페이지의 인쇄 품질을 지정합니다.
void	setPrintQualityToDefault () 이러한 속성을 사용하는 페이지의 인쇄 품질을 디폴트로 설정합니다.
String	toString () 이 PageAttributes 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

PageAttributes

public PageAttributes()

각 속성에 디폴트의 값을 가지는 PageAttributes 인스턴스를 생성합니다.

PageAttributes

public PageAttributes(PageAttributes  obj)

지정된 PageAttributes 복사인 PageAttributes 인스턴스를 생성합니다.

파라미터:

obj - 복제 대상의 PageAttributes

PageAttributes

public PageAttributes(PageAttributes.ColorType  color,
                      PageAttributes.MediaType  media,
                      PageAttributes.OrientationRequestedType  orientationRequested,
                      PageAttributes.OriginType  origin,
                      PageAttributes.PrintQualityType  printQuality,
                      int[] printerResolution)

각 속성으로 지정된 값을 가지는 PageAttributes 인스턴스를 생성합니다.

파라미터:

color - ColorType.COLOR 또는 ColorType.MONOCHROME

media - MediaType 클래스의 하나의 정수 필드

orientationRequested - OrientationRequestedType.PORTRAIT 또는 OrientationRequestedType.LANDSCAPE

origin - OriginType.PHYSICAL 또는 OriginType.PRINTABLE

printQuality - PrintQualityType.DRAFT, PrintQualityType.NORMAL, 또는 PrintQualityType.HIGH

printerResolution - 3 요소의 정수형 배열. 최초의 요소와 2번째의 요소는 0 보다 큰 값, 3 번째의 요소는 3 또는 4가 아니면 안됩니다.

예외:

IllegalArgumentException - 상기의 조건의 1개 이상으로 위반했을 경우

메서드의 상세

clone

public Object  clone()

PageAttributes 복사본을 작성해, 리턴합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

새롭게 작성된 카피. 이 Object를 PageAttributes에 캐스트 하면 안전합니다.

관련 항목:

Cloneable

set

public void set(PageAttributes  obj)

PageAttributes 모든 속성을 obj 속성과 같은 값으로 설정합니다.

파라미터:

obj - 복제 대상의 PageAttributes

getColor

public PageAttributes.ColorType  getColor()

이러한 속성을 사용하는 페이지를 컬러로 렌더링 할까 흑백으로 렌더링 할까를 리턴합니다. 이 속성은 사용자가 선택한 값에 갱신됩니다.

반환값:

ColorType.COLOR 또는 ColorType.MONOCHROME

setColor

public void setColor(PageAttributes.ColorType  color)

이러한 속성을 사용하는 페이지를 컬러로 렌더링 할까 흑백으로 렌더링 하는지를 지정합니다. 지정하지 않는 경우는 ColorType.MONOCHROME가 됩니다.

파라미터:

color - ColorType.COLOR 또는 ColorType.MONOCHROME

예외:

IllegalArgumentException - color가 null인 경우

getMedia

public PageAttributes.MediaType  getMedia()

이러한 속성을 사용하는 페이지의 용지 사이즈를 리턴합니다. 이 속성은 사용자가 선택한 값에 갱신됩니다.

반환값:

MediaType 클래스의 하나의 정수 필드

setMedia

public void setMedia(PageAttributes.MediaType  media)

이러한 속성을 사용하는 페이지의 용지 사이즈를 지정합니다. 실제의 용지 사이즈는 출력처 프린터의 제한으로 정해집니다. 완전하게 일치하지 않는 경우는 근사값이 선택됩니다. 이 속성을 지정하지 않는 경우, 디폴트의 로케일에 대해서 디폴트의 사이즈가 지정됩니다. 미국 및 캐나다의 로케일의 디폴트 사이즈는 MediaType.NA_LETTER 입니다. 그 외 모든 로케일에서의 디폴트 사이즈는 MediaType.ISO_A4 입니다.

파라미터:

media - MediaType 클래스의 하나의 정수 필드

예외:

IllegalArgumentException - media가 null인 경우

setMediaToDefault

public void setMediaToDefault()

이러한 속성을 사용하는 페이지의 용지 사이즈를 디폴트 로케일의 디폴트 사이즈로 지정합니다. 미국 및 캐나다의 로케일의 디폴트 사이즈는 MediaType.NA_LETTER 입니다. 그 외 모든 로케일에서의 디폴트 사이즈는 MediaType.ISO_A4 입니다.

getOrientationRequested

public PageAttributes.OrientationRequestedType  getOrientationRequested()

이러한 속성을 사용하는 페이지의 용지 방향을 리턴합니다. 이 속성은 사용자가 선택한 값에 갱신됩니다.

반환값:

OrientationRequestedType.PORTRAIT 또는 OrientationRequestedType.LANDSCAPE

setOrientationRequested

public void setOrientationRequested(PageAttributes.OrientationRequestedType  orientationRequested)

이러한 속성을 사용하는 페이지의 용지 방향을 지정합니다. 프로퍼티로 지정하지 않는 경우는 OrientationRequestedType.PORTRAIT가 됩니다.

파라미터:

orientationRequested - OrientationRequestedType.PORTRAIT 또는 OrientationRequestedType.LANDSCAPE

예외:

IllegalArgumentException - orientationRequested가 null인 경우

setOrientationRequested

public void setOrientationRequested(int orientationRequested)

이러한 속성을 사용해, 페이지의 용지 방향을 지정합니다. 3을 지정하면 세로 방향, 4를 지정하면 횡방향이 됩니다. 다른 값을 지정하면 IllegalArgumentException가 발생 됩니다. 프로퍼티로 지정하지 않는 경우는 setOrientationRequested(OrientationRequestedType.PORTRAIT)가 호출됩니다.

파라미터:

orientationRequested - 3 또는 4

예외:

IllegalArgumentException - orientationRequested가 3 또는 4가 아닌 경우

setOrientationRequestedToDefault

public void setOrientationRequestedToDefault()

이러한 속성을 사용하는 페이지의 용지 방향을 디폴트로 설정합니다. 디폴트에서는 세로 방향이 됩니다.

getOrigin

public PageAttributes.OriginType  getOrigin()

이러한 속성을 사용하는 페이지의 (0, 0) 렌더링를 물리 페이지의 좌상구석으로 하는지, 인쇄 범위의 좌상구석으로 할까를 리턴합니다. 이러한 위치는 같지는 않습니다. 이 속성은 구현이나 출력처 프린터에 한 변경이나 제한을 받을 것은 없습니다.

반환값:

OriginType.PHYSICAL 또는 OriginType.PRINTABLE

setOrigin

public void setOrigin(PageAttributes.OriginType  origin)

이러한 속성을 사용하는 페이지의 (0, 0) 렌더링를 물리 페이지의 좌상구석으로 하는지, 인쇄 범위의 좌상구석으로 하는지를 지정합니다. 이러한 위치는 같지는 않습니다. 프로퍼티로 지정하지 않는 경우는 OriginType.PHYSICAL가 됩니다.

파라미터:

origin - OriginType.PHYSICAL 또는 OriginType.PRINTABLE

예외:

IllegalArgumentException - origin가 null인 경우

getPrintQuality

public PageAttributes.PrintQualityType  getPrintQuality()

이러한 속성을 사용하는 페이지의 인쇄 품질을 리턴합니다. 이 속성은 사용자가 선택한 값에 갱신됩니다.

반환값:

PrintQualityType.DRAFT, PrintQualityType.NORMAL, 또는 PrintQualityType.HIGH

setPrintQuality

public void setPrintQuality(PageAttributes.PrintQualityType  printQuality)

이러한 속성을 사용하는 페이지의 인쇄 품질을 지정합니다. 프로퍼티로 지정하지 않는 경우는 PrintQualityType.NORMAL가 됩니다.

파라미터:

printQuality - PrintQualityType.DRAFT, PrintQualityType.NORMAL, 또는 PrintQualityType.HIGH

예외:

IllegalArgumentException - printQuality가 null인 경우

setPrintQuality

public void setPrintQuality(int printQuality)

이러한 속성을 사용하는 페이지의 인쇄 품질을 지정합니다. 3을 지정하면 드래프트, 4를 지정하면 보통, 5를 지정하면 고품질이 됩니다. 다른 값을 지정하면 IllegalArgumentException가 발생 됩니다. 프로퍼티로 지정하지 않는 경우는 setPrintQuality(PrintQualityType.NORMAL)가 호출됩니다.

파라미터:

printQuality - 3, 4 또는 5

예외:

IllegalArgumentException - printQuality가 3, 4 또는 5가 아닌 경우

setPrintQualityToDefault

public void setPrintQualityToDefault()

이러한 속성을 사용하는 페이지의 인쇄 품질을 디폴트로 설정합니다. 디폴트에서는 보통 품질이 됩니다.

getPrinterResolution

public int[] getPrinterResolution()

이러한 속성을 사용하는 페이지의 인쇄 해상도를 리턴합니다. 배열의 인덱스 0 은 전후 보내는 방법향의 해상도를 지정합니다 (일반적으로 수평 방향의 해상도). 인덱스 1 배열은 보내는 방법향의 해상도를 지정합니다 (일반적으로 수직 방향의 해상도). 인덱스 2 배열은 해상도를 1 인치 당의 닷수로 하는지, 1 센치 당의 닷수로 하는지를 지정합니다. 3 은 1 인치 당의 닷수, 4는 1 센치 당의 닷수가 됩니다.

반환값:

3 요소의 정수형 배열. 최초의 요소와 2번째의 요소는 0 보다 큰 값, 3 번째의 요소는 3 또는 4가 아니면 안됩니다.

setPrinterResolution

public void setPrinterResolution(int[] printerResolution)

이러한 속성을 사용하는 페이지의 인쇄 해상도를 지정합니다. 실제의 해상도는 구현이나 출력처 프린터의 제한에 의해 정해집니다. 배열의 인덱스 0 은 전후 보내는 방법향의 해상도를 지정합니다 (일반적으로 수평 방향의 해상도). 인덱스 1 배열에서는 보내는 방법향의 해상도를 지정합니다 (일반적으로 수직 방향의 해상도). 인덱스 2 배열에서는 해상도를 1 인치 당의 닷수로 하는지, 1 센치 당의 닷수로 하는지를 지정합니다. 3 은 1 인치 당의 닷수, 4는 1 센치 당의 닷수가 됩니다. 1.1 인쇄 구현 (Toolkit.getPrintJob)에서는 보내는 방법향의 해상도와 전후송의 해상도는 같은 필요가 있습니다. 프로퍼티로 지정하지 않는 경우는 setPrinterResolution(72)가 호출됩니다.

파라미터:

printerResolution - 3 요소의 정수형 배열. 최초의 요소와 2번째의 요소는 0 보다 큰 값, 3 번째의 요소는 3 또는 4가 아니면 안됩니다.

예외:

IllegalArgumentException - 상기의 조건의 1개 이상으로 위반했을 경우

setPrinterResolution

public void setPrinterResolution(int printerResolution)

이러한 속성을 사용하는 페이지의 전후 보내 또는 송의 인쇄 해상도를 1 인치 당의 닷수로 지정합니다. 양쪽 모두의 해상도에는 같은 값이 사용됩니다. 실제의 해상도는 구현이나 출력처 프린터의 제한에 의해 정해집니다. 프로퍼티로 지정하지 않는 경우는 72가 지정됩니다.

파라미터:

printerResolution - 0 보다 큰 정수값

예외:

IllegalArgumentException - printerResolution가 0 아래의 경우

setPrinterResolutionToDefault

public void setPrinterResolutionToDefault()

이러한 속성을 사용하는 페이지의 프린터 해상도를 디폴트로 설정합니다. 디폴트는 보내 및 전후송의 해상도 모두 72 dpi 입니다.

equals

public boolean equals(Object  obj)

2개의 PageAttributes가 같은지 어떤지를 판정합니다.

서로의 속성이 모두 같은 경우에만, 2개의 PageAttributes 은 동일해집니다. 필드가 일의의 같은 열거 객체를 참조하고 있는 경우에만, 열거형의 속성이 동일해집니다. 즉, 별명의 미디어는 바탕으로 되는 일의의 미디어와 같다라고 말하는 것입니다. 보내 해상도, 전후 보내 해상도 및 단위가 같은 경우에만, 프린터의 해상도가 동일해집니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 같은지 어떤지가 판정되는 객체

반환값:

상기의 조건에의해 obj가 이 PageAttribute와 동일한지 어떤지

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 PageAttributes 해시 코드값을 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

해시 코드

관련 항목:

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

toString

public String  toString()

이 PageAttributes 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

캐릭터 라인 표현