java.awt.print

Interface Printable

public interface Printable

的 Printable接口由当前页的画家的 print方法实现，这是由印刷系统称为渲染页面。建立一个 Pageable时， PageFormat实例和实例的实现此接口对用于描述每一页。该实例实现 Printable叫做打印页面的图形。

一个Printable(..)可设置在PrinterJob。当客户端启动随后的印刷要求PrinterJob.print(..)控制

将被递到打印系统，直到所有的页面都被打印出来。它通过调用Printable.print(..)到文档中的所有页已打印。在使用Printable接口印刷致力于图像的网页内容时，通过打印系统要求。

对Printable.print(..)包括PageFormat描述了页面的可打印区域的参数，计算的内容，将所需要的页面，和网页的索引，它指定零基础的打印流指标请求的页面。

为了正确的印刷行为，应遵守以下几点：

• 打印系统可以不止一次请求页面索引。每一次平等的pageformat参数将提供。
• 印刷系统将调用Printable.print(..)页指标单调增加，尽管如上所说，这Printable应该期待一页页指标指数和多个调用可以跳过，当页面范围由客户指定，或由用户通过打印对话框。
• 如果多个整理文件副本的要求，和打印机本身不能支持这个，那么文件可以多次成像。打印将从最低的打印流页面索引页开始每一个副本。
• 用多张重新成像整个文档外，页面索引顺序的增加意味着当N个页面请求如果客户需要计算分页符的位置，它可以安全地丢弃任何页面＜n相关的状态，并使当前页面的“状态”往往只是计算的位置在对应页面的启动文件。
• 当被印刷系统的Printable必须检查和荣誉所提供的PageFormat参数以及页面索引。该页被吸引的格式是由PageFormat指定供应。的大小、方向和页面成像面积因此已经确定和绘制必须这种成像区域内。这是正确的打印行为的关键，它具有的含义是，客户端有跟踪什么内容属于指定的页面的责任。
• 当Printable得到客户提供Pageable然后客户可以为每个页面提供不同的PageFormats指数。页面休息的计算必须考虑到这一问题。

另请参见：

Pageable， PageFormat， PrinterJob

Field Summary

Fields

Modifier and Type	Field and Description
static int	NO_SUCH_PAGE 回到 print表示 pageIndex太大和所请求的页面不存在。
static int	PAGE_EXISTS 回到 print(Graphics, PageFormat, int)表示请求的网页渲染。

方法摘要

Modifier and Type	Method and Description
int	print(Graphics graphics, PageFormat pageFormat, int pageIndex) 打印页面中的指定索引处到指定的 Graphics上下文中指定的格式。

Field Detail

PAGE_EXISTS

static final int PAGE_EXISTS

回到 print(Graphics, PageFormat, int)表示请求的网页渲染。

另请参见：

Constant Field Values

NO_SUCH_PAGE

static final int NO_SUCH_PAGE

回到 print表示 pageIndex太大和所请求的页面不存在。

另请参见：

Constant Field Values

方法详细信息

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如果呈现页面成功或no_such_page如果 pageIndex指定一个不存在的页面。

异常

PrinterException -当打印作业终止。