gBackgroundGradient (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Gradient parameters
Background color

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

gBackgroundGradient (Function)

In french: gFondDégradé

Describes a display color in gradient mode. This color can be used for the background of the text displayed in an element of a List Box or Combo Box control, for a table cell, etc.

Caution: This function cannot be directly used for the background of a window (see the example below).

Versions 24 and later

This function is now available for iPhone/iPad applications.

New in version 24

This function is now available for iPhone/iPad applications.

Example

// Ajout du mot "Jaune" sur fond dégradé rouge à vert dans la liste "LISTE_ListeCouleur"
ListAdd(LISTE_ListeCouleur, gBackgroundGradient(LightRed, LightGreen) + "Jaune")

// Libellé avec un texte sur fond dégradé
LIB_Element..Caption = gBackgroundGradient(RGB(166, 223, 98), RGB(87, 171, 47)) + gPen(LightRed) + ...
"Libellé avec fond dégradé"

// Exemple permettant d'appliquer un fond de fenêtre dégradé.
// Il faut utiliser un champ Image hors écran de la taille de la fenêtre (ici IMG_Degrade)

MonImage is string
MonImage = CompleteDir(fExeDir()) + "ImageFond.JPG"
IF fFileExist(MonImage) = True THEN fDelete(MonImage)
IMG_Degrade = gBackgroundGradient(PastelRed, PastelBlue, 70)
dSaveImageJPEG(IMG_Degrade, MonImage, 65)
FEN_Fenêtre1.ImageFond = MonImage

Syntax

<Result> = gBackgroundGradient(<Start color> , <End color> [, <Angle> [, <Color 3> [, <Distance color 3> [, <Color 4> [, <Distance color 4>]]]]])

<Result>: Character string

Control string to be used:
with BackgroundStyle.
in ListAdd, ListInsert or ListModify.

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

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

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.

Background color

gBackgroundGradient can be used to define the background of a graphic area in the title bar and status bar of a window or in a Static control.
gBackgroundGradient called with the Transparent constant is used to superimpose a text and a graphic.

Component: wd260obj.dll