Command AP BLOB to print settings

4D Pack

AP BLOB to print settings

version 2004


AP BLOB to print settings (printSettings{; paramType}) Longint

ParameterTypeDescription
printSettingsBLOBBLOB containing the print settings
paramTypeLongint0 = Layout and print, 1 = Print

Function resultLongint1 = 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

AP Print settings to BLOB.