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 (in Windows standard, with a rounded end) at specified coordinates. 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 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 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).
<Style>: Optional integer constant
Type of line.
iContinuous
(default value)
Solid line
iDashedDashed line (-----)
iDotAndDashDot-and-dash line (-.-.)
iDottedDotted line (....)

WINDEV 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.
<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:
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: wd290prn.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