iLine (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Print functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iLine (Function)

In french: iTrait

Prints a line at specified coordinates. Unlike iNewLine, the end of the line is squared (instead of being rounded).

The print job is not started (only iEndPrinting can be used to start the print job).

Note The origin (0,0) is located in the top left-hand corner of the sheet. It takes the physical margins of the printer into account.

Example

// Trace un trait sur toute la largeur de la page
// Épaisseur : 2.5 points Pica
iLine(10, 10, 30, 25, 2.5)
iEndPrinting()

Syntax

<Result> = iLine(<X1> , <Y1> , <X2> , <Y2> [, <Thickness> [, <Color> [, <Style>]]])

<Result>: Boolean

True if the line was printed,
False otherwise.

<X1>: Real

Horizontal coordinate of the beginning of line (in millimeters). Value between 0 and the page width (returned by iPageWidth).

<Y1>: Real

Vertical coordinate of the beginning of line (in millimeters). Value between 0 and the page height (returned by iPageHeight).

<X2>: Real

Horizontal coordinate of the end of line (in millimeters). Value between 0 and the page width (returned by iPageWidth).

<Y2>: Real

Vertical coordinate of the end of line (in millimeters). Value between 0 and the page height (returned by iPageHeight).

<Thickness>: Optional real

Line thickness (in picas). Default value = 1 (one Pica = 0.353 mm).
To get a thickness of 1 pixel, <Thickness> must be equal to 0. When the thickness increases, it is proportionally distributed between the two sides of line.

<Color>: Optional integer

Color used for the line. If this parameter is not specified, the color used is black.
This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.

<Style>: Optional integer constant

Type of line.
iContinuous
(default value) Solid line
iDashed Dashed line (-----)
iDotAndDash Dot-and-dash line (-.-.)
iDotted Dotted line (....)

Warning: If <Thickness> is greater than 1, the line type will always be solid. This parameter can be ignored if it is not supported by the printer driver.

Remarks

The cursor position is not modified when the outline is drawn.
A dotted line (iDotted) or a mixed line (iDotAndDash) combined with a thick line may produce unpleasant effects.

Component: wd300prn.dll