PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Coordinates
  • Drawing in PHP
  • Drawing in Browser code
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Draws a rectangle in an Image control.
Versions 15 and later
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
New in version 15
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
Example
// Draw a rectangle whose background is light yellow
// and whose border is light blue
IMG_Drawing.DrawRectangle(10, 10, 50, 50, LightYellow, LightBlue)
Syntax

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

<Image control>.DrawRectangle(<X1> , <Y1> , <X2> , <Y2> [, <Background> [, <Line>]])
<Image control>: Control name
Name of Image control to use.
<X1>: Integer
X coordinate (in pixels) of top left corner of rectangle.
<Y1>: Integer
Y coordinate (in pixels) of top left corner of rectangle.
<X2>: Integer
X coordinate (in pixels) of bottom right corner of rectangle.
<Y2>: Integer
Y coordinate (in pixels) of bottom right corner of rectangle.
<Background>: Integer, constant or Background variable (optional)
  • Background color of rectangle. This color can be:
  • Characteristics of background:
    • Versions 21 and later
      WEBDEV - Server code Background variable. In this case, the gradient defined in the variable is ignored.
      New in version 21
      WEBDEV - Server code Background variable. In this case, the gradient defined in the variable is ignored.
      WEBDEV - Server code Background variable. In this case, the gradient defined in the variable is ignored.
    • characteristics specified in the last call to <Image>.Background if this parameter is not specified.
To use a gradient background color, call dRectangleDegrade_objet.
<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 preset color of WLanguage,
    • Versions 22 and later
      WEBDEV - Server code a Color variable,
      New in version 22
      WEBDEV - Server code a Color variable,
      WEBDEV - Server code a Color variable,
    • identical to the color used for the background if this parameter is not specified and if <Image>.Pen was not used.
  • Characteristics of the line:
    • Versions 21 and later
      WEBDEV - Server code Border variable. In this case, only the following properties are taken into account:
      • Color: if the property corresponds to the ColorUndefined constant, the color defined during the last call to <Image>.Pen is used. If this function was not used, the background color of the rectangle is used.
      • Thickness: if the property corresponds to the ThicknessUndefined constant, the thickness defined during the last call to <Image>.Pen will be used. If this function was not used, the thickness is set to 1.
      • Line: if the property corresponds to the LineUndefined constant, the type of line defined during the last call to <Image>.Pen is used. If this function was not used, the line is a solid line.
      New in version 21
      WEBDEV - Server code Border variable. In this case, only the following properties are taken into account:
      • Color: if the property corresponds to the ColorUndefined constant, the color defined during the last call to <Image>.Pen is used. If this function was not used, the background color of the rectangle is used.
      • Thickness: if the property corresponds to the ThicknessUndefined constant, the thickness defined during the last call to <Image>.Pen will be used. If this function was not used, the thickness is set to 1.
      • Line: if the property corresponds to the LineUndefined constant, the type of line defined during the last call to <Image>.Pen is used. If this function was not used, the line is a solid line.
      WEBDEV - Server code Border variable. In this case, only the following properties are taken into account:
      • Color: if the property corresponds to the ColorUndefined constant, the color defined during the last call to <Image>.Pen is used. If this function was not used, the background color of the rectangle is used.
      • Thickness: if the property corresponds to the ThicknessUndefined constant, the thickness defined during the last call to <Image>.Pen will be used. If this function was not used, the thickness is set to 1.
      • Line: if the property corresponds to the LineUndefined constant, the type of line defined during the last call to <Image>.Pen is used. If this function was not used, the line is a solid line.
    • characteristics specified in the last call to <Image>.Pen if this parameter is not specified.
WEBDEV - Server code

Drawing a rectangle via a Rectangle variable Hide the details

<Image control>.DrawRectangle(<Rectangle> [, <Background> [, <Line>]])
<Image control>: Control name
Name of Image control to use.
<Rectangle>: Rectangle variable
Name of the Rectangle variable defining the coordinates of the rectangle to draw.
<Background>: Integer, constant or Background variable (optional)
  • Background color of rectangle. This color can be:
  • Characteristics of background:
    • Background variable. In this case, the gradient defined in the variable is ignored.
    • characteristics specified in the last call to <Image>.Background if this parameter is not specified.
To use a gradient background color, call dRectangleDegrade_objet.
<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 preset color of WLanguage,
    • Versions 22 and later
      a Color variable,
      New in version 22
      a Color variable,
      a Color variable,
    • identical to the color used for the background if this parameter is not specified and if <Image>.Pen was not used.
  • Characteristics of the line:
    • WEBDEV - Server code Border variable. In this case, only the following properties are taken into account:
      • Color: if the property corresponds to the ColorUndefined constant, the color defined during the last call to <Image>.Pen is used. If this function was not used, the background color of the rectangle is used.
      • Thickness: if the property corresponds to the ThicknessUndefined constant, the thickness defined during the last call to <Image>.Pen is used. If this function was not used, the thickness is set to 1.
      • Line: if the property corresponds to the LineUndefined constant, the type of line defined during the last call to <Image>.Pen will be used. If this function was not used, the line is a solid line.
    • characteristics specified in the last call to <Image>.Pen if this parameter is not specified.
Remarks

Coordinates

The coordinates are specified in relation to the top left corner of the Image control (coordinates set to (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 / GUI classification : Neutral code
Component : wd250pnt.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment