Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Declares the default background color for the rectangles, circles, etc., used in an Image control.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.
// Declare the background color of the different drawings in the IMG_Drawing control
<Image control>.Background(<Color> [, <Fill style> [, <Type of hatching> [, <Opacity>]]])
<Image control>: Control name
Name of the Image control to be used.
<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:
BackgroundHatchedBackground filled with hatching.
Corresponds to value 2 for compatibility.
(Default value)
Solid background.
Corresponds to value 0 for compatibility.
BackgroundTransparentTransparent background (<Color> is ignored).
Corresponds to value 1 for compatibility.

Universal Windows 10 App This value is ignored. In this version, you cannot hatch the background of a drawing.
iPhone/iPadIOS WidgetMac Catalyst The drawing of hatching is not supported.
<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 hatching
  • 2: Diagonal hatching at 60%
  • 3: Diagonal hatching at 120%
  • 4 (by default): Criss-crossed hatching
  • 5: Diagonal crossed hatching
Universal Windows 10 App This value is ignored. In this version, you cannot hatch the background of a drawing.
<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.
  • This opacity will be taken into account if the drawing was initialized with the dWithOpacity constant (<Image>.StartDrawing).
  • If the <Color> parameter corresponds to a variable of type Color, this parameter must not be specified: the opacity specified in the variable will be taken into account.
Related Examples:
The drawing functions 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
Component: wd290pnt.dll
Minimum version required
  • Version 24
This page is also available for…
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help