ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Declares the default color and style for the lines, rectangles, circles, ... contained in a variable of type Image.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.
Example
MyImage is Image = "Test.gif"
// Declare the default color and style for the different lines
MyImage.Pen(LightGreen, 3)
IMG_MyDrawing = MyImage
Syntax
<Image variable>.Pen(<Color> [, <Line style> [, <Line thickness> [, <Opacity>]]])
<Image variable>: Image variable
Name of the Image variable to be used.
<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 (by default): Solid line
  • 1: Dash (---)
  • 2: Dotted line (...)
  • 3: Dot and dash (-.-.-)
  • 4: Dash and two dots (-..-..-)
  • 5: Invisible line
<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 (<Image variable>.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
Business / UI classification: Neutral code
Component: wd290pnt.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/30/2023

Send a report | Local help