ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
  • Coordinates
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 a variable of type Image.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.
Example
MyImage is Image = "Test.gif"
 
// Draw a rectangle whose background is light yellow
// and whose border is light blue
MyImage.DrawRectangle(10, 10, 50, 50, LightYellow, LightBlue)
 
IMG_MyDrawing = MyImage
Syntax

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

<Image variable>.DrawRectangle(<X1> , <Y1> , <X2> , <Y2> [, <Background> [, <Line>]])
<Image variable>: Image variable
Name of the Image variable to be used.
<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)
To use a gradient background color, call <Image variable>.DrawRectangleGradient.
<Line>: Integer, constant or Border variable (optional)
  • Color of rectangle line. This color can be:
  • Characteristics of the line:
    • WINDEVWEBDEV - Server codeiPhone/iPadIOS WidgetMac Catalyst variable of type Border. In this case, only the following properties are taken into account:
      • Color: if the property is set to ColorUndefined, the color defined in the last call to <Image variable>.Pen is used. If this function has not been used, the background color of the rectangle will be used.
      • Thickness: if the property is set to ThicknessUndefined, the thickness defined in the last call to <Image variable>.Pen is used. If this function has not been used, the thickness will be set to 1.
      • Line: if the property is set to LineUndefined, the type of line defined in the last call to <Image variable>.Pen is used. If this function has not been used, the line will be solid.
    • characteristics specified in the last call to <Image variable>.Pen if this parameter is not specified.
WINDEVWEBDEV - Server codeUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac CatalystJava

Drawing a rectangle via a Rectangle variable Hide the details

<Image variable>.DrawRectangle(<Rectangle> [, <Background> [, <Line>]])
<Image variable>: Image variable
Name of the Image variable to be used.
<Rectangle>: Rectangle variable
Name of the Rectangle variable that defines the coordinates of the rectangle to draw.
<Background>: Integer, constant or Background variable (optional)
To use a gradient background color, call <Image variable>.DrawRectangleGradient.
<Line>: Integer, constant or Border variable (optional)
  • Color of rectangle line. This color can be:
  • Characteristics of the line:
    • WINDEVWEBDEV - Server codeiPhone/iPadIOS WidgetMac Catalyst variable of type Border. In this case, only the following properties are taken into account:
      • Color: if the property is set to ColorUndefined, the color defined in the last call to <Image variable>.Pen is used. If this function has not been used, the background color of the rectangle will be used.
      • Thickness: if the property is set to ThicknessUndefined, the thickness defined in the last call to <Image variable>.Pen is used. If this function has not been used, the thickness will be set to 1.
      • Line: if the property is set to LineUndefined, the type of line defined in the last call to <Image variable>.Pen is used. If this function has not been used, the line will be solid.
      Android Border variables are not available in this syntax. Use <Image variable>.DrawBorder to customize the borders.
    • characteristics specified in the last call to <Image variable>.Pen if this parameter is not specified.
Remarks

Coordinates

Coordinates are specified with respect to the upper-left corner of the image (coordinates: (0.0)).
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 24
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help