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 rounded rectangle in an Image control.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.
Example
// Draw a rounded rectangle whose background is light yellow
// and light blue borders
IMG_Drawing.DrawRoundedRectangle(10, 10, 50, 50, 3, LightYellow, LightBlue)
Syntax

Drawing a rounded rectangle by specifying the coordinates of the rectangle and the diameter of corners Hide the details

<Image control>.DrawRoundedRectangle(<X1> , <Y1> , <X2> , <Y2> , <Corner diameter> [, <Background> [, <Line>]])
<Image control>: Control name
Name of the Image control 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.
<Corner diameter>: Integer
Diameter of rectangle corners.
<Background>: Integer or Integer constant (optional)
  • Background color of rectangle. This color can be:
  • Background characteristics:
    • variable of type Background. 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 <Image>.DrawRectangleGradient.
<Line>: Integer, constant or Border variable (optional)
Color of rectangle line. This color can be:If this parameter is not specified:
  • color specified in the last call to <Image>.Pen.
  • color identical to the color used for the background if <Image>.Pen has not been used.

Drawing a rounded rectangle by specifying the coordinates of the rectangle and the border type Hide the details

<Image control>.DrawRoundedRectangle(<X1> , <Y1> , <X2> , <Y2> , <Border> [, <Background>])
<Image control>: Control name
Name of the Image control 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.
<Border>: Border variable
Name of the Border variable that defines the characteristics of the rectangle. Only the following properties are taken into account:
  • Round: if the property corresponds to the RoundingUndefined constant, no rounding is performed.
  • Color: if the property is set to ColorUndefined, the color defined in the last call to <Image>.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>.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>.Pen is used. If this function has not been used, the line will be solid.
<Background>: Integer, constant or Background variable (optional)
  • Background color of rectangle. This color can be:
  • Background characteristics:
    • variable of type Background. 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 <Image>.DrawRectangleGradient.

Drawing a rounded rectangle via a Rectangle variable by specifying the diameter of corners Hide the details

<Image control>.DrawRoundedRectangle(<Rectangle> , <Corner diameter> [, <Background> [, <Line>]])
<Image control>: Control name
Name of the Image control to be used.
<Rectangle>: Rectangle variable
Name of the Rectangle variable that defines the coordinates of the rectangle to draw.
<Corner diameter>: Integer
Diameter of rectangle corners.
<Background>: Integer, constant or Background variable (optional)
  • Background color of rectangle. This color can be:
  • Background characteristics:
    • variable of type Background. 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 <Image>.DrawRectangleGradient.
<Line>: Integer, constant or Border variable (optional)
Color of rectangle line. This color can be:If this parameter is not specified:
  • color specified in the last call to <Image>.Pen.
  • color identical to the color used for the background if <Image>.Pen has not been used.

Drawing a rounded rectangle via a Rectangle variable and a Border variable Hide the details

<Image control>.DrawRoundedRectangle(<Rectangle> , <Border> [, <Background>])
<Image control>: Control name
Name of the Image control to be used.
<Rectangle>: Rectangle variable
Name of the Rectangle variable that defines the coordinates of the rectangle to draw.
<Border>: Border variable
Name of the Border variable that defines the characteristics of the rectangle. Only the following properties are taken into account:
  • Round: if the property corresponds to the RoundingUndefined constant, no rounding is performed.
  • Color: if the property corresponds to the ColorUndefined constant, the color specified during the last call to <Image>.Pen is used. If this function has not been used, the background color of the rectangle will be used.
  • Thickness: if the property corresponds to the ThicknessUndefined constant, the thickness specified during the last call to <Image>.Pen is used. If this function has not been used, the thickness will be set to 1.
  • Line: if the property corresponds to the LineUndefined constant, the type of line specified during the last call to <Image>.Pen is used. If this function has not been used, the line will be solid.
<Background>: Integer, constant or Background variable (optional)
  • Background color of rectangle. This color can be:
  • Background characteristics:
    • variable of type Background. 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 <Image>.DrawRectangleGradient.
Remarks

Coordinates

Coordinates are specified with respect to the upper-left corner of the Image control (coordinates: (0,0)).
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: 01/18/2024

Send a report | Local help