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

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

Using the drawing functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

dBackground (Function)

In french: dFond

Declares the default background color for the rectangles, circles, etc::

in an Image control,
in a variable of type Image.

Example

See additional examples

// Initialise le dessin dans un champ Image
dStartDrawing(IMG_Dessin)

// Déclaration de la couleur de fond des différents dessins réalisés dans le champ Image
dBackground(LightGreen)

// Déclaration de la couleur de fond des différents dessins réalisés dans le champ Image IMG_Dessin
dBackground(IMG_Dessin, LightGreen)

Syntax

dBackground([<Image>, ] <Color> [, <Fill style> [, <Type of hatching> [, <Opacity>]]])

<Image>: Optional control name or optional Image, WDPic or picLayer variable

Image to use. This image can correspond to:
the name of an Image control.
the name of a variable of type Image.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.

<Color>: Integer or constant

Default background color of different drawings. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.
a variable of type Color. In this case, the opacity specified in the variable is taken into account.

<Fill style>: Optional integer or Integer constant

Default background fill of different drawings:
BackgroundHatched Background filled with hatching.
Corresponds to value 2 for compatibility.
BackgroundSolid
(Default value) Solid background.
Corresponds to value 0 for compatibility.
BackgroundTransparent Transparent background (<Color> is ignored).
Corresponds to value 1 for compatibility.

<Type of hatching>: Optional integer

Type of background hatching used by default in the different drawings. To use this parameter, the value of <Fill style> must be equal to 2. If the value of <Fill style> is different from 2, <Type of hatching> is ignored. The different types of hatching are:
0: Horizontal hatching
1: Vertical crosshatching
2: 60% diagonal cut
3: 120% diagonal hatching
4 (default): Cross-hatching
5: Diagonal cross-hatching

<Opacity>: Optional integer

Opacity of color, included between 0 (transparent) and 255 (opaque). An opacity set to 128 is used to blend 50% of the color with the existing color found in the control.
Remarks:
This opacity will be taken into account if the drawing was initialized with the dWithOpacity constant (dStartDrawing).
If parameter <Couleur> corresponds to a variable of type Color, this parameter must not be specified: the opacity specified in the variable will be taken into account.

Remarks

Using the drawing functions

The drawing functions can be used according to 2 methods:

Method 1: Using the dDrawingStartfunction
- dStartDrawing must be called before any other drawing function. dStartDrawing is used to define the element (Image control or variable) to which the drawing functions will be applied.
- When drawing on an Image control:
  - The drawing functions operate on a copy ("bitmap") of the image. You can use the drawing functions of Windows (via API or CallDLL32) but these functions must use the DC (Device Context) returned by dStartDrawing.
  - dEndDrawing and dStartDrawing must not be called in the same process.
    If function dEndDrawing is called in the same process as function dStartDrawing, the drawing will not appear: it will be automatically deleted.
Method 2: specify design destination directly in syntax (via parameter)
The <Image> parameter is used to specify directly the target of the drawing. dStartDrawing becomes useless. This function must be deleted.

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