java.awt.print

Печатаемый интерфейс

public interface Printable

Printable интерфейс реализуется print методы текущего живописца страницы, которого вызывает система печати, чтобы представить страницу. Создавая a Pageable, пары PageFormat экземпляры и экземпляры, которые реализуют этот интерфейс, используются, чтобы описать каждую страницу. Реализация экземпляра Printable вызывается, чтобы напечатать графику страницы.

A Printable(..) может быть установлен на a PrinterJob. Когда клиент впоследствии инициирует печать, вызывая PrinterJob.print(..) управление

вручается системе печати, пока все страницы не были напечатаны. Это делает это, вызывая Printable.print(..) пока все страницы в документе не были напечатаны. В использовании Printable взаимодействуйте через интерфейс печать передает, чтобы отобразить содержание страницы всякий раз, когда требующийся системой печати.

Параметры к Printable.print(..) включайте a PageFormat который описывает печатаемую область страницы, необходимой для того, чтобы вычислить содержание, которое будет соответствовать странице, и индексу страницы, который определяет основанный на нуле потоковый индекс печати требуемой страницы.

Для корректного поведения печати должны наблюдаться следующие моменты:

• Система печати может запросить индекс страницы не раз. В каждом случае будут предоставлены равные параметры PageFormat.
• Система печати вызовет Printable.print(..) с индексами страницы, которые увеличиваются монотонно, хотя как отмечено выше, Printable должен ожидать множественные вызовы индекса страницы и той страницы, индексы могут быть пропущены, когда диапазоны страницы определяются клиентом, или пользователем через диалоговое окно печати.
• Если многократные разобранные копии документа требуют, и принтер не может исходно поддерживать это, то документ может быть отображен многократно. Печать запустит каждую копию с самой низкой потоковой индексной страницы страницы печати.
• За исключением переобработки изображений всего документа для многократных разобранных копий, увеличивающийся индексный порядок страницы означает, что, когда страницу N требуют, если клиент должен вычислить позицию разрыва страницы, это может безопасно отбросить любое состояние, связанное со страницами < N, and make current that for page N. "State" usually is just the calculated position in the document that corresponds to the start of the page.
• Когда вызвано системой печати Printable должен осмотреть и соблюдать предоставленный параметр PageFormat так же как индекс страницы. Формат страницы, которая будет оттянута, определяется предоставленным PageFormat. Размер, ориентация и вызывающая мысленный образ область страницы поэтому уже определяются, и рендеринг должен быть в пределах этой вызывающей мысленный образ области. Это является ключевым, чтобы исправить поведение печати, и у него есть импликация, что клиент несет ответственность отслеживания, какой контент принадлежит на указанной странице.
• Когда Printable получается из предоставленного клиентом Pageable тогда клиент может предоставить различному PageFormats для каждого индекса страницы. Вычисления разрывов страницы должны учесть это.

См. Также:

Pageable, PageFormat, PrinterJob

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	NO_SUCH_PAGE Возвращенный из print показать что pageIndex является слишком большим и что требуемая страница не существует.
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

Возвращенный из print показать что pageIndex является слишком большим и что требуемая страница не существует.

См. Также:

Постоянные Значения полей

Деталь метода

печать

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

Печатает страницу по указанному индексу в указанное Graphics контекст в указанном формате. A PrinterJob вызовы Printable взаимодействуйте через интерфейс, чтобы запросить что страница быть представленными в контексте, определенном graphics. Формат страницы, которая будет оттянута, определяется pageFormat. Нуль базируемый индекс требуемой страницы определяется pageIndex. Если требуемая страница не существует тогда, этот метод возвращает NO_SUCH_PAGE; иначе PAGE_EXISTS возвращается. Graphics класс или подкласс реализуют PrinterGraphics интерфейс, чтобы обеспечить дополнительную информацию. Если Printable возразите прерывает задание печати тогда, оно бросает a PrinterException.

Параметры:

graphics - контекст, в который оттягивается страница

pageFormat - размер и ориентация оттягиваемой страницы

pageIndex - нуль базируемый индекс страницы, которая будет оттянута

Возвраты:

PAGE_EXISTS, если страница представляется успешно или NO_SUCH_PAGE если pageIndex определяет несуществующую страницу.

Броски:

PrinterException - брошенный, когда задание печати завершается.