Binds a variable to either
nil, and executes a body of code to print a page only if the variable is
t if a page is to be printed, or
nil if it is to be skipped. The
is executed once, and is expected to draw the document only if
Each call to
with-page contributes a new page to the document.
with-page must be called within the dynamic context of with-print-job.
with-page does not work on Cocoa.
The code in
should do the printing by calling standard GRAPHICS-PORTS drawing functions (see Drawing functions), typically also using with-page-transform.
nil when only part of the document is printed, for example when the user specifies that she wants only odd pages. When
nil, the code in
needs to ensure that the next call to
with-page prints the right page.
Normally with-document-pages is the preferred method of printing.
CAPI User Guide and Reference Manual (Macintosh version) - 25 Feb 2015