PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

  • Coordinates
  • Using the drawing 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
Draws a line:
  • in an Image control,
  • in a variable of type Image.
Example
// Initialize the drawing in an Image control
dStartDrawing(IMG_Drawing)
 
// Draw a line in light yellow
dLine(10, 10, 50, 50, LightYellow)
Reports and Queries
// Draw a line in light yellow
dLine(IMG_Drawing, 10, 10, 50, 50, LightYellow)
Syntax
dLine([<Image>, ] <X1> , <Y1> , <X2> , <Y2> [, <Line color> [, <Line thickness>]])
<Image>: Optional control name or optional Image, WDPic or picLayer variable
Reports and QueriesWindows Image to use. The image can correspond to:
  • the name of an Image control.
  • the name of a variable of type Image.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.
<X1>: Integer
X-coordinate (in pixels) of the start point of the line.
<Y1>: Integer
Y-coordinate (in pixels) of the start point of the line.
<X2>: Integer
X-coordinate (in pixels) of the end point of the line.
<Y2>: Integer
Y-coordinate (in pixels) of the end point of the line.
<Line color>: Integer or constant (optional)
Line color. This color can correspond to:If this parameter is not specified, the line color:
  • is Transparent if dPen has not been used beforehand,
  • corresponds to the color specified in the last call to dPen.
<Line thickness>: Optional integer
Thickness (in pixels) of the line to draw. If this parameter is not specified, the value taken into account can be:
  • the last value specified in the last call to dPen.
  • 1 if dPen was not used beforehand.
Remarks

Coordinates

Coordinates are specified with respect to the upper-left corner of the image or Image control (coordinates: (0,0)).

Using the drawing functions

The drawing functions can be used according to 2 methods:
  • Method 1: Using dStartDrawing
    • dStartDrawing must be called before any other drawing function. dStartDrawing is used to define the element (Image control or variable) to which the drawing functions will be applied.
    • When drawing on an Image control:
      • The drawing functions operate on a copy ("bitmap") of the image. You can use the drawing functions of Windows (via API or CallDLL32) but these functions must use the DC (Device Context) returned by dStartDrawing.
      • dEndDrawing and dStartDrawing must not be called in the same process.
        The drawing will not be displayed if dEndDrawing and dStartDrawing are called in the same process: it will be automatically erased.
  • Reports and QueriesWindows Method 2: indicating the drawing target directly in the syntax (via a parameter)
    The <Image> parameter is used to specify directly the target of the drawing. dStartDrawing becomes useless. This function must be deleted.
Related Examples:
The drawing functions Unit examples (WINDEV): The drawing functions
[ + ] Using the main drawing functions of WINDEV to:
- Initialize an Image control for drawing
- Draw simple shapes
- Write a text into a drawing
- Change the color in a drawing
Business / UI classification: Neutral code
Component: wd270pnt.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment