Carbon


PMPrintDialog

Header: PMApplication.h Carbon status: Supported

Displays the Print dialog box and records the user’s selections in a PMPrintSettings object.

OSStatus PMPrintDialog (
    PMPrintSettings printSettings, 
    PMPageFormat constPageFormat, 
    Boolean *accepted
);
Parameter descriptions
printSettings

A PMPrintSettings object.

constPageFormat

A PMPageFormat object.

accepted

Returns true if the user clicks the OK button, or false if the user clicks Cancel.

function result

A result code. A result code. See “Result Codes”.

DISCUSSION

When the Print dialog box is displayed, it shows the current settings in the print settings object. If the user changes these settings and clicks the OK button, the print settings object is updated with the user’s selections. If the user clicks the Cancel button, the print settings object is returned unchanged.

PMSessionPrintDialog is recommended instead of PMPrintDialog.

SPECIAL CONSIDERATIONS

Valid after calling PMBegin and creating a page format and print settings object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

CARBON NOTES

The PMPrintDialog function replaces the Printing Manager function PrJobDialog.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)