Important: The information in this document is obsolete and should not be used for new development.
PrStlDialog
You can use thePrStlDialog
function to display the style dialog box provided by the resource file for the current printer driver.
FUNCTION PrStlDialog (hPrint: THPrint): Boolean;
hPrint
- A handle to a
TPrint
record (described on page 9-41), which may be a new record or an existing one from a document.DESCRIPTION
ThePrStlDialog
function gets the initial settings to display in the style dialog box from theTPrint
record specified in thehPrint
parameter. The user specifies the page dimensions and other information needed for page setup through the style dialog box. Your application should display this dialog box when the user chooses Page Setup from the File menu.If the user confirms the dialog box, the
PrStlDialog
function returnsTRUE
. ThePrStlDialog
function saves the results of the dialog box in the specifiedTPrint
record and calls thePrValidate
function (described on page 9-57). Otherwise, theTPrint
record is left unchanged and the function returnsFALSE
.SPECIAL CONSIDERATIONS
You should never callPrStlDialog
between the pages of a document.You must call the
PrOpen
procedure (described on page 9-54) prior to callingPrStlDialog
, and you must call thePrClose
procedure (described on page 9-55) afterward, because the current printer driver must be open in order for your application to successfully callPrStlDialog
.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for thePrStlDialog
function are
Trap macro Selector _PrGlue $2A040484 SEE ALSO
See Figure 9-3 on page 9-6 for an example of a style dialog box. For more information on the use of a style dialog box, see "Getting Printing Preferences From the User" beginning on page 9-5. For information on how to customize a style dialog box, see "Altering the Style or Job Dialog Box" beginning on page 9-32.