<WDPic variable>.DrawRectangle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions

Coordinates
Drawing in PHP
Drawing in Browser code

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<WDPic variable>.DrawRectangle (Function)

In french: <Variable WDPic>.DessineRectangle

Draws a rectangle in a variable of type WDPic (on the background layer).

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:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color,
a variable of type Color,
transparent if this parameter is not specified and if <WDPic variable>.Background has not been used.
Background characteristics:
variable of type Background. 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,
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:
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 <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)

Background color of rectangle. This color can be:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color,
a variable of type Color,
transparent if this parameter is not specified and if <WDPic variable>.Background has not been used.
Background characteristics:
variable of type Background. 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,
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:
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 <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:

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