PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • 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/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Draws a rectangle in a variable of type WDPic (on the background layer).
Versions 15 and later
WEBDEV - Server code This function is now available for WEBDEV sites in Linux.
New in version 15
WEBDEV - Server code This function is now available for WEBDEV sites in Linux.
WEBDEV - Server code This function is now available for WEBDEV sites in Linux.
Example
MyWDPicImage is WDPic = "Test.gif"
 
// Draw a rectangle whose background is light yellow
// and whose border is light blue
MyWDPicImage.DrawRectangle(10, 10, 50, 50, LightYellow, LightBlue)
 
IMG_MyDrawing = MyWDPicImage
Syntax

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

<WDPic image>.DrawRectangle(<X1> , <Y1> , <X2> , <Y2> [, <Background> [, <Line>]])
<WDPic image>: WDPic variable
Name of the WDPic variable to be used. Only the background layer will be handled.
<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:
    • Versions 21 and later
      WINDEVWEBDEV - Server code Background variable. In this case, the gradient defined in the variable is ignored.
      New in version 21
      WINDEVWEBDEV - Server code Background variable. In this case, the gradient defined in the variable is ignored.
      WINDEVWEBDEV - Server code Background variable. In this case, the gradient defined in the variable is ignored.
    • characteristics specified in the last call to <WDPic variable>.Background if this parameter is not specified.
To use a gradient background color, call <WDPic variable>.DrawRectangleGradient.
<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,
    • Versions 22 and later
      WINDEVWEBDEV - Server code a variable of type Color,
      New in version 22
      WINDEVWEBDEV - Server code a variable of type Color,
      WINDEVWEBDEV - Server code a variable of type Color,
    • identical to the color used for the background if this parameter is not specified and if <WDPic variable>.Pen has not been used.
  • Characteristics of the line:
    • Versions 21 and later
      WINDEVWEBDEV - Server code Border variable. 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 <WDPic 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 <WDPic 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 <WDPic variable>.Pen is used. If this function has not been used, the line will be solid.
        New in version 21
        WINDEVWEBDEV - Server code Border variable. 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 <WDPic 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 <WDPic 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 <WDPic variable>.Pen is used. If this function has not been used, the line will be solid.
          WINDEVWEBDEV - Server code Border variable. 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 <WDPic 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 <WDPic 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 <WDPic variable>.Pen is used. If this function has not been used, the line will be solid.
          • characteristics specified in the last call to <WDPic variable>.Pen if this parameter is not specified.

        Drawing a rectangle via a Rectangle variable Hide the details

        <WDPic image>.DrawRectangle(<Rectangle> [, <Background> [, <Line>]])
        <WDPic image>: WDPic variable
        Name of the WDPic variable to be used. Only the background layer will be handled.
        <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 <WDPic variable>.DrawRectangleGradient.
        <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,
          • Versions 22 and later
            a variable of type Color,
            New in version 22
            a variable of type Color,
            a variable of type Color,
          • identical to the color used for the background if this parameter is not specified and if <WDPic variable>.Pen has not been used.
        • Characteristics of the line:
          • WINDEVWEBDEV - Server code Border variable. 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 <WDPic 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 <WDPic 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 <WDPic variable>.Pen is used. If this function has not been used, the line will be solid.
          • characteristics specified in the last call to <WDPic 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: wd270pnt.dll
        Minimum version required
        • Version 25
        This page is also available for…
        Comments
        Click [Add] to post a comment