<Image variable>.DrawRectangleGradient (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Gradient parameters

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Image variable>.DrawRectangleGradient (Function)

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

Draws a rectangle in an Image variable.

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 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.

<Start color>: Integer or constant

Start color of 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 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.

Gradients with 3 or 4 colors are only available for 0 or 90 degree angles.

Remark: The gradient colors are not available for some systems (Windows 98 or Me for example) or for 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 / GUI classification : Neutral code

Component : wd250pnt.dll