Next Prev Up Top Contents Index

print-dialog

Function
Summary

Displays a print dialog and returns a printer object.

Syntax

print-dialog &key screen owner first-page last-page print-selection-p print-pages-p print-copies-p

Description

The print-dialog function displays a print dialog and returns a printer object. The print object returned will print multiple copies if requested by the user.

If print-pages-p is t , the user can select a range of pages to print. This should always be the case unless the application only produces single page output. If print-pages is t , first-page and last-page can be used to initialize the page range. For example, they could be set to be the first and last pages of the document.

The print-copies-p keyword indicates whether the application handles production of multiple copies for drivers that do not support this function. Currently this should be nil if the application uses Page Sequential printing and t if the application uses Page on Demand printing.

If print-selection-p is t , the user is given the option of printing the current selection. Only specify this if the application has a notion of selection and selecting printing functionality is provided.

The dialog is displayed on the current screen unless screen specifies otherwise.

The interface that owns the dialog is given by owner . It should be a currently displayed interface, and defaults to the current top-level interface.

Note that programmatic setting of some printer options is available via the function set-printer-options .

See also

print-file
print-text
set-printer-options


LispWorks CAPI Reference Manual - 14 Dec 2001

Next Prev Up Top Contents Index