dPen (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

dPen (Function)

In french: dStylo

Declares the default color and style for lines, rectangles, circles, etc. contained in:

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 et du style par défaut des différents tracés
dPen(LightGreen, 3)

// Déclaration de la couleur et du style par défaut des différents tracés
dPen(IMG_Dessin, LightGreen, 3)

Syntax

dPen([<Image>, ] <Color> [, <Line style> [, <Line thickness> [, <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 color for the different lines. 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.

<Line style>: Optional integer

Default style for the different lines:
0 (default): Solid line
1: Dash (---)
2: Dotted line (...)
3: Dotted dash (.-.-.)
4: Two-dashed dash (-..-..-)
5: Invisible trait

<Line thickness>: Optional integer

Thickness of the line in pixels (1 by default).

<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 in the Image control has been 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: Indicate the design destination directly in the syntax (via a 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