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 class или подкласс реализуют PrinterGraphics интерфейс, чтобы обеспечить дополнительную информацию. Если Printable возразите прерывает задание печати тогда, оно бросает a PrinterException.

Параметры:

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

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

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

Возвраты:

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

Броски:

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