GET PRINTABLE MARGIN
GET PRINTABLE MARGIN ( left ; top ; right ; bottom )
| Parameter | Type | Description | |
|---|---|---|---|
| left | Integer | ← | Left margin |
| top | Integer | ← | Top margin |
| right | Integer | ← | Right margin |
| bottom | Integer | ← | Bottom margin |
This command is not thread-safe, it cannot be used in preemptive code.
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.
