Executes a body of code repeatedly with a variable bound to the number of the page to be printed each iteration.
capi
with-document-pages page-var first-page last-page &body body
page-var⇩ |
A symbol (not evaluated). |
first-page⇩ |
A positive integer. |
last-page⇩ |
A positive integer. |
body⇩ |
Lisp forms. |
The macro with-document-pages
evaluates the forms in 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.
first-page and last-page 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.
The code in body should do the printing by calling standard GRAPHICS-PORTS drawing functions (see 13.4 Drawing functions), typically also using with-page-transform.
(example-edit-file "capi/printing/fit-to-page")
(example-edit-file "capi/printing/multi-page")
(example-edit-file "capi/printing/page-on-demand")
print-dialog
with-page
with-print-job
16 Printing from the CAPI—the Hardcopy API
CAPI User Guide and Reference Manual (Unix version) - 01 Dec 2021 19:32:42