java.awt.print
클래스 PrinterJob

java.lang.Object 
  |
  +--java.awt.print.PrinterJob

public abstract class PrinterJob

extends Object

PrinterJob 클래스는 인쇄를 제어하는 주요한 클래스입니다. 어플리케이션은 이 클래스의 메소드를 호출해, 작업을 설정해, 필요에 따라서 인쇄의 다이얼로그를 호출해, 그 후 작업의 페이지를 인쇄합니다.

생성자의 개요

PrinterJob ()
PrinterJob 오브젝트의 작성에는 static 메소드의 getPrinterJob 를 사용해 주세요.

메소드의 개요

abstract void	cancel () 실행중의 인쇄 작업을 취소합니다.
PageFormat	defaultPage () 새로운 PageFormat 의 인스턴스를 생성해, 디폴트의 사이즈와 인쇄 방향으로 설정합니다.
abstract PageFormat	defaultPage (PageFormat page) PageFormat 인수를 복제해, 그 복제를 변경해 디폴트의 페이지 사이즈와 인쇄 방향을 기술합니다.
abstract int	getCopies () 인쇄하는 부수를 돌려줍니다.
abstract String	getJobName () 인쇄하는 문서의 이름을 돌려줍니다.
static PrinterJob	getPrinterJob () 초기 상태로 디폴트 프린터에 관련지을 수 있었던 PrinterJob 를 작성해 돌려줍니다.
PrintService	getPrintService () 이 인쇄 작업의 서비스 (프린터)를 돌려줍니다.
abstract String	getUserName () 인쇄를 실시하는 유저의 이름을 돌려줍니다.
abstract boolean	isCancelled () 인쇄 작업이 실행중이며, 다음의 기회에 삭제될 예정의 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.
static PrintService []	lookupPrintServices () 2D 인쇄 서비스를 검색하는 간이 메소드입니다.
static StreamPrintServiceFactory []	lookupStreamPrintServices (String mimeType) 출하시에 배치되는 인쇄 서비스 스트림용의 간이 메소드입니다.
abstract PageFormat	pageDialog (PageFormat page) PageFormat 의 인스턴스를 변경하기 위한 다이얼로그를 표시합니다.
PageFormat	pageDialog (PrintRequestAttributeSet attributes) 공통 플랫폼의 페이지 설정 다이얼로그를 표시하는 간이 메소드입니다.
abstract void	print () 페이지세트를 인쇄합니다.
void	print (PrintRequestAttributeSet attributes) 속성 세트의 설정을 사용해 페이지세트를 인쇄합니다.
abstract boolean	printDialog () 유저에 대해서, 인쇄 작업의 프로퍼티 변경 다이얼로그를 표시합니다.
boolean	printDialog (PrintRequestAttributeSet attributes) 공통 플랫폼의 모든 서비스에 대한 인쇄 다이얼로그를 표시하는 간이 메소드입니다.
abstract void	setCopies (int copies) 인쇄하는 부수를 설정합니다.
abstract void	setJobName (String jobName) 인쇄하는 문서의 이름을 설정합니다.
abstract void	setPageable (Pageable document) document 에 대해서, 페이지수나,Pageable 의 인스턴스 (document)에 보관 유지되고 있는 각 페이지의 PageFormat 및 Printable 를 문의합니다.
abstract void	setPrintable (Printable painter) 페이지를 표현 하기 위해서 painter 를 호출합니다.
abstract void	setPrintable (Printable painter, PageFormat format) 지정된 format 로 페이지를 표현 하기 위해서 painter 를 호출합니다.
void	setPrintService (PrintService service) 이 PrinterJob 를 새로운 PrintService 에 관련짓습니다.
abstract PageFormat	validatePage (PageFormat page) 이 PrinterJob 의 현재의 프린터와 호환성이 있게 조정된 설정을 가지는 page 의 복제를 돌려줍니다.

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

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자의 상세

PrinterJob

public PrinterJob()

PrinterJob 오브젝트의 작성에는 static 메소드의 getPrinterJob 를 사용해 주세요.

메소드의 상세

getPrinterJob

public static PrinterJob  getPrinterJob()

