<Image>.DrawRoundedRectangle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Coordinates

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Image>.DrawRoundedRectangle (Function)

In french: <Image>.DessineRectangleArrondi

Draws a rounded rectangle in an Image control.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

Example

// Draw a rounded rectangle whose background is light yellow
// and whose border is light blue
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 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.

<Corner diameter>: Integer

Diameter of rectangle corners.

<Background>: Integer or Integer constant (optional)

Background color of rectangle. 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,
transparent if this parameter is not specified and if <Image>.Background has not been used beforehand.
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 <Image>.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 preset color of WLanguage,
Versions 22 and later
a Color variable.
New in version 22
a Color variable.
a Color variable.
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 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.

<Border>: Border variable

Name of Border variable defining the rectangle characteristics. 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 defined 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 defined 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 defined during the last call to <Image>.Pen will be 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:
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,
transparent if this parameter is not specified and if <Image>.Background has not been used beforehand.
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 <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 use.

<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:
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,
transparent if this parameter is not specified and if <Image>.Background has not been used beforehand.
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 <Image>.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 preset color of WLanguage,
Versions 22 and later
a Color variable.
New in version 22
a Color variable.
a Color variable.
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 use.

<Rectangle>: Rectangle variable

Name of the Rectangle variable that defines the coordinates of the rectangle to draw.

<Border>: Border variable

Name of Border variable defining the rectangle characteristics. 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:
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,
transparent if this parameter is not specified and if <Image>.Background has not been used beforehand.
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 <Image>.DrawRectangleGradient.

Remarks

Coordinates

The coordinates are specified in relation to the top left corner of the Image control (coordinates set to (0,0)).

Business / UI classification : Neutral code

Component : wd260pnt.dll