<Image variable>.DrawRectangleGradient (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Gradient parameters

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Image variable>.DrawRectangleGradient (Function)

In french: <Variable Image>.DessineRectangleDégradé

Draws a rectangle in a variable of type Image.

Example

MyImage is Image = "Test.gif"
// Draw a rectangle whose background changes from red to blue
// via yellow
MyImage.DrawRectangleGradient(10, 20, 100, 150, LightRed, LightBlue, 0, LightYellow, 30)
IMG_MyDrawing = MyImage

Syntax

Drawing a rectangle by specifying the points of the rectangle and the gradient Hide the details

<Image variable>.DrawRectangleGradient(<X1> , <Y1> , <X2> , <Y2> , <Start color> , <End color> [, <Angle> [, <Color 3> [, <Distance color 3> [, <Color 4> [, <Distance color 4>]]]]])

<Image variable>: Image variable

Name of the Image variable 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.

<Start color>: Integer or constant

Start color of the gradient. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color (see the preset colors of WLanguage).

<End color>: Integer or constant

End color of the gradient. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color (see the preset colors of WLanguage).

<Angle>: Optional integer

Angle that will be used for the selection of colors in the gradient. The angle value is included between 0 (horizontal angle, default value) and 360°.

<Color 3>: Optional constant or integer

Color that will be used in the gradient. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color (see the preset colors of WLanguage).

<Distance color 3>: Optional integer

Percentage separating the start color from color 3.

<Color 4>: Optional constant or integer

Color that will be used in the gradient. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color (see the preset colors of WLanguage).

<Distance color 4>: Optional integer

Percentage separating the start color from color 4.

Remarks

Gradient parameters

The color parameters are used as follows:

The angle is used to define the orientation of the gradient.

The gradients performed with 3 or 4 colors are only available for an angle set to 0 or 90 degrees.

Note Gradients are not available on certain systems (e.g. Windows 98 or Me) or under TSE 256 colors. In this case, a rectangle whose color corresponds to <Start color> is displayed.

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: wd300pnt.dll