ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
  • 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 rectangle:
  • in an Image control,
  • in a variable of type Image.
Remark: To draw custom rectangles, it is recommended to use dBorder.
// Initialize the drawing in an Image control
dStartDrawing(IMG_Drawing)
 
// Draw a rectangle with a light yellow background
// and light blue borders
dRectangle(10, 10, 50, 50, LightYellow, LightBlue)
Reports and Queries
// Draw a rectangle with a light yellow background
// and light blue borders
dRectangle(IMG_Drawing, 10, 10, 50, 50, LightYellow, LightBlue)
Syntax

Drawing a rectangle by specifying the coordinates of rectangle Hide the details

dRectangle([<Image>, ] <X1> , <Y1> , <X2> , <Y2> [, <Background> [, <Line>]])
<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 upper-left corner of the rectangle.
<Y1>: Integer
Y-coordinate (in pixels) of the upper-left corner of the rectangle.
<X2>: Integer
X-coordinate (in pixels) of the lower-right corner of the rectangle.
<Y2>: Integer
Y-coordinate (in pixels) of the lower-right corner of the rectangle.
<Background>: Integer, constant or Background variable (optional)
  • Background color of rectangle. This color can be:
  • Background characteristics:
    • characteristics specified in the last call to dBackground if this parameter is not specified.
To use a gradient background color, call dRectangleGradient.
<Line>: Integer, constant or Border variable (optional)
  • Color of rectangle line. This color can be:
    • an RGB color (returned by RGB),
    • an HSL color (returned by HSL),
    • a WLanguage preset color,
    • identical to the color used for the background if this parameter is not specified and if dPen has not been used.
  • Characteristics of the line:
    • characteristics specified in the last call to dPen if this parameter is not specified.
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: wd290pnt.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/18/2024

Send a report | Local help