<Image>.DrawRoundedRectangle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Coordinates

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Image>.DrawRoundedRectangle (Function)

In french: <Image>.DessineRectangleArrondi

Draws a rounded rectangle in an Image control.

Caution: In Linux, this function requires a specific configuration. For more details, see Drawing in WINDEV, WEBDEV and WINDEV Mobile.

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:
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 <Image 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 <Image variable>.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 WLanguage preset color,
a variable of type Color.
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:
Rounding: if the property corresponds to the constant RoundingIndefined, no rounding is performed..
Color: if the Property corresponds to the constant UndefinedColorthe color defined during the last call to function <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 ThicknessIndefinedthe thickness defined during the last call to function <Image>.Pen is used. If this function has not been used, the thickness will be set to 1.
Trait: if the property corresponds to TraitIndéfinithe stroke type defined during the last call to function <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 WLanguage preset color,
a variable of type Color,
transparent if this parameter is not specified and if <Image 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 <Image variable>.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:
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 <Image 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 <Image variable>.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 WLanguage preset color,
a variable of type Color.
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:
Rounding: if the property corresponds to the constant RoundingIndefined, no rounding is performed..
Color: if the Property corresponds to the constant UndefinedColorthe color specified during the last call to function <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 ThicknessIndefinedthe thickness specified during the last call to function <Image>.Pen is used. If this function has not been used, the thickness will be set to 1.
Trait: if the property corresponds to TraitIndéfinithe stroke type specified in the last call to function <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 WLanguage preset color,
a variable of type Color,
transparent if this parameter is not specified and if <Image 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 <Image variable>.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: wd300pnt.dll