초기 상태로 디폴트 프린터에 관련지을 수 있었던 PrinterJob 를 작성해 돌려줍니다. 시스템으로 프린터를 사용할 수 없는 경우에서도, PrinterJob 가 이 메소드로부터 돌려주어집니다. 다만, getPrintService() 는 null 를 돌려주어, 이 PrinterJob 를 가지는 print 의 호출이 예외를 생성하는 경우가 있습니다. PrinterJob 를 작성하기 전에 적절한 프린터가 있을지 어떨지를 판별할 필요가 있는 어플리케이션은 lookupPrintServices 로부터 돌려주어진 배열이 하늘이 아닌 것을 확인할 필요가 있습니다.

반환값:

새로운 PrinterJob

lookupPrintServices

public static PrintService [] lookupPrintServices()

2D 인쇄 서비스를 검색하는 간이 메소드입니다. 이 메소드로부터 돌려주어진 서비스는 인쇄 서비스를 서포트하는 PrinterJob 에 인스톨 할 수 있습니다. 이 메소드의 호출은 PrintServiceLookup.lookupPrintServices() 의 호출해, 및 Pageable DocFlavor 의 지정과 동등합니다.

반환값:

2D 인쇄 서비스의 하늘의 가능성이 있는 배열

도입된 버젼:

1.4

lookupStreamPrintServices

public static StreamPrintServiceFactory [] lookupStreamPrintServices(String  mimeType)

출하시에 배치되는 인쇄 서비스 스트림용의 간이 메소드입니다. 이것은 2D 그래픽스의 표현가 가능합니다. 사용예는 다음과 같습니다.

 FileOutputStream outstream;
 StreamPrintService psPrinter;
 String psMimeType = "application/postscript";

 StreamPrintServiceFactory[] factories =
     PrinterJob.lookupStreamPrintServices(psMimeType);
 if (factories.length > 0) {
     try {
         outstream = new File("out.ps");
         psPrinter =  factories[0]. getPrintService(fos);
         // psPrinter can now be set as the service on a PrinterJob 
     } catch (FileNotFoundException e) {
     }
 }            
 

이 메소드로부터 돌려주어진 서비스는 인쇄 서비스를 서포트하는 PrinterJob 에 인스톨 할 수 있습니다. 이 메소드의 호출은 StreamPrintServiceFactory.lookupStreamPrintServiceFactories() 의 호출 및 Pageable DocFlavor 의 지정과 동등합니다.

파라미터:

mimeType - 요구된 출력 형식, 또는 null (임의의 형식을 의미)

반환값:

출하시의 2D 인쇄 서비스 스트림이 하늘의 가능성이 있는 배열

도입된 버젼:

1.4

getPrintService

public PrintService  getPrintService()

이 인쇄 작업의 서비스 (프린터)를 돌려줍니다. 인쇄 서비스를 서포트하지 않는 이 클래스의 구현은 null 를 돌려줍니다.

반환값:

이 인쇄 작업의 서비스

도입된 버젼:

1.4

관련 항목:

setPrintService(PrintService)

setPrintService

public void setPrintService(PrintService  service)
                     throws PrinterException 

이 PrinterJob 를 새로운 PrintService 에 관련짓습니다. 이 메소드는 Print Service 의 지정을 서포트하는 서브 클래스에 오버라이드(override) 됩니다. 지정된 서비스가, 2D 인쇄의 서포트에 필요한 Pageable 및 Printable 인터페이스를 서포트할 수 없는 경우는 PrinterException 를 슬로우 합니다.

파라미터:

service - 2D 인쇄를 서포트하는 인쇄 서비스

예외:

PrinterException - 지정된 서비스가 2D 인쇄를 서포트하지 않는 경우, 또는 이 PrinterJob 클래스가 2D 인쇄 서비스의 설정을 서포트하지 않는 경우, 이 양자 이외의 경우로 지정된 서비스가 유효한 인쇄 서비스가 아닌 경우

도입된 버젼:

1.4

관련 항목:

getPrintService()

setPrintable

public abstract void setPrintable(Printable  painter)

페이지를 표현 하기 위해서 painter 를 호출합니다. 이 PrinterJob 에 의해 인쇄되는 문서내의 페이지는 painter 로 지정된 Printable 오브젝트에 의해 표현 됩니다. 각 페이지의 PageFormat 는 디폴트의 페이지 서식이 됩니다.

