- Background color
- Management of '&'
- Using the drawing functions
- Pattern and PHP
In french: dTexte
Draws a text:
- in an Image control,
- in an Image variable.
This type of variable is not available.
// Initialize the drawing in an Image control
// Draw a text in light yellow
dText(10, 20, "Easy development", LightYellow)
// Calculate the size of a text
nTextWidth is int
dText(X, Y, MyText)
nTextWidth = TextWidth(EDT_Edit1, MyText)
dText(X + nTextWidth, Y, MyNextText)
Versions 24 and later New in version 24
dText([<Image>, ] <X coordinate> , <Y coordinate> , <Text> [, <Text color> [, <Management of &>]])
<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.
- on behalf of an Variable of type Image.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing
<X coordinate>: entier
X coordinate of text to draw (in pixels).
<Y coordinate>: entier
Y coordinate of text to draw (in pixels).
<Text>: Type corresponding to the text to draw
Text to draw. This text can be:
- a string (without formatting marks such as TAB, CR, etc.),
- a numeric.
<Text color>: Integer or constant (optional)
Text color to use. This color can correspond to:
If this parameter is not specified, the color of the text:
- is Black if the dPen function has not been used before,
- corresponds to the Color specified in the last call to function dPen.
<Management of &>: Optional boolean
- True (default value) if the "&" character must not be interpreted as an underline operator.
- False if the "&" character must be interpreted as an underline operator: the character following the "&" character will be underlined.
- The font used is "MS Sans Serif" (size 13).
- The writing direction is horizontal (from left to right).
- The coordinates of the top left corner of the image are (0,0).
- The "&" character is not interpreted.
To modify these parameters, use dFont
The default font may differ according to the system on which the application is run.
By default, the background color of an Image control is transparent. To modify the background color of an Image control, use BackgroundColor
The coordinates are given in relation to the top left corner of the image or Image control ((0, 0) coordinates).
The coordinates correspond to the top left corner of the rectangle into which the text will be drawn. The precise location of the text in this rectangle depends on the size, shape and attributes of the font.
Management of '&'
The parameter <Management of & > makes it possible to manage the use of the '&' character.
- the "&" character must not be interpreted as an underline operator. For example:
dText(10, 10, "Tom&Jerry", LightRed, True)
will display "Tom&Jerry".
- the "&" character must be interpreted as an underline operator: the character following the "&" character will be underlined. For example:
dText(10, 10, "&Edit", LightRed, False)
will display "Edit".
In anti-aliasing mode (dChangeMode
function) or in opacity mode (dStartDrawing
function), the dText
function is only available for TrueType.
The anti-aliasing mode is not available.
Pattern and PHP
In PHP, the drawing functions are based on the graphic library GD. This library is commonly used by the PHP hosting companies and therefore it is always enabled. The version of the GD library must be version 2.0.28 (or later). This library can be downloaded from the PHP site.
To enable (if necessary) this library locally, the following elements are required:
- PHP installed.
- the PHP.INI file found in the Windows directory must contain the following line: "extension=php_gd2.dll" (instead of ";extension=php_gd2.dll").
- the php_gd2.dll file must exist in the directory of PHP extensions. This directory is defined in the PHP.INI file by the "extension_dir" variable.
Unit examples (WINDEV): The drawing functions
Business / UI classification: Neutral code
This page is also available for…