Help / WLanguage / WLanguage functions / Controls, pages and windows / Graphic string functions
  • Numbered drawings
  • Limits
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Loads an image in memory so that it can be used later by gImage.
WINDEVReports and QueriesUser code (UMC)
// The "C:\MyImages\Image.BMP" image includes
// 20 drawings organized in 10 rows and 2 columns.
// No border will be displayed around them.
LoadImage(ImageID, "C:\MyImages\Image.BMP", 10, 2, "C")
<Result> = LoadImage(<Image identifier> , <Image name> [, <Number of rows> [, <Number of columns> [, <Border>]]])
<Result>: Boolean
  • True if the image was loaded in memory,
  • False otherwise.
<Image identifier>: Integer
Identifier of image loaded in memory (included between 1 and 9). If this identifier is already used, the loaded image replaces the previous image. This identifier will be used by gImage.
<Image name>: Character string
Name and full (or relative) path of image to load. A UNC path can be used.
<Number of rows>: Optional integer
Number of drawings rows found in the image (up to 255 rows).
<Number of columns>: Optional integer
Number of drawings columns found in the image (up to 255 columns).
<Border>: Optional character
"C" if no border must be displayed around each drawing. By default, a 1-pixel border is displayed around each drawing.

Numbered drawings

An image can contain several drawings organized in rows and columns. All these drawings must have the same size and they can be enclosed in a 1-pixel border.
Drawings are numbered from 1 to <Number of rows> * <Number of columns> from left to right and from top to bottom.
When adding a drawing to the image, the call to LoadImage has to be modified to specify the new number of drawings horizontally and vertically.
  • LoadImageSheet simplifies the additions of drawings into the image. It is recommended to use this function.
  • WINDEV gImageExists is used to find out whether an image was loaded in memory by LoadImage or LoadImageSheet.


LoadImage must not be used in the project code. Indeed, this function must be used in the window where the image must be handled.
Component: wd300obj.dll
Minimum version required
  • Version 9
This page is also available for…
Click [Add] to post a comment

Last update: 10/02/2023

Send a report | Local help