파라미터:

painter - 문서의 각 페이지를 표현 하는 Printable

setPrintable

public abstract void setPrintable(Printable  painter,
                                  PageFormat  format)

지정된 format 로 페이지를 표현 하기 위해서 painter 를 호출합니다. 이 PrinterJob 에 의해 인쇄되는 문서내의 페이지는 painter 로 지정된 Printable 오브젝트에 의해 표현 됩니다. 각 페이지의 PageFormat 는 format 로 지정된 페이지 서식이 됩니다.

파라미터:

painter - 문서의 각 페이지를 표현 하기 위해서 호출하는 Printable

format - 인쇄되는 각 페이지의 사이즈와 인쇄 방향

setPageable

public abstract void setPageable(Pageable  document)
                          throws NullPointerException 

document 에 대해서, 페이지수나,Pageable 의 인스턴스 (document)에 보관 유지되고 있는 각 페이지의 PageFormat 및 Printable 를 문의합니다.

파라미터:

document - 인쇄되는 페이지. null 를 건네줄 수 없다

예외:

NullPointerException - 건네받은 Pageable 가 null 인 경우

관련 항목:

PageFormat , Printable

printDialog

public abstract boolean printDialog()
                             throws HeadlessException 

유저에 대해서, 인쇄 작업의 프로퍼티 변경 다이얼로그를 표시합니다. 이 메소드는 네이티브인 인쇄 서비스가 선택되고 있는 경우는 네이티브 다이얼로그를 표시해, 유저의 프린터의 선택은 이러한 네이티브인 인쇄 서비스에 제한됩니다. 공통 플랫폼의 네이티브 인쇄 서비스를 포함한 모든 서비스에 대한 인쇄 다이얼로그를 표시하려면 , 대신에 printDialog(PrintRequestAttributeSet) 를 사용합니다.

PrintService 의 인쇄 다이얼로그를 사용할 수 있는 PrinterJob 의 구현에 의해, 이 PrinterJob 에 대한 PrintService 가 갱신되고 유저가 선택하는 서비스가 반영됩니다.

반환값:

유저가 다이얼로그를 취소하지 않는 경우는 true, 그렇지 않은 경우는 false

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

printDialog

public boolean printDialog(PrintRequestAttributeSet  attributes)
                    throws HeadlessException 

공통 플랫폼의 모든 서비스에 대한 인쇄 다이얼로그를 표시하는 간이 메소드입니다. Pageable 인터페이스를 사용해 2D 그래픽스의 인쇄가 가능합니다. 인쇄 다이얼로그가 초기 상태로 표시되었을 때에 선택한 프린터는 이 인쇄 작업에 현재 접속되고 있는 인쇄 서비스를 반영합니다. 유저가 인쇄 서비스를 변경하는 경우, 유저가 인쇄 다이얼로그를 취소하지 않는 한, PrinterJob 가 갱신되어 변경을 반영합니다. 유저는 출력처 프린터의 선택과 함께, 다양한 인쇄 요구 속성의 값을 선택할 수도 있습니다.

속성 파라미터 on input 는 어플리케이션이 요구하는 유저 다이얼로그에서의 초기 선택을 반영합니다. 속성이 지정되지 않는 경우는 인쇄 서비스의 디폴트의 속성을 사용해 표시됩니다. 속성 파라미터 on return 는 유저의 선택을 반영합니다. 선택은 현재 선택되고 있는 인쇄 서비스가 서포트하는 값과 일치하도록(듯이) 갱신됩니다.

유저가 스크롤 해 새로운 인쇄 서비스를 선택하면(자), 값의 카피는 유저의 임의의 변경과 함께 직전의 서비스의 설정에 근거해 행해집니다. 이 값의 카피는 클라이언트가 지정한 원의 설정에 근거해 행해지는 것은 아닙니다.

프린터의 선택의 예외로서 PrinterJob 상태가 유저의 변경을 반영해 갱신되지 않는 경우가 있습니다. 프린터의 선택에 의해 인쇄 작업을 갱신할 수 있게 하려면 ,print(PrintRequestAttributeSet) 메소드의 호출로 속성을 지정할 필요가 있습니다. Pageable 인터페이스를 사용하고 있는 경우, 유저가 선택한 미디어를 사용할 예정의 클라이언트는 유저의 선택으로부터 파생하는 PageFormat 를 작성할 필요가 있습니다. 유저가 인쇄 다이얼로그를 취소했을 경우는 속성은 유저가 간 변경을 반영하지 않습니다.

