java.awt.print
인터페이스 Printable

public interface Printable

Printable 인터페이스는, 페이지를 draw 하는 인쇄 시스템에 의해 불려 가는, 현재의 페이지페인타의 print 메소드에 의해 구현됩니다. Pageable 를 작성하는 경우는,PageFormat 의 인스턴스와 이 인터페이스를 구현하는 인스턴스의 페어를 사용해 각 페이지를 기술합니다. Printable 를 구현하는 인스턴스는, 페이지의 그래픽을 인쇄하기 위해서 불려 갑니다.

PrinterJob 에 Printable(..) (을)를 설정할 수 있습니다. 그 후, 클라이언트가 PrinterJob.print(..) (을)를 호출해 인쇄를 트리거하면(자),

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

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

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

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

관련 항목:

Pageable , PageFormat , PrinterJob

필드의 개요

static int	NO_SUCH_PAGE pageIndex 가 너무 크기 (위해)때문에 요구된 페이지가 존재하지 않는 것을 통지하기 위해서 print 메소드에 의해 돌려주어집니다.
static int	PAGE_EXISTS draw 된 요구 페이지를 통지하기 위해서 print(Graphics, PageFormat, int) 메소드에 의해 돌려주어집니다.

메소드의 개요

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

필드의 상세

PAGE_EXISTS

static final int PAGE_EXISTS

draw 된 요구 페이지를 통지하기 위해서 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 로 지정된 문맥에 페이지가 draw 되도록(듯이) 요구합니다. draw 되는 페이지의 서식은,pageFormat 로 지정합니다. pageIndex 에서는, draw 되는 페이지의 제로로부터 시작되는 인덱스를 지정합니다. 지정된 페이지가 존재하지 않는 경우, 이 메소드는 NO_SUCH_PAGE 를 돌려줍니다. 존재하는 경우는, PAGE_EXISTS 가 돌려주어집니다. Graphics 클래스 또는 서브 클래스는,PrinterGraphics 인터페이스를 구현해 추가 정보를 제공합니다. Printable 객체가 인쇄를 중단했을 경우는,PrinterException 가 throw 됩니다.

파라미터:

graphics - 페이지가 draw 되는 문맥

pageFormat - draw 되는 페이지의 사이즈와 인쇄 방향

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

반환값:

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

예외:

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