ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Print functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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).
Remark: The origin (0,0) is located in the upper-left corner of the sheet. It takes the physical margins of the printer into account.
Example
// Draws a line across the page width
// Thickness: 2.5 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:
<Style>: Optional integer constant
Type of line.
iContinuous
(default value)
Solid line
iDashedDashed line (-----)
iDotAndDashDot-and-dash line (-.-.)
iDottedDotted line (....)

WINDEVWEBDEV - Server code 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.
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
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help