java.awt
클래스 PageAttributes

java.lang.Object 
  java.awt.PageAttributes

모든 구현된 인터페이스:

Cloneable

public final class PageAttributes
extends Object 
implements Cloneable 

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

이 클래스의 인스턴스는, 색 상태, 용지 사이즈 (미디어의 종류), 용지 방향, 논리적인 원점, 인쇄 품질, 및 인스턴스를 사용하는 각 페이지의 해상도를 제어합니다. 속성명은, 가능한 경우 Internet Printing Protocol (IPP) 1.1 에 준거하고 있습니다. 속성치는 가능한 경우, 부분적으로 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 메소드를 가지고 있습니다. 디폴트 값의 필드는 제공되고 있지 않습니다.

도입된 버젼:

1.3

상자의 클래스의 개요

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 () 이러한 속성을 사용하는 페이지를 칼라로 draw 할까 흑백으로 draw 할까를 돌려줍니다.
PageAttributes.MediaType	getMedia () 이러한 속성을 사용하는 페이지의 용지 사이즈를 돌려줍니다.
PageAttributes.OrientationRequestedType	getOrientationRequested () 이러한 속성을 사용하는 페이지의 용지 방향을 돌려줍니다.
PageAttributes.OriginType	getOrigin () 이러한 속성을 사용하는 페이지의 (0, 0) draw를 물리 페이지의 좌상구석으로 하는지, 인쇄 범위의 좌상구석으로 할까를 돌려줍니다.
int[]	getPrinterResolution () 이러한 속성을 사용하는 페이지의 인쇄 해상도를 돌려줍니다.
PageAttributes.PrintQualityType	getPrintQuality () 이러한 속성을 사용하는 페이지의 인쇄 품질을 돌려줍니다.
int	hashCode () 이 PageAttributes 의 해시 코드값를 돌려줍니다.
void	set (PageAttributes obj) PageAttributes 의 모든 속성을 obj 의 속성과 같은 값으로 설정합니다.
void	setColor (PageAttributes.ColorType color) 이러한 속성을 사용하는 페이지를 칼라로 draw 할까 흑백으로 draw 하는지를 지정합니다.
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) draw를 물리 페이지의 좌상구석으로 하는지, 인쇄 범위의 좌상구석으로 하는지를 지정합니다.
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 클래스의 1 개의 정수 필드

orientationRequested - OrientationRequestedType.PORTRAIT 또는 OrientationRequestedType.LANDSCAPE

origin - OriginType.PHYSICAL 또는 OriginType.PRINTABLE

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

printerResolution - 3 요소의 정수형 배열. 최초의 요소는 0 보다 크지 않으면 안 된다. 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()

이러한 속성을 사용하는 페이지를 칼라로 draw 할까 흑백으로 draw 할까를 돌려줍니다. 이 속성은, 사용자가 선택한 값에 갱신됩니다.

반환값:

ColorType.COLOR 또는 ColorType.MONOCHROME

setColor

public void setColor(PageAttributes.ColorType  color)

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

파라미터:

color - ColorType.COLOR 또는 ColorType.MONOCHROME

예외:

IllegalArgumentException - color 가 null 의 경우

getMedia

public PageAttributes.MediaType  getMedia()

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

반환값:

MediaType 클래스의 1 개의 정수 필드

setMedia

public void setMedia(PageAttributes.MediaType  media)

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

파라미터:

media - MediaType 클래스의 1 개의 정수 필드

예외:

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 가 throw 됩니다. 프로퍼티으로 지정하지 않는 경우는, setOrientationRequested(OrientationRequestedType.PORTRAIT)가 불려 갑니다.

파라미터:

orientationRequested - 3 또는 4

예외:

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

setOrientationRequestedToDefault

public void setOrientationRequestedToDefault()

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

getOrigin

public PageAttributes.OriginType  getOrigin()

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

반환값:

OriginType.PHYSICAL 또는 OriginType.PRINTABLE

setOrigin

public void setOrigin(PageAttributes.OriginType  origin)

이러한 속성을 사용하는 페이지의 (0, 0) draw를 물리 페이지의 좌상구석으로 하는지, 인쇄 범위의 좌상구석으로 하는지를 지정합니다. 이러한 위치는 같지는 않습니다. 프로퍼티으로 지정하지 않는 경우는 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 가 throw 됩니다. 프로퍼티으로 지정하지 않는 경우는, setPrintQuality(PrintQualityType.NORMAL)가 불려 갑니다.

파라미터:

printQuality - 3,4 또는 5

예외:

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

setPrintQualityToDefault

public void setPrintQualityToDefault()

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

getPrinterResolution

public int[] getPrinterResolution()

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

반환값:

3 요소의 정수형 배열. 최초의 요소는 0 보다 크지 않으면 안 된다. 2 번째의 요소는 0 보다 크지 않으면 안 된다. 3 번째의 요소는 3 또는 4 가 아니면 안된다

setPrinterResolution

public void setPrinterResolution(int[] printerResolution)

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

파라미터:

printerResolution - 3 요소의 정수형 배열. 최초의 요소는 0 보다 크지 않으면 안 된다. 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

반환값:

캐릭터 라인 표현