iMargin (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

When should I use iMargin?

Logical margins and physical margins

iChangeSubReportSource

iInitReportQueryConnection

iReportPrintingStatus

When should I use iMargin?
Logical margins and physical margins

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iMargin (Function)

In french: iMarge

Defines the "logical" print margins. These margins are added to the physical margins in which nothing can be printed. Therefore, you cannot print inside the physical and logical margins.

Caution: This function cannot be used in the report editor.

Example

iMargin(20, 11, 20, 11)
// Find out the physical margins of a printer
iMargin(0, 0, 0, 0)
MarginH = (PaperHeight - iPageHeight())/2
MarginW = (PaperWidth - iPageWidth())/2

Syntax

iMargin(<Top margin> , <Bottom margin> , <Left margin> , <Right margin>)

<Top margin>: Real

Margin of the top section of page, expressed in millimeters. This margin applies from the top side of the page. If this margin is smaller than the physical top margin, the physical top margin will apply.

<Bottom margin>: Real

Margin of the bottom section of page, expressed in millimeters. This margin will be applied from the bottom side of the page. If this margin is smaller than the physical bottom margin, the physical bottom margin will apply.

<Left margin>: Real

Margin of the left section of page, expressed in millimeters. This margin will be applied from the left side of the page. If this margin is smaller than the physical left margin, the physical left margin will apply.

<Right margin>: Real

Margin of the right section of page, expressed in millimeters. This margin applies from the right side of the page. If this margin is smaller than the physical right margin, the physical right margin will apply.

Remarks

When should I use iMargin?

iMargin must be called:
- before the positioning and printing functions (iPrint, iPrintImage, etc.),
- after iConfigure (or iParameter).
iEndPrinting cancels the margins.
In the same document, the margins can be redefined several times with iMargin. For each print, the origin of the print will use the last defined margins.
iMargin must not be called in the processes of a report created with the report editor.

Logical margins and physical margins

By default, the logical margins are set to 0. The origin (0, 0) is located in the top left corner of the sheet, taking into account the physical margin (top and left).
The physical print area is maximal when the parameters of iMargin are all equal to 0 (default value).

Component : wd260prn.dll