GET PRINTABLE MARGIN

GET PRINTABLE MARGIN ( left : Integer ; top : Integer ; right : Integer ; bottom : Integer )

Parameter	Type		Description
left	Integer	←	Left margin
top	Integer	←	Top margin
right	Integer	←	Right margin
bottom	Integer	←	Bottom margin

History

Release	Changes
6.8.1	Created

Description

The GET PRINTABLE MARGIN command returns the current values of the different margins defined using the Print form, PRINT SELECTION and PRINT RECORD commands.

The values are returned in pixels with respect to the paper edges.

It is possible to obtain the paper size as well as to calculate the printable area using the GET PRINTABLE AREA function.

About Printable Margin Management

By default, the printing calculation in 4D is based on “printable margins”. The advantage of this system is that the forms adapt themselves automatically to the new printers (since they are positioned in the printable area). On the other hand, in the case of pre-printed forms, it was not possible to position the elements to be printed precisely because changing the printer can modify the printable margins.

It is possible to base the form printing carried out using the Print form, PRINT SELECTION and PRINT RECORD commands on a fixed margin which is identical on each printer: the paper margins, i.e. the physical limits of the sheet. To do this, simply use the GET PRINTABLE MARGIN, SET PRINTABLE MARGIN and GET PRINTABLE AREA commands.

About Printing Terminology

Paper margin: the paper margin corresponds to the physical limits of the sheet.

Printer margin: the printer margin is the margin beyond which the printer is incapable of printing (for material reasons: print rollers, printer head end-of-travel...). It varies from one printer to another and from one format to another.

Dead margin:this refers to the area located between the paper margin and the printer margin.

See also

GET PRINTABLE AREA
Print form
SET PRINTABLE MARGIN

Properties

Command number	711
Thread safe	no