java.awt.print
인터페이스 Printable

public interface Printable

Printable인터페이스는 페이지를 렌더링 하는 인쇄 시스템에 의해 호출되는 현재의 페이지페인타의 print 메서드에 의해 구현됩니다. Pageable를 작성하는 경우는 PageFormat 인스턴스와 이 인터페이스를 구현하는 인스턴스의 페어를 사용해 각 페이지를 기술합니다. Printable을 구현하는 인스턴스는 페이지의 그래픽을 인쇄하기 위해서 호출합니다.

PrinterJob에 Printable(..)를 설정할 수 있습니다. 그 후, 클라이언트가 PrinterJob.print(..)를 호출해, 인쇄를 트리거 하면, 모든 페이지가 인쇄될 때까지, 제어가 인쇄 시스템에게 건네집니다.

이것은 문서의 모든 페이지가 인쇄될 때까지, Printable.print(..)를 호출하는 것에 의해 실행합니다. Printable인터페이스를 사용하면, 인쇄 시스템에 의해 요구되면 언제라도, 페이지의 내용이 렌더링 됩니다.

Printable.print(..) 파라미터에는 페이지에 거두는 내용의 계산에 필요한, 페이지의 인쇄 가능 영역을 나타내는 PageFormat 및 요구된 페이지의 0을 기준으로 한 인쇄 스트림 인덱스를 지정하는 페이지 인덱스가 있습니다.

올바르게 인쇄하기 위해, 다음의 점에 주의할 필요가 있습니다.

• 인쇄 시스템이 여러 차례 페이지를 요구하는 일이 있습니다. 그때마다 동일한 PageFormat 파라미터가 지정됩니다.
• 인쇄 시스템은 단조롭게 증가해 나가는 페이지 인덱스를 사용해 Printable.print(..)를 호출합니다. 다만, 상기와 같이 Printable은 페이지 범위가 클라이언트, 또는 인쇄 다이얼로그를 통해서 사용자에 의해 가리키는 경우에 페이지 인덱스의 복수의 호출을 예상해, 페이지 인덱스가 스킵 되고 있을 가능성이 있는 것을 예상할 필요가 있습니다.
• 복수의 조합 복제의 문서가 요구되어 프린터가 네티브에 이것을 지원할 수 없는 경우, 문서는 여러 차례 렌더링 되는 일이 있습니다. 최소의 인쇄 스트림 페이지 인덱스 페이지로부터 각 복제의 인쇄가 개시됩니다.
• 복수의 조합 복제의 문서 전체의 재렌더링를 제외해, 페이지 인덱스순서의 증가는 클라이언트가 페이지 단락 위치를 계산할 필요가 있는 경우에 페이지 N가 요구되었을 경우, N 미만의 페이지에 관한 모든 상태를 파기해, 페이지 N 상태를 최신으로 해도 상관없는 것을의미합니다. 「상태」는 보통, 페이지의 개시에 대응하는 문서내의 계산된 위치에 지나지 않습니다.
• 인쇄 시스템에 의해 불려 갔을 경우, Printable은 지정된 PageFormat 파라미터와 페이지 인덱스를 검사해, 받을 필요가 있습니다. 이것은 올바르게 인쇄하기 위해서 중요하고, 클라이언트가 지정된 페이지에 속하는 내용을 추적하는 역할을 가지는 것을 암묵적으로 가리키고 있습니다.
• 클라이언트가 지정한 Pageable로 부터 Printable을 취득했을 경우, 클라이언트는 페이지 인덱스 마다 다른 PageFormats를 지정할 수 있습니다 . 페이지 단락의 계산에서는 이것을 고려할 필요가 있습니다.

관련 항목:

Pageable, PageFormat, PrinterJob

필드 개요

static int	NO_SUCH_PAGE pageIndex가 너무 크기 때문에 요구된 페이지가 존재하지 않는 것을 통지하기 위해서 print 메서드에 의해 리턴됩니다 .
static int	PAGE_EXISTS 렌더링 된 요구 페이지를 통지하기 위해서 print(Graphics, PageFormat, int) 메서드에 의해 리턴됩니다 .

메서드 개요

int	print (Graphics graphics, PageFormat pageFormat, int pageIndex) 지정된 인덱스에 있는 페이지를, 지정된 서식에서 지정된 Graphics 컨텍스트에 인쇄합니다.

필드의 상세

PAGE_EXISTS

static final int PAGE_EXISTS

렌더링 된 요구 페이지를 통지하기 위해서 print(Graphics, PageFormat, int) 메서드에 의해 리턴됩니다 .

관련 항목:

정수 필드값

NO_SUCH_PAGE

static final int NO_SUCH_PAGE

pageIndex가 너무 크기 때문에 요구된 페이지가 존재하지 않는 것을 통지하기 위해서 print 메서드에 의해 리턴됩니다 .

관련 항목:

정수 필드값

메서드의 상세

print

int print(Graphics  graphics,
          PageFormat  pageFormat,
          int pageIndex)
          throws PrinterException 

지정된 인덱스에 있는 페이지를, 지정된 서식에서 지정된 Graphics 컨텍스트에 인쇄합니다. PrinterJob는 Printable인터페이스를 호출해, graphics로 지정된 컨텍스트에 페이지가 렌더링 되도록 요구합니다. 렌더링 되는 페이지의 서식은, pageFormat로 지정합니다. pageIndex에 서는 렌더링 되는 페이지의 제로로부터 시작되는 인덱스를 지정합니다. 지정된 페이지가 존재하지 않는 경우, 이 메서드는 NO_SUCH_PAGE를 리턴합니다. 존재하는 경우는 PAGE_EXISTS가 리턴됩니다 . Graphics 클래스 또는 서브 클래스는 PrinterGraphics 인터페이스를 구현해 추가 정보를 제공합니다. Printable 객체가 인쇄를 중단했을 경우는 PrinterException을 발생시킵니다.

파라미터:

graphics - 페이지가 렌더링 되는 컨텍스트

pageFormat - 렌더링 되는 페이지의 사이즈와 인쇄 방향

pageIndex - 렌더링 되는 페이지의 제로로부터 시작되는 인덱스

반환값:

페이지의 렌더링에 성공했을 경우는 PAGE_EXISTS, pageIndex로 지정된 페이지가 존재하지 않는 경우는 NO_SUCH_PAGE

예외:

PrinterException - 인쇄가 중단되었을 경우