파라미터:

attributes - on input 는 속성이 제공하는 어플리케이션이다. on output 는 유저의 선택에 의해 내용이 갱신된다. 이 파라미터는 null 는 되지 않는다

반환값:

유저가 다이얼로그를 취소하지 않는 경우는 true, 그렇지 않은 경우는 false

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

NullPointerException - attributes 파라미터가 null 의 경우

도입된 버젼:

1.4

관련 항목:

GraphicsEnvironment.isHeadless()

pageDialog

public abstract PageFormat  pageDialog(PageFormat  page)
                               throws HeadlessException 

PageFormat 의 인스턴스를 변경하기 위한 다이얼로그를 표시합니다. 인수 page 는 페이지 설정 다이얼로그의 컨트롤을 초기화하기 위해서 사용됩니다. 유저가 다이얼로그를 취소하면(자), 이 메소드는 원의 page 오브젝트를 변경하지 않고 돌려줍니다. 유저가 다이얼로그를 이해하면(자), 이 메소드는 변경 내용을 나타내는 새로운 PageFormat 를 돌려줍니다. 어느 쪽의 경우에도, 원의 page 오브젝트는 변경되지 않습니다.

파라미터:

page - 변경을 위해서(때문에) 유저에 대해서 표시되는 디폴트의 PageFormat

반환값:

다이얼로그가 삭제되었을 경우는 원의 page 오브젝트. 다이얼로그가 이해되었을 경우는 유저가 가리킨 서식을 가지는 새로운 PageFormat 오브젝트

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

도입된 버젼:

1.2

관련 항목:

GraphicsEnvironment.isHeadless()

pageDialog

public PageFormat  pageDialog(PrintRequestAttributeSet  attributes)
                      throws HeadlessException 

공통 플랫폼의 페이지 설정 다이얼로그를 표시하는 간이 메소드입니다. 유효한 선택은 이 PrinterJob 에 현재 설정되어 있는 인쇄 작업을 반영합니다.

속성 파라미터 on input 는 클라이언트가 요구하는 유저 다이얼로그에서의 초기 선택을 반영합니다. 속성이 지정되지 않는 경우는 인쇄 서비스의 디폴트의 속성을 사용해 표시됩니다. 속성 파라미터 on return 는 유저의 선택을 반영합니다. 선택은 현재 선택되고 있는 인쇄 서비스가 서포트하는 값과 일치하도록(듯이) 갱신됩니다.

반환값은 PrintRequestAttributeSet 에서의 선택과 동등의 PageFormat 입니다. 유저가 다이얼로그를 취소했을 경우, 속성은 유저가 간 변경을 반영하지 않습니다. 반환값은 null 입니다.

파라미터:

attributes - on input 는 속성이 제공하는 어플리케이션이다. on output 는 유저의 선택에 의해 내용이 갱신된다. 이 파라미터는 null 는 되지 않는다

반환값:

유저가 다이얼로그를 취소하지 않는 경우는 페이지 서식, 그렇지 않은 경우는 null

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

NullPointerException - attributes 파라미터가 null 의 경우

도입된 버젼:

1.4

관련 항목:

GraphicsEnvironment.isHeadless()

defaultPage

public abstract PageFormat  defaultPage(PageFormat  page)

PageFormat 인수를 복제해, 그 복제를 변경해 디폴트의 페이지 사이즈와 인쇄 방향을 기술합니다.

파라미터:

page - 복제 및 변경되는 PageFormat

반환값:

디폴트의 PageFormat 를 기술하기 위해서 변경된 page 의 복제

defaultPage

public PageFormat  defaultPage()

새로운 PageFormat 의 인스턴스를 생성해, 디폴트의 사이즈와 인쇄 방향으로 설정합니다.

반환값:

디폴트의 사이즈와 인쇄 방향으로 설정된 PageFormat

validatePage

public abstract PageFormat  validatePage(PageFormat  page)

