iNewLine (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

InitRequestConnection

iChangeSubReportSource

iInitReportQueryConnection

iReportPrintingStatus

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iNewLine (Function)

In french: iLigne

Prints a line (in Windows standard, with a rounded end) at specified coordinates. The print is not started (only iEndPrinting can be used to start the print).

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

The lines are printed only if the printer used allows it. See Characteristics of a print on Mobile Device (Pocket PC) for more details.

Versions 18 and later

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available for iPhone/iPad applications.

Versions 19 and later

This function is now available in Android Widget mode.

This function is now available for Android applications.

New in version 19

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available for Android applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Draws a solid line in red
iNewLine(50, 10, 50, 200, iContinuous, 12, LightRed)
// Draws a solid line in black
iNewLine(50, 10, 5, 100, iContinuous, 12, Black)
// Start printing
iEndPrinting()

Syntax

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

<Result>: Boolean

True if the line was printed,
False otherwise.

<X1>: Real

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

<Y1>: Real

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

<X2>: Real

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

<Y2>: Real

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

<Style>: Optional integer constant

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

Caution: If <Thickness> is greater than 1, the line will always be a solid line. This parameter can be ignored if it is not supported by the printer driver.
This parameter always corresponds to a solid line. If one of the constants corresponding to the other types of lines is used, this constant will be ignored.

<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. 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 preset color of WLanguage.

Remarks

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

Component: wd260prn.dll