version 2004
AP BLOB to print settings (printSettings{; paramType}) Longint
Parameter | Type | Description | |
printSettings | BLOB | BLOB containing the print settings | |
paramType | Longint | 0 = Layout and print, 1 = Print | |
Function result | Longint | 1 = Operation successful, 0 = No current printer, | |
-1 = Incorrect parameters |
Description
The AP BLOB to print settings command replaces the current print settings of 4D by the parameters stored in the printSettings BLOB. This BLOB must have been generated by the AP Print settings to BLOB command.
The printSettings parameter contains two types of parameters:
Layout parameters: paper, orientation, scale,
Print parameters as such: number of copies, paper source, etc.
You can choose to load only the print parameters.
If you pass 0 in paramType or omit this parameter, all the parameters are used. If you pass 1, only the print parameters are used; the layout parameters remain unchanged.
The new print parameters are applied to the entire database and for the whole session, as long as no command such as PAGE SETUP, SET PRINT OPTION or PRINT SELECTION without the > parameter modifies them.
The parameters set are used more particularly by the PRINT SELECTION, PRINT LABEL, PRINT RECORD, Print form and QR REPORT commands, as well as by the menu commands of 4D, including those of the Design environment.
The PRINT SELECTION, PRINT LABEL and PRINT RECORD commands must be called with the > parameter (if applicable) in order for the settings defined by AP BLOB to print settings to be kept.
Note: Print settings are not formatted in the same way under Windows and Mac OS. As a result, the compatibility of the printSettings BLOB between the two platforms is not guaranteed.
The command returns 1 if the BLOB has been correctly loaded, 0 if no current printer is selected and -1 if the BLOB is incorrect.
See Also