<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. For more details, see The drawings.

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),
une 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 the <Image>.Background function has not been used before.
Characteristics of background:
Variable 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:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color of WLanguage,
Versions 22 and later
an Variable type Color.
New in version 22
an Variable type Color.
an Variable type Color.
If this parameter is not specified:
color specified in the last call to <Image>.Pen.
Color same as Color used for Background if <Image>.Pen was not 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:
Arrondi: 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 constant ThicknessUndefined, the thickness defined during the last call to the function <Image>.Pen is used. If this function has not been used, the thickness will be set to 1.
Line: if the property is LineUndefined, the type of Line defined during the last call to the <Image>.Pen function 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),
une preset color of WLanguage,
Versions 22 and later
a Variable of type Color ,
New in version 22
a Variable of type Color ,
a Variable of type Color ,
transparent if this parameter is not specified and if the <Image>.Background function has not been used before.
Characteristics of background:
Variable 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 use.

<Rectangle>: Rectangle variable

Name of the Variable of type Rectangle defining 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),
une preset color of WLanguage,
Versions 22 and later
a Variable of type Color ,
New in version 22
a Variable of type Color ,
a Variable of type Color ,
transparent if this parameter is not specified and if the <Image>.Background function has not been used before.
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),
une preset color of WLanguage,
Versions 22 and later
an Variable type Color.
New in version 22
an Variable type Color.
an Variable type Color.
If this parameter is not specified:
color specified in the last call to <Image>.Pen.
Color same as Color used for Background if <Image>.Pen was not 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 Variable of type Rectangle defining 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:
Arrondi: 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),
une 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 the <Image>.Background function has not been used before.
Characteristics of background:
Variable 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

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