Macro

Summary

Executes a body of code repeatedly with a variable bound to the number of the page to be printed each iteration.

Package

capi

Signature

with-document-pages page-var first-page last-page &body body

Description

The macro with-document-pages evaluates body repeatedly, with page-var bound to the number of the page to print on each iteration. It is used to by applications providing Page on Demand printing.

The first-page and last-page arguments are evaluated to yield the page numbers of the first and last pages in the document.

with-document-pages takes care of first-page and last-page when the user sets them in print-dialog, by evaluating body for the pages that are in the intersection of what user chose and the other arguments.

with-document-pages must be called within the dynamic context of with-print-job.

Notes

The code in body should do the printing by calling standard GRAPHICS-PORTS drawing functions (see Drawing functions), typically also using with-page-transform.

Examples

See also

print-dialog
with-page
with-print-job
Printing from the CAPI—the Hardcopy API