All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

NextPrevUpTopContentsIndex

with-document-pages

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
(example-edit-file "capi/printing/fit-to-page") (example-edit-file "capi/printing/multi-page") (example-edit-file "capi/printing/page-on-demand")
See also

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


CAPI User Guide and Reference Manual (Unix version) - 25 Feb 2015

NextPrevUpTopContentsIndex