이 PrinterJob 의 현재의 프린터와 호환성이 있게 조정된 설정을 가지는 page 의 복제를 돌려줍니다. 예를 들어, 돌려주어진 PageFormat 는 현재의 프린터가 사용하고 있는 용지의 물리적 영역내에 수습되도록(듯이) 조정된 이메징 가능 area를 가질 수가 있습니다.

파라미터:

page - 복제되어 그 설정이 현재의 프린터와 호환성을 가지도록(듯이) 변경되는 PageFormat

반환값:

Page 로부터 복제되어 이 PrinterJob 에 맞추어 설정이 변경되는 PageFormat

print

public abstract void print()
                    throws PrinterException 

페이지세트를 인쇄합니다.

예외:

PrinterException - 인쇄 시스템의 에러가 원인으로 작업이 정지했을 경우

관련 항목:

Book , Pageable , Printable

print

public void print(PrintRequestAttributeSet  attributes)
           throws PrinterException 

속성 세트의 설정을 사용해 페이지세트를 인쇄합니다. 디폴트의 구현은 속성 세트를 무시합니다.

일부의 속성은 같은 메소드의 호출에 의해 직접 PrinterJob 로 설정되는 경우가 있습니다. 이 메소드의 호출의 예에는 copies: setcopies(int), job name: setJobName(String), 및 PageFormat 오브젝트의 지정에 관계없이 미디어의 사이즈와 인쇄 방향을 지정하는 경우가 있습니다.

서포트되는 속성치가 이 속성 세트로 지정되고 있는 경우는 이 print() 오퍼레이션의 경우만 API 설정보다 우선됩니다. 다음에 말하는 동작은 PageFormat 에 대해서 지정됩니다. 클라이언트가 Printable 인터페이스를 사용하고 있는 경우, 이 메소드에 대한 attributes 파라미터는 미디어 사이즈, 인쇄 방향, 및 이메징 가능 area를 지정하는 속성이 검사되어 이것들은 Printable 오브젝트의 print() 메소드에게 건네지는 새로운 PageFormat 를 구축하기 위해서 사용됩니다. Pageable 인터페이스를 사용하는 클라이언트의 경우, PageFormat 는 항상 이 인터페이스에 의해 1 페이지 마다 제공됩니다.

이러한 동작에 의해, 어플리케이션은 printDialog(PrintRequestAttributeSet attributes 로부터 돌려주어지는 유저 설정을, 직접 이 print() 메소드에 건네줄 수 있게 됩니다.

파라미터:

attributes - 작업의 속성세트

예외:

PrinterException - 인쇄 시스템의 에러가 원인으로 작업이 정지했을 경우

관련 항목:

Book , Pageable , Printable

setCopies

public abstract void setCopies(int copies)

인쇄하는 부수를 설정합니다.

파라미터:

copies - 인쇄하는 부수

관련 항목:

getCopies()

getCopies

public abstract int getCopies()

인쇄하는 부수를 돌려줍니다.

반환값:

인쇄하는 부수

관련 항목:

setCopies(int)

getUserName

public abstract String  getUserName()

인쇄를 실시하는 유저의 이름을 돌려줍니다.

반환값:

인쇄를 실시하는 유저의 이름

setJobName

public abstract void setJobName(String  jobName)

인쇄하는 문서의 이름을 설정합니다. 문서의 이름에 null 를 지정할 수 없습니다.

파라미터:

jobName - 인쇄하는 문서의 이름

관련 항목:

getJobName()

getJobName

public abstract String  getJobName()

인쇄하는 문서의 이름을 돌려줍니다.

반환값:

인쇄하는 문서의 이름

관련 항목:

setJobName(java.lang.String)

cancel

public abstract void cancel()

실행중의 인쇄 작업을 취소합니다. print 가 불려 가고 있는 경우에, 아직 복귀하고 있지 않는 상태 때는 이 메소드는 작업을 다음의 기회에 취소하도록(듯이) 통지합니다. 실행중의 인쇄 작업이 없는 경우에는 아무것도 실시하지 않습니다.

isCancelled

public abstract boolean isCancelled()

인쇄 작업이 실행중이며, 다음의 기회에 삭제될 예정의 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.

반환값:

실행중의 작업이 삭제될 예정의 경우는 true, 그렇지 않은 경우는 false